Protocol Standards

Get
Started

Install, configure, and run your first structural pulse in under five minutes.

Step 01

Clone and Build

Clone the repository and build the MCP server locally. Conducks runs as a local process — no cloud, no account.

$ git clone https://github.com/Conducks/conducks
$ cd conducks/conducks
$ npm install && npm run build

Step 02

Configure MCP Client

Add the following to your MCP host config (Claude Desktop, Cursor, or any MCP-compatible client):

{
  "mcpServers": {
    "conducks": {
      "command": "node",
      "args": ["/absolute/path/to/conducks/conducks/build/index.js"]
    }
  }
}

Use the absolute path. The MCP protocol requires it to anchor the server correctly to your filesystem.

Step 03

Run Your First Pulse

Navigate to any project and run the structural analysis. Conducks builds the Synapse graph, runs PageRank, and persists everything to a local DuckDB vault.

$ cd your-project
$ conducks analyze
# 9,230 nodes · 61,352 edges · ~9s

$ conducks status
# hotspots, entry points, god objects, staleness

$ conducks mirror
# real-time force-directed graph at localhost:3333

9 Unified MCP Tools

All agent interactions go through these tools. HyperToon registry loads tool descriptions live — updating your docs auto-updates agent understanding without a server restart.

conducks_statusHotspots, structural pillars, entry points, layer distribution, anomaly summary

conducks_querySymbol lookup, namespace scoping, 19 named templates, typed filter mode

conducks_explain6-signal risk decomposition: Gravity, Complexity, Entropy, Churn, FanOut, Debt

conducks_impactBlast radius upstream/downstream with hop distance and risk-per-path

conducks_traceDijkstra pathfinding, execution circuits, data flow chains

conducks_auditSentinel checks, cycle detection, god objects, Architectural Lies, archeology mode

conducks_evolutionGVR rename, structural diff between pulses, drift analysis

conducks_systemArchitecture context generation, installer, multi-workspace federation

conducks_linkFederated repo linking, cross-synapse edge resolution, Additive Hydration

CLI Reference

33 commands across 9 domains. Run conducks help for the full reference, grouped by domain.

Analysis

conducks analyze

conducks status

conducks watch

conducks context

Discovery

conducks query

conducks list

conducks entry

Behavioral

conducks trace

conducks impact

conducks flows

Metrics

conducks explain

conducks entropy

conducks cohesion

Governance

conducks audit

conducks fallback

conducks advise

conducks verify

conducks guard

Evolution

conducks rename

conducks prune

conducks diff

conducks drift

Intelligence

conducks resonance

Visual

conducks mirror

conducks visualize

conducks blueprint

conducks context-gen

System

conducks mcp

conducks link

conducks setup

conducks bootstrap-docs

conducks clean

conducks record

conducks help

← Back to Overview