Capabilities API

List bindings

Returns all classified MCP tools (CapabilityBindings).

GET /api/capabilities/bindings

curl http://localhost:8000/api/capabilities/bindings

Response

[
  {
    "app": "notion",
    "mcp_tool_name": "query_database",
    "capability_id": "read_database",
    "direction": "read",
    "param_mappings": {"database_id": "string"}
  }
]

---

List syncable pairs

Returns valid source→target capability pairs.

GET /api/capabilities/syncable-pairs

curl http://localhost:8000/api/capabilities/syncable-pairs

Response

[
  {
    "source": {"app": "notion", "capability_id": "read_page", "direction": "read"},
    "target": {"app": "sheets", "capability_id": "write_row", "direction": "write"}
  }
]

---

Scan capabilities

Connects to all registered MCP servers, discovers tools, and stores CapabilityBindings. Idempotent — safe to call multiple times.

POST /api/capabilities/scan

curl -X POST http://localhost:8000/api/capabilities/scan

Response 200 OK

{
  "scanned": 2,
  "bindings_created": 14
}

Emits a scan_complete WebSocket event when done.