Skip to main content
GET
/
api
/
mcp-servers
/
{mcpServerId}
/
tools
curl -X GET "https://api.zudu.ai/api/mcp-servers/mcp_abc123def456/tools" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "MCP server tools retrieved successfully",
  "status": "success",
  "error": null,
  "data": [
    {
      "name": "send_email",
      "description": "Send an email to a recipient",
      "inputSchema": {
        "type": "object",
        "properties": {
          "to": {
            "type": "string",
            "description": "Recipient email address"
          },
          "subject": {
            "type": "string",
            "description": "Email subject"
          },
          "body": {
            "type": "string",
            "description": "Email body content"
          },
        "required": ["to", "subject", "body"]
      },
    {
      "name": "get_weather",
      "description": "Get current weather information for a location",
      "inputSchema": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "City name or coordinates"
          },
        "required": ["location"]
      }
  ]
}
Get a list of all tools available from a specific MCP server. This endpoint connects to the actual MCP server to fetch real-time tool information. 
curl -X GET "https://api.zudu.ai/api/mcp-servers/mcp_abc123def456/tools" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "MCP server tools retrieved successfully",
  "status": "success",
  "error": null,
  "data": [
    {
      "name": "send_email",
      "description": "Send an email to a recipient",
      "inputSchema": {
        "type": "object",
        "properties": {
          "to": {
            "type": "string",
            "description": "Recipient email address"
          },
          "subject": {
            "type": "string",
            "description": "Email subject"
          },
          "body": {
            "type": "string",
            "description": "Email body content"
          },
        "required": ["to", "subject", "body"]
      },
    {
      "name": "get_weather",
      "description": "Get current weather information for a location",
      "inputSchema": {
        "type": "object",
        "properties": {
          "location": {
            "type": "string",
            "description": "City name or coordinates"
          },
        "required": ["location"]
      }
  ]
}

​
Headers

​
X-API-KEY
string
required
Your API key (format: sk_...)
​
X-API-SECRET
string
required
Your API secret (format: s3cr3t_...)

​
Path Parameters

​
mcpServerId
string
required
The MCP server ID (format: mcp_...)Example: mcp_abc123def456

​
Response Fields

​
data
array
Array of tool objects available from the MCP server
​
data[].name
string
Name of the toolExample: "send_email"
​
data[].description
string
Description of what the tool doesExample: "Send an email to a recipient"
​
data[].inputSchema
object
JSON schema defining the tool’s input parametersFollows JSON Schema specification. Includes:
  • type: Schema type (typically “object”)
  • properties: Object properties and their types
  • required: Array of required property names
Example:
{
  "type": "object",
  "properties": {
    "to": {"type": "string"},
    "subject": {"type": "string"},
  "required": ["to", "subject"]
}

​
Error Responses

​
error
string
Not Found - MCP server does not exist
{
  "message": "MCP server not found",
  "status": "error",
  "error": "MCP server with ID 'mcp_abc123' does not exist in organization"
}
​
error
string
Unauthorized - Missing or invalid API key/secret
​
error
string
Internal Server Error - Failed to connect to MCP server or fetch tools
{
  "message": "Failed to list MCP server tools",
  "status": "error",
  "error": "Could not connect to MCP server at https://example.com/mcp-server"
}

​
Notes

  • This endpoint connects to the actual MCP server to fetch real-time tool information
  • Tools are fetched directly from the MCP server, not from cached data
  • If the MCP server is unreachable, the request will fail
  • Tool schemas follow JSON Schema specification
  • The response format is compatible with ElevenLabs MCP API standard
  • Connection timeouts may occur if the MCP server is slow to respond