naftiko: 1.0.0-alpha2 info: label: Microsoft Azure News Search Client — NewsCategory description: 'Microsoft Azure News Search Client — NewsCategory. 1 operations. Lead operation: Microsoft Azure The News Category Api Lets You Search On Bing And Get Back A List Of Top News Articles By Category This Section Provides Technical Details About The Query Parameters And Headers That You Use To Request News And The Json Response Objects That Contain Them For Examples That Show How To Make Requests, Se' tags: - Microsoft Azure - NewsCategory created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY capability: consumes: - type: http namespace: news-search-client-newscategory baseUri: https://api.cognitive.microsoft.com/bing/v7.0 description: Microsoft Azure News Search Client — NewsCategory business capability. Self-contained, no shared references. resources: - name: news path: /news operations: - name: microsoftazurenewscategory method: GET description: Microsoft Azure The News Category Api Lets You Search On Bing And Get Back A List Of Top News Articles By Category This Section Provides Technical Details About The Query Parameters And Headers That You Use To Request News And The Json Resp outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: Accept in: header type: string description: The default media type is application/json. To specify that the response use [JSON-LD](http://json-ld.org/), set the Accept header to application/ld+json. - name: Accept-Language in: header type: string description: A comma-delimited list of one or more languages to use for user interface strings. The list is in decreasing order of preference. For additional information, in - name: User-Agent in: header type: string description: 'The user agent originating the request. Bing uses the user agent to provide mobile users with an optimized experience. Although optional, you are encouraged to ' - name: X-MSEdge-ClientID in: header type: string description: 'Bing uses this header to provide users with consistent behavior across Bing API calls. Bing often flights new features and improvements, and it uses the client ' - name: X-MSEdge-ClientIP in: header type: string description: The IPv4 or IPv6 address of the client device. The IP address is used to discover the user's location. Bing uses the location information to determine safe sear - name: X-Search-Location in: header type: string description: A semicolon-delimited list of key/value pairs that describe the client's geographical location. Bing uses the location information to determine safe search beha - name: cc in: query type: string description: 'A 2-character country code of the country where the results come from. This API supports only the United States market. If you specify this query parameter, it ' - name: category in: query type: string description: The category of articles to return. For example, Sports articles or Entertainment articles. For a list of possible categories, see [News Categories by Market](h - name: count in: query type: integer description: The number of news articles to return in the response. The actual number delivered may be less than requested. The default is 10 and the maximum value is 100. T - name: headlineCount in: query type: integer description: The number of headline articles to return in the response. The default is 12. Specify this parameter only if you do not specify the [category](https://docs.micr - name: mkt in: query type: string description: The market where the results come from. Typically, mkt is the country where the user is making the request from. However, it could be a different country if the - name: offset in: query type: integer description: The zero-based offset that indicates the number of news to skip before returning news. The default is 0. The offset should be less than ([totalEstimatedMatches] - name: originalImg in: query type: boolean description: A Boolean value that determines whether the image's contentUrl contains a URL that points to a thumbnail of the original article's image or the image itself. If - name: safeSearch in: query type: string description: 'Filter news for adult content. The following are the possible filter values. Off: Return news articles with adult text, images, or videos. Moderate: Return news' - name: setLang in: query type: string description: The language to use for user interface strings. Specify the language using the ISO 639-1 2-letter language code. For example, the language code for English is E - name: textDecorations in: query type: boolean description: A Boolean value that determines whether display strings contain decoration markers such as hit highlighting characters. If true, the strings may include markers - name: textFormat in: query type: string description: The type of markers to use for text decorations (see the textDecorations query parameter). Possible values are Raw—Use Unicode characters to mark content that n exposes: - type: rest namespace: news-search-client-newscategory-rest port: 8080 description: REST adapter for Microsoft Azure News Search Client — NewsCategory. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/news name: news description: REST surface for news. operations: - method: GET name: microsoftazurenewscategory description: Microsoft Azure The News Category Api Lets You Search On Bing And Get Back A List Of Top News Articles By Category This Section Provides Technical Details About The Query Parameters And Headers That You Use To Request News And The Json Resp call: news-search-client-newscategory.microsoftazurenewscategory with: Accept: rest.Accept Accept-Language: rest.Accept-Language User-Agent: rest.User-Agent X-MSEdge-ClientID: rest.X-MSEdge-ClientID X-MSEdge-ClientIP: rest.X-MSEdge-ClientIP X-Search-Location: rest.X-Search-Location cc: rest.cc category: rest.category count: rest.count headlineCount: rest.headlineCount mkt: rest.mkt offset: rest.offset originalImg: rest.originalImg safeSearch: rest.safeSearch setLang: rest.setLang textDecorations: rest.textDecorations textFormat: rest.textFormat outputParameters: - type: object mapping: $. - type: mcp namespace: news-search-client-newscategory-mcp port: 9090 transport: http description: MCP adapter for Microsoft Azure News Search Client — NewsCategory. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: microsoft-azure-news-category-api description: Microsoft Azure The News Category Api Lets You Search On Bing And Get Back A List Of Top News Articles By Category This Section Provides Technical Details About The Query Parameters And Headers That You Use To Request News And The Json Resp hints: readOnly: true destructive: false idempotent: true call: news-search-client-newscategory.microsoftazurenewscategory with: Accept: tools.Accept Accept-Language: tools.Accept-Language User-Agent: tools.User-Agent X-MSEdge-ClientID: tools.X-MSEdge-ClientID X-MSEdge-ClientIP: tools.X-MSEdge-ClientIP X-Search-Location: tools.X-Search-Location cc: tools.cc category: tools.category count: tools.count headlineCount: tools.headlineCount mkt: tools.mkt offset: tools.offset originalImg: tools.originalImg safeSearch: tools.safeSearch setLang: tools.setLang textDecorations: tools.textDecorations textFormat: tools.textFormat outputParameters: - type: object mapping: $.