Conductor Graph Mcp

io.github.base76-research-labPublished by GitHub account base76-research-labv0.1.1Updated Oct 24, 2026

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

The publisher's own server: Conductor for QuickBooks Desktop

VerifiedSTDIODesktop onlySecurity & MonitoringAI & ML

Overview

AI-generated overview

Exposes a local CognOS agent system as a JSON graph, letting an assistant pull a full snapshot of nodes, edges and node status in one call.

What you can do
  • Retrieve the whole agent graph with nodes, edges and a summary
  • Check live status of a single named node
  • List only the edges that represent communication flow
  • Get a shortcut list of currently blocked or broken nodes
  • Status is assembled from gateway health endpoints, log files, a SQLite trace database and process checks
When to use it
Useful when you run a CognOS/TrustPlane agent stack locally and want an assistant to inspect its topology, trace communication flow, or quickly see which nodes are down or blocked.
Requirements
Runs locally as a Python package (pip install conductor-graph-mcp or uvx) with MCP SDK 1.0 or newer. Needs a reachable TrustPlane/CognOS gateway, set via COGNOS_BASE_URL (default and optionally COGNOS_API_KEY for gateway auth. Reads local log files and a SQLite database on the same machine.
Before you install
COGNOS_API_KEY is a secret passed in the environment; keep it out of shared config files. The server reads local log files under /tmp and a SQLite trace database, so it sees whatever those contain. It is read-only per the documented tools, but it contacts the configured gateway URL, so point it only at a trusted endpoint.

Installation

In SourceWeft

  1. Open Conductor Graph Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
# From PyPI (recommended)pip install conductor-graph-mcp
# Or from sourcegit clone https://github.com/base76-research-lab/conductor-graph-mcpcd conductor-graph-mcppip install -e .

Usage with Claude Code

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

json
{  "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:

json
{  "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

conductortrustplane-gatewaytoken-compressorsession-memoryarmada-busagent-criticagent-curatoragent-ethicsagent-synthagent-selfagent-srtagent-indexer

Examples

get_agent_graph()                        # Full system overviewget_node_status("trustplane-gateway")    # One specific nodeget_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

bash
# Test that the server startspython3 -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

Source: README.md at commit cb3b581

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.

Other Conductor integrations

Conductor for QuickBooks Desktop

is.conductorOfficial publisher

Hosted MCP server that lets an assistant read QuickBooks Desktop and Enterprise records and reports and create or update common transactions.

Streamable HTTPWeb executableAuth
FinanceCredential requiredNov 8, 2026

conductor

Published by GitHub account fainir

Conductor is a local MCP server of 23 text-processing tools whose outputs are checked by code before being returned, with retries and fallbacks.

STDIODesktop only
Developer Tools23 toolsNov 6, 2026

Conductor

Published by GitHub account jarmstrong158

Conductor lets an assistant create and manage scheduled local scripts, task chains, groups and email reports on a Windows machine through 21 MCP tools.

STDIODesktop only
Productivity & WorkflowNot validated yetOct 24, 2026

Agent Conductor

Published by GitHub account icohangar-ops

A local MCP server that compiles AGENTS.md files into structured contracts, discovers SKILL.md skills, and gates high-stakes agent decisions through a consensus

STDIODesktop only
Knowledge & MemoryNot validated yetOct 24, 2026

Conductor Relay MCP

Published by GitHub account Zman504

Hosted MCP for Conductor Relay, letting an assistant register as an agent, exchange A2A messages, claim jobs, and manage a managed-credit balance.

Streamable HTTPWeb executable
Communication & Collaboration40 toolsOct 28, 2026