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

{
  "message": "MCP server retrieved successfully",
  "status": "success",
  "error": null,
  "data": {
    "id": "mcp_abc123def456",
    "organization_id": "org_1234567890",
    "server_url": "https://example.com/mcp-server",
    "server_name": "My MCP Server",
    "approval_policy": "auto_approve_all",
    "transport": "SSE",
    "description": "MCP server for customer support tools",
    "request_headers": {
      "Authorization": "Bearer token123"
    },
    "secret_token_id": "secret_abc123",
    "created_at": 1705320000000,
    "updated_at": 1705320000000,
    "tool_approval_hashes": [],
    "dependent_agents": []
  }
Get detailed information about a specific MCP server by its ID. 
curl -X GET "https://api.zudu.ai/api/mcp-servers/mcp_abc123def456" \
  -H "X-API-KEY: sk_Abc123Def456..." \
  -H "X-API-SECRET: s3cr3t_Xyz789..." \

{
  "message": "MCP server retrieved successfully",
  "status": "success",
  "error": null,
  "data": {
    "id": "mcp_abc123def456",
    "organization_id": "org_1234567890",
    "server_url": "https://example.com/mcp-server",
    "server_name": "My MCP Server",
    "approval_policy": "auto_approve_all",
    "transport": "SSE",
    "description": "MCP server for customer support tools",
    "request_headers": {
      "Authorization": "Bearer token123"
    },
    "secret_token_id": "secret_abc123",
    "created_at": 1705320000000,
    "updated_at": 1705320000000,
    "tool_approval_hashes": [],
    "dependent_agents": []
  }

​
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

​
id
string
Unique identifier for the MCP server
​
organization_id
string
Organization ID the server belongs to
​
server_url
string
MCP server URL
​
server_name
string
Name of the MCP server
​
approval_policy
string
Current approval policy setting
​
transport
string
Transport type being used
​
description
string
Description of the MCP server
​
request_headers
object
Custom HTTP headers configured for requests
​
secret_token_id
string
Secret token ID if configured
​
created_at
number
Unix timestamp (milliseconds) when server was created
​
updated_at
number
Unix timestamp (milliseconds) of last update
​
tool_approval_hashes
array
Array of tool approval hashes configured for this server
​
dependent_agents
array
Array of agents that depend on this MCP server

​
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 retrieve server
{
  "message": "Failed to retrieve MCP server",
  "status": "error",
  "error": "Database connection failed"
}

​
Notes

  • The server must belong to your organization (automatically enforced)
  • Returns full server configuration including related entities
  • Tool approval hashes and dependent agents are included in the response