Microsoft Azure Visual Search Client — ImageVisualSearch

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Visual Search Client — ImageVisualSearch
  description: 'Microsoft Azure Visual Search Client — ImageVisualSearch. 1 operations. Lead operation: Microsoft Azure Visual
    Search Api Lets You Discover Insights About An Image Such As Visually Similar Images, Shopping Sources, And Related Searches
    The Api Can Also Perform Text Recognition, Identify Entities People, Places, Things , Return Other Topical Content For
    The User To Explore, And More For More Inform'
  tags:
  - Microsoft Azure
  - ImageVisualSearch
  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: visual-search-client-imagevisualsearch
    baseUri: https://api.cognitive.microsoft.com/bing/v7.0
    description: Microsoft Azure Visual Search Client — ImageVisualSearch business capability. Self-contained, no shared references.
    resources:
    - name: images-visualsearch
      path: /images/visualsearch
      operations:
      - name: microsoftazureimagesvisualsearch
        method: POST
        description: Microsoft Azure Visual Search Api Lets You Discover Insights About An Image Such As Visually Similar
          Images, Shopping Sources, And Related Searches The Api Can Also Perform Text Recognition, Identify Entities People,
          Places, Things , Return
        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: Content-Type
          in: header
          type: string
          description: Must be set to multipart/form-data and include a boundary parameter (for example, multipart/form-data;
            boundary=<boundary string>). For more details, see [Conte
        - 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: 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: safeSearch
          in: query
          type: string
          description: 'Filter the image results in actions with type ''VisualSearch'' for adult content. The following are
            the possible filter values. Off: May return images with adult '
        - 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: knowledgeRequest
          in: formData
          type: string
          description: The form data is a JSON object that identifies the image using an insights token or URL to the image.
            The object may also include an optional crop area that ide
        - name: image
          in: formData
          type: file
          description: The form data is an image binary. The Content-Disposition header's name parameter must be set to "image".
            You must specify an image binary if you do not use kno
  exposes:
  - type: rest
    namespace: visual-search-client-imagevisualsearch-rest
    port: 8080
    description: REST adapter for Microsoft Azure Visual Search Client — ImageVisualSearch. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/images/visualsearch
      name: images-visualsearch
      description: REST surface for images-visualsearch.
      operations:
      - method: POST
        name: microsoftazureimagesvisualsearch
        description: Microsoft Azure Visual Search Api Lets You Discover Insights About An Image Such As Visually Similar
          Images, Shopping Sources, And Related Searches The Api Can Also Perform Text Recognition, Identify Entities People,
          Places, Things , Return
        call: visual-search-client-imagevisualsearch.microsoftazureimagesvisualsearch
        with:
          Accept: rest.Accept
          Accept-Language: rest.Accept-Language
          Content-Type: rest.Content-Type
          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
          mkt: rest.mkt
          safeSearch: rest.safeSearch
          setLang: rest.setLang
          knowledgeRequest: rest.knowledgeRequest
          image: rest.image
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: visual-search-client-imagevisualsearch-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Visual Search Client — ImageVisualSearch. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-visual-search-api
      description: Microsoft Azure Visual Search Api Lets You Discover Insights About An Image Such As Visually Similar Images,
        Shopping Sources, And Related Searches The Api Can Also Perform Text Recognition, Identify Entities People, Places,
        Things , Return
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: visual-search-client-imagevisualsearch.microsoftazureimagesvisualsearch
      with:
        Accept: tools.Accept
        Accept-Language: tools.Accept-Language
        Content-Type: tools.Content-Type
        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
        mkt: tools.mkt
        safeSearch: tools.safeSearch
        setLang: tools.setLang
        knowledgeRequest: tools.knowledgeRequest
        image: tools.image
      outputParameters:
      - type: object
        mapping: $.