Skip to main content

MCP Management

List MCP Servers​

Gets a list of all connected and failed MCP servers.

GET/api/mcp/servers

Responses​

Success (200)

{
  "servers": [
    { "id": "filesystem", "name": "filesystem", "status": "connected" },
    { "id": "database", "name": "database", "status": "error" }
  ]
}

Add MCP Server​

Connects a new MCP server dynamically.

POST/api/mcp/servers

Request Body​

  • name (string, required): A unique name for the server.
  • config (object, required): The server's configuration object, including optional connectionMode.

Example Request Body:

{
  "name": "filesystem",
  "config": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-filesystem", "."],
    "timeout": 30000,
    "connectionMode": "strict"
  }
}

Responses​

Success (201)

{
  "status": "connected",
  "name": "new-server"
}

List Server Tools​

Retrieves the list of tools available on a specific MCP server.

GET/api/mcp/servers/:serverId/tools

Responses​

Success (200)

{
  "tools": [
    {
      "id": "readFile",
      "name": "readFile",
      "description": "Read the contents of a file",
      "inputSchema": {
          "type": "object",
          "properties": { "path": { "type": "string" } }
      }
    }
  ]
}

Execute MCP Tool​

Executes a tool on an MCP server directly.

POST/api/mcp/servers/:serverId/tools/:toolName/execute

Request Body​

  • An object containing the arguments required by the tool.

Responses​

Success (200)

{
  "success": true,
  "data": {
    "fileContent": "..."
  }
}

Error (500)

{
  "success": false,
  "error": "Tool execution failed: ..."
}

Remove MCP Server​

Disconnects and removes an MCP server.

DELETE/api/mcp/servers/:serverId

Responses​

Success (200)

{
  "status": "disconnected",
  "id": "server-to-remove"
}