English Français العربية

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

Official registry Archived AI and agents

Exposes a CognOS agent system as a machine-readable graph. Full system snapshot with one tool call.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package conductor-graph-mcp
Claude Code 
claude mcp add conductor-graph-mcp -e 'COGNOS_BASE_URL=<COGNOS_BASE_URL>' -e 'COGNOS_API_KEY=<your cognos_api_key>' -- uvx conductor-graph-mcp==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "conductor-graph-mcp": {
            "command": "uvx",
            "args": [
                "conductor-graph-mcp==0.1.1"
            ],
            "env": {
                "COGNOS_BASE_URL": "<COGNOS_BASE_URL>",
                "COGNOS_API_KEY": "<your cognos_api_key>"
            }
        }
    }
}

Environment variables

  • COGNOS_BASE_URL URL of the TrustPlane/CognOS gateway (default: http://127.0.0.1:8788)
  • COGNOS_API_KEY secret API key for the CognOS gateway (optional, leave empty if not required)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Conductor Graph MCP Server
  2. Installation
  3. Usage with Claude Code
  4. Tools
  5. Known Node IDs
  6. Examples
  7. Node Status — Data Sources
  8. Environment Variables
  9. Verification
  10. License

Conductor Graph MCP Server

mcp-name: io.github.base76-research-lab/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 .

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

ToolDescription
get_agent_graphFull graph — nodes + edges + summary
get_node_status(node_id)Live status for a specific node
get_edgesOnly edges (communication flow)
get_blocked_nodesShortcut: 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

NodeSource
trustplane-gatewayHTTP 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?
conductorAlways active (the conductor itself)

Environment Variables

VariableDefaultDescription
COGNOS_BASE_URLhttp://127.0.0.1:8788TrustPlane 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

Frequently asked questions

What is io.github.base76-research-lab/conductor-graph-mcp?

Exposes a CognOS agent system as a machine-readable graph. Full system snapshot with one tool call.

How do I install io.github.base76-research-lab/conductor-graph-mcp?

It runs on your machine. In Claude Code: claude mcp add conductor-graph-mcp -e 'COGNOS_BASE_URL=<COGNOS_BASE_URL>' -e 'COGNOS_API_KEY=<your cognos_api_key>' -- uvx conductor-graph-mcp==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.base76-research-lab/conductor-graph-mcp need an API key?

Yes. It expects COGNOS_API_KEY, which you set in its configuration.

Is io.github.base76-research-lab/conductor-graph-mcp open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.base76-research-lab/conductor-graph-mcp?

It is published by base76-research-lab. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.