naftiko: 1.0.0-alpha2 info: label: Microsoft Azure Custom Search Client — CustomSearch description: 'Microsoft Azure Custom Search Client — CustomSearch. 1 operations. Lead operation: Microsoft Azure The Custom Search Api Lets You Send A Search Query To Bing And Get Back Web Pages Found In Your Custom View Of The Web. Self-contained Naftiko capability covering one Microsoft Azure business surface.' tags: - Microsoft Azure - CustomSearch 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: custom-search-client-customsearch baseUri: https://api.cognitive.microsoft.com/bingcustomsearch/v7.0 description: Microsoft Azure Custom Search Client — CustomSearch business capability. Self-contained, no shared references. resources: - name: search path: /search operations: - name: microsoftazurecustominstancesearch method: GET description: Microsoft Azure The Custom Search Api Lets You Send A Search Query To Bing And Get Back Web Pages Found In Your Custom View Of The Web 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 strongly encou - 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: customConfig in: query type: string description: The identifier for the custom search configuration required: true - 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: count in: query type: integer description: The number of search results to return in the response. The default is 10 and the maximum value is 50. The actual number delivered may be less than requested.Us - 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 search results to skip before returning results. The default is 0. The offset should be less than (totalEstim - name: q in: query type: string description: The user's search query term. The term may not be empty. The term may contain Bing Advanced Operators. For example, to limit results to a specific domain, use t required: true - name: safeSearch in: query type: string description: 'A filter used to filter adult content. Off: Return webpages with adult text, images, or videos. Moderate: Return webpages with adult text, but not adult images ' - 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 should contain decoration markers such as hit highlighting characters. If true, the strings may include ' - 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: custom-search-client-customsearch-rest port: 8080 description: REST adapter for Microsoft Azure Custom Search Client — CustomSearch. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/search name: search description: REST surface for search. operations: - method: GET name: microsoftazurecustominstancesearch description: Microsoft Azure The Custom Search Api Lets You Send A Search Query To Bing And Get Back Web Pages Found In Your Custom View Of The Web call: custom-search-client-customsearch.microsoftazurecustominstancesearch 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 customConfig: rest.customConfig cc: rest.cc count: rest.count mkt: rest.mkt offset: rest.offset q: rest.q safeSearch: rest.safeSearch setLang: rest.setLang textDecorations: rest.textDecorations textFormat: rest.textFormat outputParameters: - type: object mapping: $. - type: mcp namespace: custom-search-client-customsearch-mcp port: 9090 transport: http description: MCP adapter for Microsoft Azure Custom Search Client — CustomSearch. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: microsoft-azure-custom-search-api description: Microsoft Azure The Custom Search Api Lets You Send A Search Query To Bing And Get Back Web Pages Found In Your Custom View Of The Web hints: readOnly: true destructive: false idempotent: true call: custom-search-client-customsearch.microsoftazurecustominstancesearch 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 customConfig: tools.customConfig cc: tools.cc count: tools.count mkt: tools.mkt offset: tools.offset q: tools.q safeSearch: tools.safeSearch setLang: tools.setLang textDecorations: tools.textDecorations textFormat: tools.textFormat outputParameters: - type: object mapping: $.