Skip to main content

Validate Mcp Connection

POST 
/v1/mcp/validate

Test connection to an MCP server WITHOUT requiring an agent.

Used during agent creation flow to validate MCP config before the agent exists in the database.

This endpoint:

  1. Validates the MCP server endpoint
  2. Establishes a test connection
  3. Fetches the list of available tools
  4. Returns connection status and tools (does NOT persist anything)

Example Request:

{
  "endpoint": "https://my-mcp-server.com/sse",
  "transport_type": "sse",
  "auth_header": "Bearer xxx"
}

Request​

Responses​

Successful Response