> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sidenet.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get tool provider

> Full provider info plus every tool (same per-tool shape as GET /v1/tools). `:id` is the provider's UUID, or the key/name for static and global MCP providers.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/tool-providers/{id}
openapi: 3.1.0
info:
  title: Sidenet API
  version: 1.0.0
  description: >-
    Sidenet HTTP endpoints exposed by the Sidenet Studio. All routes require an
    api key that can be generated through the studio in studio.sidenet.ai.
servers:
  - url: https://api.sidenet.ai
security:
  - bearerAuth: []
paths:
  /v1/tool-providers/{id}:
    get:
      tags:
        - Tool providers
      summary: Get tool provider
      description: >-
        Full provider info plus every tool (same per-tool shape as GET
        /v1/tools). `:id` is the provider's UUID, or the key/name for static and
        global MCP providers.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            example: 8d3b1a75-6c02-4e59-b84f-27a9d5e10c63
      responses:
        '200':
          description: >-
            The provider, with every one of its tools. The provider fields are
            at the top level — there is no `provider` wrapper.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: >-
                      The `tool_providers.id` UUID for api/mcp/sidenet
                      providers; the static key (e.g. `rich-ui-components`) or
                      MCP server id for the built-in kinds.
                  name:
                    type: string
                  type:
                    type: string
                    enum:
                      - api
                      - mcp
                      - sidenet
                      - static
                      - global_mcp
                  description:
                    type: string
                    nullable: true
                  auth_type:
                    type: string
                    nullable: true
                  base_url:
                    type: string
                    nullable: true
                    description: API providers only.
                  runtime_auth:
                    type: boolean
                    description: >-
                      The caller supplies credentials per request rather than
                      storing them.
                  mcp_transport:
                    type: string
                    nullable: true
                  has_vault_secret:
                    type: boolean
                    description: >-
                      A credential is stored for this provider. The secret
                      itself is never returned.
                  tool_count:
                    type: integer
                  agent_ids:
                    type: array
                    description: >-
                      Agents whose ACTIVE version uses this provider — i.e. who
                      breaks if you change it.
                    items:
                      type: string
                      format: uuid
                  tools:
                    type: object
                    description: >-
                      Tools keyed by runtime key, NOT an array. Empty for an MCP
                      provider that could not be reached — see `mcp_load_error`.
                    additionalProperties:
                      type: object
                      properties:
                        id:
                          type: string
                          description: The runtime key agents call this tool by.
                        uuid:
                          type: string
                          format: uuid
                          description: The `tools.id` row id. API tools only.
                        name:
                          type: string
                        description:
                          type: string
                        inputSchema:
                          type: object
                          description: JSON Schema of the arguments.
                        outputSchema:
                          type: object
                          description: >-
                            JSON Schema of the result, when the tool declares
                            one.
                  mcp_load_error:
                    type: string
                    nullable: true
                    description: >-
                      Why the last MCP load failed, when it did. MCP providers
                      only; null when the provider loaded.
                description: >-
                  Stored credentials are redacted before this is returned —
                  `has_vault_secret` says whether one exists, never what it is.
        '404':
          description: Not found
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Organization API key, generated in studio.sidenet.ai. Backend only —
        never in a browser.

````