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

# Get MCP Server Tools

> Discovers all tools exposed by an MCP server. Spawns the server inside a sandbox, initialises a session, calls `list_tools()`, and returns the server metadata together with every tool's name, description, and input schema.

The target server is identified by the `X-Enkrypt-MCP-Registry-Server` header — the gateway fetches its config from `GET /mcp-registry/get-server` using your `apikey` and uses the cloud's 200/401/403 response as the authentication gate. No request body is required.



## OpenAPI

````yaml GET /mcp-playground/get-tools
openapi: 3.0.0
info:
  title: Enkrypt AI APIs
  version: 2.0.0
servers:
  - url: https://api.enkryptai.com
security:
  - apiKeyAuth: []
tags:
  - name: Guardrails
  - name: Code of Conduct
  - name: Endpoints
  - name: Datasets
  - name: Redteam
  - name: Deployments
  - name: AI Proxy
  - name: Leaderboard
  - name: Archived
  - name: MCP Hub
    description: >-
      MCP Hub vulnerability scanning APIs. Submitting scans (the POST endpoints)
      is open to all authenticated callers. The scan **retrieval** APIs — Get
      Scan Job Status, Get Complete Scan Results, List Scans, and Get MCP Hub
      Scan Statistics (the GET endpoints) — are an **enterprise data-license
      feature**: they require your organization to have MCP Hub API access
      enabled by Enkrypt, otherwise they return `403`. Contact us at
      support@enkryptai.com to enable access.
  - name: MCP Registry Servers
  - name: MCP Gateways
  - name: MCP Playground
paths:
  /mcp-playground/get-tools:
    get:
      tags:
        - MCP Playground
      summary: Get MCP Server Tools
      description: >-
        Discovers all tools exposed by an MCP server. Spawns the server inside a
        sandbox, initialises a session, calls `list_tools()`, and returns the
        server metadata together with every tool's name, description, and input
        schema.


        The target server is identified by the `X-Enkrypt-MCP-Registry-Server`
        header — the gateway fetches its config from `GET
        /mcp-registry/get-server` using your `apikey` and uses the cloud's
        200/401/403 response as the authentication gate. No request body is
        required.
      operationId: getMCPTools
      parameters:
        - $ref: '#/components/parameters/MCPGatewayRegistryServerHeader'
        - $ref: '#/components/parameters/MCPGatewayRegistryServerVersionHeader'
      responses:
        '200':
          description: Tools retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MCPGatewayGetToolsResponse'
        '400':
          $ref: '#/components/responses/MCPGatewayBadRequest'
        '401':
          $ref: '#/components/responses/MCPGatewayUnauthorized'
        '403':
          $ref: '#/components/responses/MCPGatewayForbidden'
        '404':
          $ref: '#/components/responses/MCPGatewayNotFound'
        '500':
          $ref: '#/components/responses/MCPGatewayInternalError'
      servers:
        - url: https://mcp.enkryptai.com
components:
  parameters:
    MCPGatewayRegistryServerHeader:
      name: X-Enkrypt-MCP-Registry-Server
      in: header
      required: true
      description: Registry server saved_name
      schema:
        type: string
        maxLength: 32
        example: my-filesystem-server
    MCPGatewayRegistryServerVersionHeader:
      name: X-Enkrypt-MCP-Registry-Server-Version
      in: header
      required: false
      description: Registry server version (defaults to "v1")
      schema:
        type: string
        default: v1
        example: v1
  schemas:
    MCPGatewayGetToolsResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Whether the request was successful
        error:
          type: string
          nullable: true
          description: Error message if failed
        details:
          type: string
          nullable: true
          description: Additional error details
        data:
          type: object
          properties:
            saved_name:
              type: string
              description: Registry server name
            server_version:
              type: string
              description: Server version
            server_name:
              type: string
              nullable: true
              description: MCP server package name
            description:
              type: string
              nullable: true
              description: Server description
            tools:
              type: array
              items:
                $ref: '#/components/schemas/MCPGatewayMCPTool'
              description: List of available tools
            tool_count:
              type: integer
              description: Number of tools available
    MCPGatewayMCPTool:
      type: object
      properties:
        name:
          type: string
          description: Tool name
          example: read_file
        description:
          type: string
          description: Tool description
          example: Read a file from the filesystem
        inputSchema:
          type: object
          additionalProperties: true
          description: JSON Schema describing the tool's input parameters
    MCPGatewayErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: string
          description: Error message
  responses:
    MCPGatewayBadRequest:
      description: Bad request - invalid input
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/MCPGatewayErrorResponse'
    MCPGatewayUnauthorized:
      description: Unauthorized - invalid or missing API key
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/MCPGatewayErrorResponse'
    MCPGatewayForbidden:
      description: Forbidden - insufficient permissions
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/MCPGatewayErrorResponse'
    MCPGatewayNotFound:
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/MCPGatewayErrorResponse'
    MCPGatewayInternalError:
      description: Internal server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/MCPGatewayErrorResponse'
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: apikey

````