Skip to main content
Planned Feature — Coming Soon

🚧 This feature is not yet released. The documentation below describes planned behavior and may change before launch.

MCP Servers API

Register, manage, and discover tools from external MCP servers.

Base URL: https://backend.flymy.ai/v1

Create MCP Server​

POST /mcp-servers
FieldTypeRequiredDescription
namestringYesServer name
urlstringYesMCP server endpoint URL
connection_typestringYesstreamable_http or sse
authobjectNoAuthentication config

Auth Types​

// Bearer token
{"type": "bearer", "token": "your-token"}

// API key header
{"type": "api_key", "header": "X-API-Key", "value": "your-key"}

Example​

curl -X POST https://backend.flymy.ai/v1/mcp-servers \
  -H "x-api-key: fly-***" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My CRM",
    "url": "https://mcp.example.com/crm",
    "connection_type": "streamable_http",
    "auth": {"type": "bearer", "token": "crm-token"}
  }'

Response​

{
  "id": "mcp_abc123",
  "name": "My CRM",
  "url": "https://mcp.example.com/crm",
  "connection_type": "streamable_http",
  "status": "connected",
  "created_at": "2025-01-15T10:00:00Z"
}

Get MCP Server​

GET /mcp-servers/{mcp_server_id}

List MCP Servers​

GET /mcp-servers

Update MCP Server​

PATCH /mcp-servers/{mcp_server_id}
curl -X PATCH https://backend.flymy.ai/v1/mcp-servers/mcp_abc123 \
  -H "x-api-key: fly-***" \
  -H "Content-Type: application/json" \
  -d '{"auth": {"type": "bearer", "token": "new-rotated-token"}}'

Delete MCP Server​

DELETE /mcp-servers/{mcp_server_id}

List MCP Server Tools​

Discover all tools exposed by a registered MCP server:

GET /mcp-servers/{mcp_server_id}/tools

Response​

{
  "tools": [
    {
      "name": "search_contacts",
      "description": "Search CRM contacts by name or email",
      "parameters": {
        "type": "object",
        "properties": {
          "query": {"type": "string", "description": "Search term"},
          "limit": {"type": "number", "description": "Max results", "default": 10}
        },
        "required": ["query"]
      }
    },
    {
      "name": "create_deal",
      "description": "Create a new sales deal",
      "parameters": {
        "type": "object",
        "properties": {
          "contact_id": {"type": "string"},
          "value": {"type": "number"},
          "stage": {"type": "string", "enum": ["lead", "qualified", "proposal", "closed"]}
        },
        "required": ["contact_id", "value"]
      }
    }
  ]
}