@paycall-live/mcp
v0.1.0
Published
Stdio MCP server: lets an AI agent pay for x402 (HTTP 402) APIs from your prepaid PayCall balance.
Maintainers
Readme
@paycall-live/mcp
Stdio MCP server that lets an AI agent pay for x402 (HTTP 402) APIs from your prepaid PayCall balance.
Most users don't need this package. Use the hosted server, no install:
claude mcp add --transport http paycall https://api.paycall.live/mcp, then/mcp→ paycall → Authenticate. This local version is for offline/self-run agents and SDK key files.
Tools:
paid_fetch {url, method?, headers?, body?}: fetches the URL and pays automatically if it answers 402 withpaycall-prepaid. Returns the status, the amount paid, and the body (cut at 20k chars).login {name?}: connects this agent to your PayCall wallet. Returns a URL + code to approve in the browser.wallet_info {}: login status, agent pubkey, spent this session.
Setup
Add the server once (no key needed):
claude mcp add paycall -- npx -y @paycall-live/mcpClaude Desktop, claude_desktop_config.json:
{ "mcpServers": { "paycall": { "command": "npx", "args": ["-y", "@paycall-live/mcp"] } } }Needs Node 20+. (If Claude Desktop can't find npx, use its absolute path.)
Login
Ask Claude to "log in to PayCall", or run:
npx -y @paycall-live/mcp login [name]It makes an Ed25519 key on this machine, prints a code and opens the dashboard's connect page. Log in, type the code, approve. The key is saved to ~/.config/paycall/agent.json (mode 600) and is picked up without restarting the MCP server. Only the public key is ever sent.
Lost the key or switching wallet/machine? Log in again: the new key replaces (pauses) the old one, your balance stays.
Env: PAYCALL_API (default the deployed worker), PAYCALL_KEY_FILE (key path). Legacy PAYCALL_AGENT_KEY still works when no key file exists.
Already added with -e PAYCALL_AGENT_KEY=…? claude mcp remove paycall, then add it again as above.
Dev
bun install
bun run scripts/smoke.ts # live: fresh unfunded owner → expects the "insufficient balance" error
bun run scripts/login-smoke.ts # local worker: SK=<service key> PAYCALL_API=http://localhost:8787 KEY_FILE=/tmp/k.jsonNote: in this repo @paycall-live/sdk comes from file:../paycall-sdk. Bun symlinks each file, so edits show up right away. If you add new files to the SDK, run bun install --force here.
Publish: bun run build runs on npm publish (prepublishOnly). Swap the sdk dep to the registry version first (bun add @paycall-live/sdk@^<version>).
