Microsoft Azure AutoSuggest Client — AutoSuggest

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure AutoSuggest Client — AutoSuggest
  description: 'Microsoft Azure AutoSuggest Client — AutoSuggest. 1 operations. Lead operation: Microsoft Azure The Autosuggest
    Api Lets You Send A Search Query To Bing And Get Back A List Of Query Suggestions This Section Provides Technical Details
    About The Query Parameters And Headers That You Use To Request Suggestions And The Json Response Objects That Contain
    Them. Self-contained Naftiko capability covering'
  tags:
  - Microsoft Azure
  - AutoSuggest
  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: autosuggest-client-autosuggest
    baseUri: https://api.cognitive.microsoft.com/bing/v7.0
    description: Microsoft Azure AutoSuggest Client — AutoSuggest business capability. Self-contained, no shared references.
    resources:
    - name: Suggestions
      path: /Suggestions
      operations:
      - name: microsoftazureautosuggest
        method: GET
        description: Microsoft Azure The Autosuggest Api Lets You Send A Search Query To Bing And Get Back A List Of Query
          Suggestions This Section Provides Technical Details About The Query Parameters And Headers That You Use To Request
          Suggestions And The Jso
        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: Pragma
          in: header
          type: string
          description: 'By default, Bing returns cached content, if available. To prevent Bing from returning cached content,
            set the Pragma header to no-cache (for example, Pragma: no'
        - 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: mkt
          in: query
          type: string
          description: The market where the results come from. You are strongly encouraged to always specify the market, if
            known. Specifying the market helps Bing route the request a
        - name: q
          in: query
          type: string
          description: The user's search term.
          required: true
        - name: safeSearch
          in: query
          type: string
          description: 'Filter suggestions for adult content. The following are the possible filter values. Off: Return suggestions
            with adult text, images, or videos. Moderate: Return'
        - 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: ResponseFormat
          in: query
          type: array
          description: 'The media type to use for the response. The following are the possible case-insensitive values: JSON,
            JSONLD. The default is JSON. If you specify JSONLD, the re'
  exposes:
  - type: rest
    namespace: autosuggest-client-autosuggest-rest
    port: 8080
    description: REST adapter for Microsoft Azure AutoSuggest Client — AutoSuggest. One Spectral-compliant resource per consumed
      operation, prefixed with /v1.
    resources:
    - path: /v1/suggestions
      name: suggestions
      description: REST surface for Suggestions.
      operations:
      - method: GET
        name: microsoftazureautosuggest
        description: Microsoft Azure The Autosuggest Api Lets You Send A Search Query To Bing And Get Back A List Of Query
          Suggestions This Section Provides Technical Details About The Query Parameters And Headers That You Use To Request
          Suggestions And The Jso
        call: autosuggest-client-autosuggest.microsoftazureautosuggest
        with:
          Accept: rest.Accept
          Accept-Language: rest.Accept-Language
          Pragma: rest.Pragma
          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
          mkt: rest.mkt
          q: rest.q
          safeSearch: rest.safeSearch
          setLang: rest.setLang
          ResponseFormat: rest.ResponseFormat
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: autosuggest-client-autosuggest-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure AutoSuggest Client — AutoSuggest. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-autosuggest-api-lets
      description: Microsoft Azure The Autosuggest Api Lets You Send A Search Query To Bing And Get Back A List Of Query Suggestions
        This Section Provides Technical Details About The Query Parameters And Headers That You Use To Request Suggestions
        And The Jso
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: autosuggest-client-autosuggest.microsoftazureautosuggest
      with:
        Accept: tools.Accept
        Accept-Language: tools.Accept-Language
        Pragma: tools.Pragma
        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
        mkt: tools.mkt
        q: tools.q
        safeSearch: tools.safeSearch
        setLang: tools.setLang
        ResponseFormat: tools.ResponseFormat
      outputParameters:
      - type: object
        mapping: $.