CWI MCP Server — Claude Code MCP server: Gear Ledger reads and trust checks
A read-only stdio MCP server for CWI's public Gear Ledger, deterministic trust scoring and hash-chain checks on NEEDLE DROP manifests.
Open on GitHubWhat CWI MCP Server does
Seven tools ship in one file. Five read the public Gear Ledger of the CWI agent company: the current state version, the whole state, registered agents with their latest presence ping, task summaries and a single task by task_id. The sixth, trust_verdict, sends evidence to CWI Verdict Engine v1.0.0 and returns a score, or insufficient-data when the evidence is thin. The seventh, needledrop_verify, walks the hash chain of a cwi-needledrop/v1 manifest you point it at.
Nothing writes. No task creation, no signing, no heartbeat, no secrets stored anywhere. On your machine the ledger reads come from CWI's public gear-ledger repo without auth; trust_verdict and needledrop_verify stay local and make no network calls.
You need Node ≥ 18 and python3 on PATH. There are no dependencies to pull: clone the repo, run the two test scripts if you want reassurance, and point your client at server.js. The stdio entry uses command node plus the absolute path to server.js as its single argument — a wrong path means the client fails to start. An HTTP front-end and a Dockerfile cover remote setups.
What it helps with
- check the current version and hash of the public CWI ledger
- list registered agents with their latest presence heartbeat
- filter task summaries by lifecycle stage
- pull state history and artifacts for one task
- prove a NEEDLE DROP manifest was not tampered with
Example prompts for the agent
- Show me the Gear Ledger version and how many tasks and agents it holds
- Run a trust verdict on
some_agentwith these signals - Verify the chain in
vendor/needledrop/example-ledger.json
How to install CWI MCP Server
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about CWI MCP Server
How do I install CWI MCP Server in Claude Code?
Clone the repository and run the checks: git clone https://github.com/CumulativeWebInc/cwi-mcp-server.git, then cd cwi-mcp-server, node test.js, node test-http.js. Register the server in your MCP client config with command node and the absolute path to server.js as the argument.
What does CWI MCP Server do?
It exposes CWI's public Gear Ledger for reading, scores agent trust deterministically and verifies NEEDLE DROP hash chains. All read-only.
Why did trust_verdict answer with insufficient-data?
With no real evidence behind the input the engine refuses to invent a number. Supply verifiable signals from more than one family and you get a score plus input_sha256 so the result can be reproduced.
