Skip to main content
Glama
Conductor Graph MCP Server

Conductor Graph MCP Server

Conductor Graph MCP Server

mcp-name: io.github.base76-research-lab/conductor-graph-mcp

Conductor-Graph-MCP

An 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.

Built on the FNC architecture: Field (agents) → Node (processing) → Cockpit (oversight)


Installation

# From PyPI (recommended)
pip install conductor-graph-mcp

# Or from source
git clone https://github.com/base76-research-lab/conductor-graph-mcp
cd conductor-graph-mcp
pip install -e .

Related MCP server: omni-flow

Usage with Claude Code

Add to ~/.claude/settings.json under mcpServers:

{
  "mcpServers": {
    "cognos-graph": {
      "command": "python3",
      "args": ["-m", "conductor_graph_mcp"],
      "env": {
        "COGNOS_BASE_URL": "http://127.0.0.1:8788",
        "COGNOS_API_KEY": "your-key"
      }
    }
  }
}

Or with uvx:

{
  "mcpServers": {
    "cognos-graph": {
      "command": "uvx",
      "args": ["conductor-graph-mcp"],
      "env": {
        "COGNOS_BASE_URL": "http://127.0.0.1:8788",
        "COGNOS_API_KEY": "your-key"
      }
    }
  }
}

Restart Claude Code — the server activates automatically.

Note: Requires MCP SDK ≥ 1.0 (mcp on PyPI).


Tools

Tool

Description

get_agent_graph

Full graph — nodes + edges + summary

get_node_status(node_id)

Live status for a specific node

get_edges

Only edges (communication flow)

get_blocked_nodes

Shortcut: what is broken right now?


Known Node IDs

conductor
trustplane-gateway
token-compressor
session-memory
armada-bus
agent-critic
agent-curator
agent-ethics
agent-synth
agent-self
agent-srt
agent-indexer

Examples

get_agent_graph()                        # Full system overview
get_node_status("trustplane-gateway")    # One specific node
get_blocked_nodes()                      # What is broken?
get_edges()                              # Communication flow

Node Status — Data Sources

Node

Source

trustplane-gateway

HTTP GET /healthz + /v1/providers/health

token-compressor

/tmp/b76_compress.log

session-memory

/tmp/b76_save.log + SQLite traces.sqlite3

armada-bus

/tmp/b76_armada_bus.json + /tmp/b76_armada_bus.log

agent-*

psutil — is the process running?

conductor

Always active (the conductor itself)


Environment Variables

Variable

Default

Description

COGNOS_BASE_URL

http://127.0.0.1:8788

TrustPlane gateway URL

COGNOS_API_KEY

(empty)

API key for gateway auth


Verification

# Test that the server starts
python3 -m conductor_graph_mcp

# Stop the gateway → trustplane-gateway.status = "error"
# get_blocked_nodes() should return trustplane-gateway

# Run a /save → session-memory.metrics.entries increases
# get_node_status("session-memory") shows new count

License

MIT — Base76 Research Lab

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides agents with read-only access to local code architecture graphs (structure from tree-sitter, semantic summaries from LLMs), including per-workspace graph/config/status/rebuild tools, while enforcing that topology comes only from static analysis.
      10 npm
      MIT
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables agents to create, customize, analyze and export relationship diagrams — theorem dependencies, paper maps, task RACI, org charts, conversation graphs — through 25 MCP tools, with cycle detection, centrality bottleneck reports, dependency closure and Mermaid/DOT/Markdown/JSON interop. Graphs stay local-first in a diff-friendly JSON source of truth and can be refined on a visual canvas.
      1
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Maps Claude Code, Cursor, OpenCode and other agent runtime configs into one local capability graph so you can query what is reachable, what sits one step away, and what is configured but failing its checks. Agents can ask over MCP what they can do before trying, and when blocked, receive a drafted config change to approve.
      236 npm
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to build and manage local-first graph maps of .onion links and Markdown posts, including nodes, documents with images, connections, search, autolayout, and import/export through 32 tools.
      GPL 3.0