Validate MCP Server

curl --request POST \
  --url https://zeus-api.agentspro.cn/api/tools/mcp/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "tavily",
    "base_url": "https://mcp.tavily.com/mcp",
    "transport_type": "streamable_http",
    "api_key": "tvly-..."
  }'

{
  "success": true,
  "status": "connected",
  "tools": [
    { "name": "tavily_search", "description": "Search the web using Tavily" },
    { "name": "tavily_extract", "description": "Extract content from a URL" }
  ],
  "tool_count": 2,
  "prompts": [],
  "prompt_count": 0
}

{
  "detail": "Connection timeout: Unable to connect to https://mcp.example.com"
}

POST

api

tools

mcp

validate

curl --request POST \
  --url https://zeus-api.agentspro.cn/api/tools/mcp/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "tavily",
    "base_url": "https://mcp.tavily.com/mcp",
    "transport_type": "streamable_http",
    "api_key": "tvly-..."
  }'

{
  "success": true,
  "status": "connected",
  "tools": [
    { "name": "tavily_search", "description": "Search the web using Tavily" },
    { "name": "tavily_extract", "description": "Extract content from a URL" }
  ],
  "tool_count": 2,
  "prompts": [],
  "prompt_count": 0
}

{
  "detail": "Connection timeout: Unable to connect to https://mcp.example.com"
}

Tests whether an MCP server connection is available and returns the list of tools and prompts provided by the server. Used for connection validation before adding MCP tools on the frontend.

string

required

Bearer JWT Token

string

required

MCP server name (unique identifier)

string

required

MCP server URL

string

default:"streamable_http"

Transport type (streamable_http | sse | stdio)

string

API key (optional, automatically added as Authorization: Bearer header)

object

Custom HTTP headers (optional)

boolean

Whether the connection was successful

string

Connection status: connected

array

List of tools

Show tool

string

Tool name

string

Tool description

number

Number of tools

array

List of prompts

Show prompt

string

Prompt name

string

Prompt description

array

Prompt argument list

number

Number of prompts

curl --request POST \
  --url https://zeus-api.agentspro.cn/api/tools/mcp/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "tavily",
    "base_url": "https://mcp.tavily.com/mcp",
    "transport_type": "streamable_http",
    "api_key": "tvly-..."
  }'

{
  "success": true,
  "status": "connected",
  "tools": [
    { "name": "tavily_search", "description": "Search the web using Tavily" },
    { "name": "tavily_extract", "description": "Extract content from a URL" }
  ],
  "tool_count": 2,
  "prompts": [],
  "prompt_count": 0
}

{
  "detail": "Connection timeout: Unable to connect to https://mcp.example.com"
}

Auth

Agent API

Tools API

Knowledge Base API

Document API

Search API

Node API

Scheduled Tasks API

Channels API

WebSocket

Validate MCP Server