Skip to main content

Test MCP connection

POST /api/connectors/mcp/test
FieldTypeRequiredDescription
transportstringNohttp or stdio (default: http)
urlstringIf HTTPMCP server URL
commandstringIf STDIOExecutable command
argsstring[]NoCommand arguments
Response:
{
  "ok": true,
  "tools": 4,
  "server": "order-service",
  "toolNames": ["get_order", "list_orders", "create_order", "update_order"]
}

Save MCP connection

POST /api/connectors/mcp
FieldTypeRequiredDescription
workspace_idstringYesTarget workspace
namestringYesDisplay name
transportstringNohttp or stdio
urlstringIf HTTPMCP server URL
commandstringIf STDIOExecutable command
argsstring[]NoCommand arguments
Response:
{
  "status": "saved",
  "message": "MCP connection saved. Tools will be discovered on the next query.",
  "tools": 4
}
For HTTP connections, tools are discovered immediately. For STDIO, tools are discovered on first query.

Delete connection

DELETE /api/connections/:id
Deletes the connection and all its discovered tools.
{"status": "ok"}