English Français العربية

PathCourse Health (PCH)

Official registry Health

Cheaper LLM inference, USDC agent payments via x402, agent identity / reputation lookup.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @pathcourse/mcp-server
Claude Code 
claude mcp add pathcourse-health-pch -e 'PCH_API_KEY=<your pch_api_key>' -e 'PCH_GATEWAY_URL=https://gateway.pathcoursehealth.com' -- npx -y @pathcourse/mcp-server@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pathcourse-health-pch": {
            "command": "npx",
            "args": [
                "-y",
                "@pathcourse/mcp-server@1.0.1"
            ],
            "env": {
                "PCH_API_KEY": "<your pch_api_key>",
                "PCH_GATEWAY_URL": "https://gateway.pathcoursehealth.com"
            }
        }
    }
}

Environment variables

  • PCH_API_KEY secret Your PCH API key (format: pch_prod_b_...). Optional — many tools work without it. Mint one via the pch_provision tool by sending 5 USDC on Base.
  • PCH_GATEWAY_URL Override the PCH gateway URL. Defaults to https://gateway.pathcoursehealth.com (production mainnet).
PYPI package pch-mcp-server
Claude Code 
claude mcp add pathcourse-health-pch -e 'PCH_API_KEY=<your pch_api_key>' -e 'PCH_GATEWAY_URL=https://gateway.pathcoursehealth.com' -- uvx pch-mcp-server==1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pathcourse-health-pch": {
            "command": "uvx",
            "args": [
                "pch-mcp-server==1.0.1"
            ],
            "env": {
                "PCH_API_KEY": "<your pch_api_key>",
                "PCH_GATEWAY_URL": "https://gateway.pathcoursehealth.com"
            }
        }
    }
}

Environment variables

  • PCH_API_KEY secret Your PCH API key (format: pch_prod_b_...). Optional — many tools work without it. Mint one via the pch_provision tool by sending 5 USDC on Base.
  • PCH_GATEWAY_URL Override the PCH gateway URL. Defaults to https://gateway.pathcoursehealth.com (production mainnet).

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. PCH MCP Server
  2. Install
  3. Tools
  4. Configuration
  5. Security
  6. License
  7. Source

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)
ToolWhat it does
pch_modelsList all PCH models with rates and tier requirements
pch_estimateEstimate cost of an inference request before running it
pch_statusGateway health and service status
pch_provisionGet USDC payment instructions to obtain an API key
pch_paySubmit USDC payment proof; returns API key + first inference
pch_lookup_agent_identityLookup an agent's ERC-8004 identity record
pch_get_path_scoreLook up an agent's Path Score (0-1000)
pch_get_agent_history12-month trend of an agent's score components
pch_verify_certificationVerify a PCH-issued certification
pch_compare_costsCompare PCH model cost vs GPT-4o, Claude Sonnet, Claude Haiku
Authenticated (PCH_API_KEY required)
ToolWhat it does
pch_inferenceRun LLM inference on a PCH model
pch_balanceCheck remaining USDC balance and current tier
pch_check_agent_reputationDeeper reputation lookup ($0.001 USDC per query)
pch_my_accountSelf-service balance + identity + recent activity

Configuration

Env varDefaultNotes
PCH_API_KEY(none)Required for authenticated tools. Format: pch_prod_b_...
PCH_GATEWAY_URLhttps://gateway.pathcoursehealth.comOverride 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.

Frequently asked questions

What is PathCourse Health (PCH)?

Cheaper LLM inference, USDC agent payments via x402, agent identity / reputation lookup.

How do I install PathCourse Health (PCH)?

It runs on your machine. In Claude Code: claude mcp add pathcourse-health-pch -e 'PCH_API_KEY=<your pch_api_key>' -e 'PCH_GATEWAY_URL=https://gateway.pathcoursehealth.com' -- npx -y @pathcourse/mcp-server@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does PathCourse Health (PCH) need an API key?

Yes. It expects PCH_API_KEY, which you set in its configuration.

Is PathCourse Health (PCH) open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains PathCourse Health (PCH)?

It is published by pathcourse-health. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.