{
  "markdown": "# Conductor Graph MCP Server\n\nmcp-name: io.github.base76-research-lab/conductor-graph-mcp\n\n![Conductor-Graph-MCP](logo.png)\n\nAn MCP server that exposes a CognOS agent system as a machine-readable JSON graph. The conductor (Claude) calls a single tool and gets an immediate full system snapshot.\n\nBuilt on the **FNC architecture**: **Field** (agents) → **Node** (processing) → **Cockpit** (oversight)\n\n---\n\n## Installation\n\n```bash\n# From PyPI (recommended)\npip install conductor-graph-mcp\n\n# Or from source\ngit clone https://github.com/base76-research-lab/conductor-graph-mcp\ncd conductor-graph-mcp\npip install -e .\n```\n\n## Usage with Claude Code\n\nAdd to `~/.claude/settings.json` under `mcpServers`:\n\n```json\n{\n  \"mcpServers\": {\n    \"cognos-graph\": {\n      \"command\": \"python3\",\n      \"args\": [\"-m\", \"conductor_graph_mcp\"],\n      \"env\": {\n        \"COGNOS_BASE_URL\": \"http://127.0.0.1:8788\",\n        \"COGNOS_API_KEY\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\nOr with `uvx`:\n\n```json\n{\n  \"mcpServers\": {\n    \"cognos-graph\": {\n      \"command\": \"uvx\",\n      \"args\": [\"conductor-graph-mcp\"],\n      \"env\": {\n        \"COGNOS_BASE_URL\": \"http://127.0.0.1:8788\",\n        \"COGNOS_API_KEY\": \"your-key\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Code — the server activates automatically.\n\n> **Note:** Requires MCP SDK ≥ 1.0 (`mcp` on PyPI).\n\n---\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_agent_graph` | Full graph — nodes + edges + summary |\n| `get_node_status(node_id)` | Live status for a specific node |\n| `get_edges` | Only edges (communication flow) |\n| `get_blocked_nodes` | Shortcut: what is broken right now? |\n\n---\n\n## Known Node IDs\n\n```\nconductor\ntrustplane-gateway\ntoken-compressor\nsession-memory\narmada-bus\nagent-critic\nagent-curator\nagent-ethics\nagent-synth\nagent-self\nagent-srt\nagent-indexer\n```\n\n---\n\n## Examples\n\n```\nget_agent_graph()                        # Full system overview\nget_node_status(\"trustplane-gateway\")    # One specific node\nget_blocked_nodes()                      # What is broken?\nget_edges()                              # Communication flow\n```\n\n---\n\n## Node Status — Data Sources\n\n| Node | Source |\n|------|--------|\n| `trustplane-gateway` | HTTP GET `/healthz` + `/v1/providers/health` |\n| `token-compressor` | `/tmp/b76_compress.log` |\n| `session-memory` | `/tmp/b76_save.log` + SQLite `traces.sqlite3` |\n| `armada-bus` | `/tmp/b76_armada_bus.json` + `/tmp/b76_armada_bus.log` |\n| `agent-*` | `psutil` — is the process running? |\n| `conductor` | Always `active` (the conductor itself) |\n\n---\n\n## Environment Variables\n\n| Variable | Default | Description |\n|----------|---------|-------------|\n| `COGNOS_BASE_URL` | `http://127.0.0.1:8788` | TrustPlane gateway URL |\n| `COGNOS_API_KEY` | _(empty)_ | API key for gateway auth |\n\n---\n\n## Verification\n\n```bash\n# Test that the server starts\npython3 -m conductor_graph_mcp\n\n# Stop the gateway → trustplane-gateway.status = \"error\"\n# get_blocked_nodes() should return trustplane-gateway\n\n# Run a /save → session-memory.metrics.entries increases\n# get_node_status(\"session-memory\") shows new count\n```\n\n---\n\n## License\n\nMIT — Base76 Research Lab\n",
  "bytes": 3135,
  "sha": "65d759acb28394b76e53684a102726666f1fffff77e2ed3a9bc7e901b0d6da47",
  "repo_slug": "base76-research-lab/conductor-graph-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_base76_research_lab_conductor__926e0554/readme"
}