Skip to content

MCP API

Manage Model Context Protocol servers.

Endpoints

MethodEndpointDescription
GET/api/agents/{id}/mcpList MCP servers
POST/api/agents/{id}/mcpRegister server
DELETE/api/agents/{id}/mcpDelete server

List Servers

bash
GET /api/agents/{id}/mcp

Response

json
{
  "servers": [
    {
      "id": "mcp-123",
      "name": "GitHub Tools",
      "url": "https://mcp.github.com/v1",
      "status": "connected",
      "created_at": "2024-12-01T00:00:00Z"
    }
  ]
}

Register Server

bash
POST /api/agents/{id}/mcp
Content-Type: application/json

Request Body

json
{
  "name": "GitHub Tools",
  "url": "https://mcp.github.com/v1",
  "auth": {
    "type": "bearer",
    "token": "ghp_xxxxx"
  }
}

Delete Server

bash
DELETE /api/agents/{id}/mcp?id={serverId}

Get Tools

bash
GET /api/agents/{id}/mcp/{serverId}/tools

Response

json
{
  "tools": [
    {
      "name": "search_repos",
      "description": "Search GitHub repositories",
      "parameters": {
        "type": "object",
        "properties": {
          "query": { "type": "string" }
        }
      }
    }
  ]
}

Status

StatusDescription
connectedServer accessible
disconnectedConnection failed
errorServer error

Released under the MIT License.