Skip to main content
Glama
base76-research-lab

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: Advanced Obsidian MCP Server

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

A
license - permissive license
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/base76-research-lab/conductor-graph-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server