English Français العربية

io.github.pay-skill/pay-mcp

Registre officiel Finance et paiements

USDC payments for AI agents on Base — direct, tabs, x402 paywalls, discovery

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @pay-skill/mcp
Claude Code 
claude mcp add pay-mcp -e 'PAYSKILL_SIGNER_KEY=<your payskill_signer_key>' -e 'PAY_NETWORK=<PAY_NETWORK>' -- npx -y @pay-skill/mcp@0.2.8
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "pay-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@pay-skill/mcp@0.2.8"
            ],
            "env": {
                "PAYSKILL_SIGNER_KEY": "<your payskill_signer_key>",
                "PAY_NETWORK": "<PAY_NETWORK>"
            }
        }
    }
}

Variables d'environnement

  • PAYSKILL_SIGNER_KEY secret Private key hex for importing an existing wallet (optional — generates new wallet if not set)
  • PAY_NETWORK Network to use: mainnet or testnet (default: mainnet)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. @pay-skill/mcp
  2. Setup
  3. Configuration
  4. Diagnostic Check
  5. Tools (15)
  6. Resources (5)
  7. Prompts (3)
  8. Development
  9. License
  10. Part of Pay

@pay-skill/mcp

MCP server for Pay -- the complete x402 payment stack for AI agents. USDC on Base.

Gives any MCP-compatible client (Claude Desktop, Cursor, VS Code, custom frameworks) the full power of Pay: direct payments, tabs, x402 paywalls, service discovery, and wallet management. No CLI binary needed.

Setup

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}
VS Code / Cursor

Add to .vscode/mcp.json:

{
  "servers": {
    "pay": {
      "command": "npx",
      "args": ["-y", "@pay-skill/mcp"]
    }
  }
}
Claude Code
claude mcp add pay -- npx -y @pay-skill/mcp

That's it. On first run, the server generates a wallet and stores it in the OS keychain (Windows Hello, macOS Keychain, Linux Secret Service). Subsequent runs load it automatically.

Configuration

Env VarRequiredDefaultDescription
PAYSKILL_SIGNER_KEYNo—Optional override. Raw hex key or .enc keystore password. Not needed for normal use.
PAY_NETWORKNomainnetmainnet (Base) or testnet (Base Sepolia)
Key Resolution (checked in order)
  1. OS keychain (default) — Loads from the OS credential store via keytar. On first run, a new keypair is generated and stored automatically.
  2. Encrypted keystore — If ~/.pay/keys/default.enc exists, PAYSKILL_SIGNER_KEY is used as the decryption password.
  3. Raw hex key — If PAYSKILL_SIGNER_KEY is a 64-char hex string, it's used directly. For dev/testing or importing an existing wallet.
  4. Auto-generate — If none of the above, generates a new keypair and stores it in the OS keychain.

Diagnostic Check

Verify everything is configured correctly:

npx @pay-skill/mcp --check

Output:

pay-mcp diagnostic check
  network: Base (chain 8453)
  api:     https://pay-skill.com/api/v1
  wallet:  0x1234...
  key:     keychain
  server:  OK (router: 0xABCD...)
  auth:    OK (balance: $50.00)

All checks passed. MCP server is ready.

Tools (15)

Payments
ToolDescription
pay_sendDirect USDC payment ($1 min). Confirmation thresholds: <$10 auto, $10-100 plan, >$100 explicit.
pay_requestHTTP request with x402 auto-payment. Handles 402 detection, direct/tab settlement, price skepticism.
Tabs (metered accounts)
ToolDescription
pay_tab_openOpen pre-funded tab ($5 min, $50 recommended). Provider charges per-call.
pay_tab_closeClose tab. Returns distribution breakdown (provider 99%, fee 1%, agent remainder).
pay_tab_chargeCharge against open tab (provider only).
pay_tab_topupAdd funds to open tab (agent only).
pay_tab_listList tabs with idle/low-balance flags.
Wallet
ToolDescription
pay_statusBalance, locked/available funds, actionable suggestions.
pay_fundGenerate 1-hour funding link (Coinbase Onramp or direct USDC).
pay_withdrawGenerate 1-hour withdrawal link.
pay_mintMint testnet USDC (Base Sepolia only).
Discovery & Webhooks
ToolDescription
pay_discoverSearch paid API services by keyword/category.
pay_webhook_registerRegister webhook for payment events (HMAC-signed).
pay_webhook_listList registered webhooks.
pay_webhook_deleteDelete a webhook.

Resources (5)

URIDescription
pay://wallet/statusBalance, tabs, locked/available
pay://wallet/tabsAll open tabs
pay://tab/{tab_id}Single tab detail
pay://wallet/addressWallet address
pay://networkNetwork config + contract addresses

Prompts (3)

PromptDescription
pay-for-serviceGuided: discover service, evaluate pricing, make request
review-tabsReview tabs, flag idle, suggest close/topup
fund-walletGenerate fund link, explain deposit process

Development

git clone https://github.com/pay-skill/pay-mcp.git
cd pay-mcp
npm install
npm run build
npm test                    # unit tests (mocked)
npm run test:acceptance     # testnet (requires PAYSKILL_TESTNET_KEY)

License

MIT

Part of Pay

Pay is the complete x402 payment stack -- gateway, facilitator, SDKs, CLI, and MCP server -- that lets AI agents pay for APIs with USDC on Base.

Questions fréquentes

Qu'est-ce que io.github.pay-skill/pay-mcp ?

USDC payments for AI agents on Base — direct, tabs, x402 paywalls, discovery

Comment installer io.github.pay-skill/pay-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add pay-mcp -e 'PAYSKILL_SIGNER_KEY=<your payskill_signer_key>' -e 'PAY_NETWORK=<PAY_NETWORK>' -- npx -y @pay-skill/mcp@0.2.8. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.pay-skill/pay-mcp ?

Oui. Il attend PAYSKILL_SIGNER_KEY, à renseigner dans sa configuration.

io.github.pay-skill/pay-mcp est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.pay-skill/pay-mcp ?

Il est publié par pay-skill. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.