Integrations API

Manage MCP-compatible integration servers.

Endpoints

GET /integrations

curl http://localhost:4200/integrations

Response (200)

{
  "integrations": [
    {"id": "postgresql-connector", "status": "running", "tools_count": 4},
    {"id": "github-connector", "status": "stopped", "tools_count": 5},
    {"id": "salesforce-connector", "status": "running", "tools_count": 8}
  ]
}

POST /integrations/install

curl -X POST http://localhost:4200/integrations/install \
  -H "Content-Type: application/json" \
  -d '{"source": "github-connector"}'

Response (201)

{"id": "github-connector", "installed": true}

POST /integrations/{id}/start

curl -X POST http://localhost:4200/integrations/postgresql-connector/start

Response (200)

{"id": "postgresql-connector", "status": "running", "pid": 12345}

POST /integrations/{id}/stop

curl -X POST http://localhost:4200/integrations/postgresql-connector/stop

Response (200)

{"id": "postgresql-connector", "status": "stopped"}

GET /integrations/{id}/status

curl http://localhost:4200/integrations/postgresql-connector/status

Response (200)

{
  "id": "postgresql-connector",
  "status": "running",
  "pid": 12345,
  "uptime_secs": 8100,
  "tools_count": 4
}

GET /integrations/{id}/tools

curl http://localhost:4200/integrations/postgresql-connector/tools

Response (200)

{
  "tools": [
    {"name": "query", "description": "Execute a read-only SQL query"},
    {"name": "list_tables", "description": "List all tables"},
    {"name": "describe_table", "description": "Show columns and types"},
    {"name": "execute", "description": "Execute a write SQL statement"}
  ]
}

DELETE /integrations/{id}

curl -X DELETE http://localhost:4200/integrations/github-connector

Response (204 No Content)