PCH MCP Server
Drop-in MCP server for PathCourse Health (PCH) — cheaper LLM inference, USDC-based agent payments, and agent identity / reputation lookup. Works in Claude Desktop, Cursor, Cline, Continue.dev, and Zed.
14 tools. 7 free (no API key needed) and 7 authenticated. Includes a unique flow that lets you buy a PCH API key from inside Claude Desktop using USDC — no signup form, no email verification.
Install
Claude Desktop, Cursor, Cline, Continue.dev, Zed (npm)
Add to your client's MCP config:
{
"mcpServers": {
"pch": {
"command": "npx",
"args": ["-y", "@pathcourse/mcp-server"],
"env": {
"PCH_API_KEY": "pch_prod_b_..."
}
}
}
}
If you don't have a PCH API key yet, omit the env block. Many tools work without authentication; you can obtain a key via the pch_provision tool.
Per-client install instructions:
Python clients (PyPI)
uvx pch-mcp-server
# or
pip install pch-mcp-server
Tools
Free (no API key)
| Tool | What it does |
|---|---|
pch_models | List all PCH models with rates and tier requirements |
pch_estimate | Estimate cost of an inference request before running it |
pch_status | Gateway health and service status |
pch_provision | Get USDC payment instructions to obtain an API key |
pch_pay | Submit USDC payment proof; returns API key + first inference |
pch_lookup_agent_identity | Lookup an agent's ERC-8004 identity record |
pch_get_path_score | Look up an agent's Path Score (0-1000) |
pch_get_agent_history | 12-month trend of an agent's score components |
pch_verify_certification | Verify a PCH-issued certification |
pch_compare_costs | Compare PCH model cost vs GPT-4o, Claude Sonnet, Claude Haiku |
Authenticated (PCH_API_KEY required)
| Tool | What it does |
|---|---|
pch_inference | Run LLM inference on a PCH model |
pch_balance | Check remaining USDC balance and current tier |
pch_check_agent_reputation | Deeper reputation lookup ($0.001 USDC per query) |
pch_my_account | Self-service balance + identity + recent activity |
Configuration
| Env var | Default | Notes |
|---|---|---|
PCH_API_KEY | (none) | Required for authenticated tools. Format: pch_prod_b_... |
PCH_GATEWAY_URL | https://gateway.pathcoursehealth.com | Override for staging or local dev |
Security
Never commit PCH_API_KEY to a public repo. The wrapper logs a warning at startup if it detects a key that looks like a real production key being passed through env. If you accidentally exposed your key, rotate it via PCH support.
License
MIT
Source
This wrapper is open source: pathcourse-health/pch-mcp-server
The upstream PCH MCP server lives in the (private) pch-platform-gateway repo.