Is Conductor Graph free?

Yes, Conductor Graph is free to use.

How do I install Conductor Graph?

Conductor Graph is a local plugin. Install it using PyPI package: conductor-graph-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does Conductor Graph need?

Conductor Graph requires the following credentials or environment variables: COGNOS_BASE_URL, COGNOS_API_KEY. You can find setup instructions on the server detail page.

What AI apps work with Conductor Graph?

Conductor Graph uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Conductor Graph MCP Server

by base76-research-lab

Developer ToolsModerate7.0Local

Free

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

About

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

Security Report

7.0

Moderate7.0Low Risk

Valid MCP server (4 strong, 1 medium validity signals). 3 known CVEs in dependencies (0 critical, 3 high severity) Package registry verified. Imported from the Official MCP Registry.

7 files analyzed · 4 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

database

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

URL of the TrustPlane/CognOS gateway (default: http://127.0.0.1:8788)Optional

Environment variable: COGNOS_BASE_URL

API key for the CognOS gateway (optional, leave empty if not required)Required

Environment variable: COGNOS_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-base76-research-lab-conductor-graph-mcp": {
      "env": {
        "COGNOS_API_KEY": "your-cognos-api-key-here",
        "COGNOS_BASE_URL": "your-cognos-base-url-here"
      },
      "args": [
        "conductor-graph-mcp"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

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