> ## Documentation Index > Fetch the complete documentation index at: https://docs.roark.ai/llms.txt > Use this file to discover all available pages before exploring further. # Discover an MCP server > Connects to a server and returns the tools it offers, without storing anything. Use it to check a url and credential before connecting. ## OpenAPI ````yaml /api-reference/openapi.documented.json post /v1/integrations/mcp-server/discover openapi: 3.1.0 info: title: Roark Analytics API description: >- The Roark Analytics API gives you access to the same API that powers the award winning Roark Analytics platform. version: 1.0.0 servers: - description: Production url: https://api.roark.ai security: - Bearer: [] tags: - name: Agent - name: Customer - name: Agent Endpoint - name: Tool - name: Phone Number - name: Call - name: Chat - name: Metric - name: Metric Policy - name: Metric Collection Job - name: Customer Flow - name: Customer Flow Edge Case - name: Simulation - name: Simulation Persona - name: Simulation Environment - name: Simulation Scenario - name: Simulation Run Plan - name: Simulation Template - name: Simulation Audio Clip - name: Simulation Run Plan Job - name: Simulation Job - name: HTTP Request Definition - name: Webhook - name: Issue - name: Autoimprove - name: Agent Config - name: Knowledge Base - name: Calendar Integration - name: MCP Server Integration - name: Config - name: Organization Project - name: Organization Project Member - name: Organization Project API Key - name: Organization Config - name: CLI Auth - name: Me - name: Project - name: Usage - name: Analytics - name: Dashboard - name: Live Report - name: Benchmark - name: Health - name: Campaign Credit paths: /v1/integrations/mcp-server/discover: post: tags: - MCP Server Integration summary: Discover an MCP server description: >- Connects to a server and returns the tools it offers, without storing anything. Use it to check a url and credential before connecting. operationId: postV1IntegrationsMcp-serverDiscover requestBody: content: application/json: schema: $ref: '#/components/schemas/McpServerDiscoverBody' responses: '200': description: What the server offers content: application/json: schema: $ref: '#/components/schemas/McpServerCatalogResponse' '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Validation error example: type: validation code: invalid_parameter message: The request was invalid param: email description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Authentication error example: type: authentication code: unauthorized message: Authentication required description: Unauthorized '500': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Server error example: type: internal code: internal_error message: Internal server error description: Internal Server Error components: schemas: McpServerDiscoverBody: type: object properties: url: type: string format: uri maxLength: 2048 example: https://mcp.example.com/mcp transport: type: string enum: - STREAMABLE_HTTP - SSE default: STREAMABLE_HTTP auth: allOf: - $ref: '#/components/schemas/McpServerAuth' default: type: NONE required: - url McpServerCatalogResponse: type: object properties: data: type: object properties: serverName: type: - string - 'null' description: The name the server gives itself serverVersion: type: - string - 'null' instructions: type: - string - 'null' description: >- The server's own advice on using it, for you to read. Never shown to the agent. tools: type: array items: $ref: '#/components/schemas/McpServerTool' catalogHash: type: string description: Changes when the server changes the tools it offers required: - serverName - serverVersion - instructions - tools - catalogHash required: - data ErrorResponse: type: object properties: type: type: string enum: - validation - authentication - forbidden - not_found - conflict - payment_required - rate_limit - internal description: The error type category examples: - validation - authentication code: type: string description: Machine-readable error code identifier examples: - invalid_parameter - missing_required_field - unauthorized message: type: string description: Human-readable error message examples: - The request was invalid - Authentication required param: type: string description: The parameter that caused the error (if applicable) examples: - email - user_id details: description: Additional error context information required: - type - code - message McpServerAuth: oneOf: - type: object properties: type: type: string const: NONE required: - type - type: object properties: type: type: string const: BEARER token: type: string minLength: 1 maxLength: 4096 required: - type - token - type: object properties: type: type: string const: HEADER name: type: string minLength: 1 maxLength: 128 example: X-Api-Key value: type: string minLength: 1 maxLength: 4096 required: - type - name - value description: How the server authenticates. Stored encrypted; never returned. McpServerTool: type: object properties: name: type: string description: The tool as the server names it example: search_customers description: type: - string - 'null' suggestedName: type: - string - 'null' description: >- What a tool for it is called by default: the name with unusable characters replaced readOnly: type: - boolean - 'null' description: The server's hint that the tool only reads unavailableReason: type: - string - 'null' description: >- Why an agent could not use this tool, such as a name a built-in tool already has required: - name - description - suggestedName - readOnly - unavailableReason securitySchemes: Bearer: type: http scheme: bearer bearerFormat: JWT ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.