pch-x402-mcp

pch-x402-mcp (MCP wrapper)

MCP server that exposes the PathCourse Health inference SKUs as x402 paid tools (the seller paidTool pattern). An MCP client pays per call with an EIP-712 debit authorization rather than a flat API key. Targets MCP Specification 2026.

Phase E E.3 greenfield skeleton (worktree-e). DRAFT, NOT PUBLISHED. The paid-tool manifest is built and tested; the MCP protocol handlers + sign/submit wiring are skeletons pending the Phase E full build (signing is delegated to pch-x402-client, so this package holds no keys). Source is fully readable in this package (Principle 13); links resolve to https://pathcoursehealth.com.

JS usage

const { createServer, createTransport } = require('pch-x402-mcp');

const server = createServer({ escrowAddress: ESCROW_ADDRESS, chainId: 8453 });
server.listTools();                 // -> 13 v2.1 SKUs as paid tools
// createTransport('stdio').start(); // wired in the Phase E full build

Paid tools

One MCP tool per PCH SKU (13 v2.1 SKUs; canonical set owned by Phase D.11). Each tool carries an x402 payment annotation (payment.required = true, rail x402, asset USDC, the billing unit, and the escrow contract + chain). v2.1 lineup only (no retired SKUs).

MCP Registry

server.json is a draft manifest. Per Wave G.R.8, the MCP Registry submission policy is verified before first publish; if a public code-host URL is mandatory, a content-empty stub repo is used as a documented scoped compromise (default posture is no public code host).

Test

npm test   # node test/paid_tools.test.js

Status

Greenfield skeleton. Not on npm/PyPI/MCP Registry. Publication is a Phase E hard stop.