agent-payment-mcp — AI Agent Payment MCP Server by LemonCake

🎮 Try instantly — no signup needed. Click "Try in Browser" above → leave BOTH env var fields EMPTY → click Start Inspector. Demo Mode hits real Wikipedia / httpbin / live FX APIs. No account, no card, no API key.

📦 v0.6.0 rename: the npm package is now agent-payment-mcp (was lemon-cake-mcp). The old name still works as a thin wrapper, but new configs should use npx -y agent-payment-mcp.

Give your AI agent a wallet. Pay-per-call USDC payments for any HTTP API — straight from Claude Desktop, Cursor, Cline, or any MCP client. No human in the loop, no per-API signups, no API key juggling.

LemonCake の MCP サーバーで、Claude Desktop / Cursor / Cline などの MCP 互換クライアントから、人間の介在なしに USDC で有料 API を呼び出せるようになります。

English ↓ Quickstart · Tools · Use Cases · Compatibility

🚀 3分で始める

MCP サーバーの利用には LemonCake アカウントと USDC 残高が必要です。

1. 無料アカウント作成 — メール1つで完了
2. 残高チャージ — 最低 $5 USDC または JPYC（Billing）
3. Buyer JWT をコピー — Dashboard → API Keys から
4. 下記の claude_desktop_config.json に設定

📚 詳細: クイックスタート ドキュメント

📦 インストール

Claude Desktop の場合

~/Library/Application Support/Claude/claude_desktop_config.json（macOS）または %APPDATA%\Claude\claude_desktop_config.json（Windows）に追加:

{
  "mcpServers": {
    "pay-per-call": {
      "command": "npx",
      "args": ["-y", "agent-payment-mcp"],
      "env": {
        "LEMON_CAKE_BUYER_JWT": "eyJhbGci..."
      }
    }
  }
}

Claude Desktop を再起動すれば、🔨 ツールアイコンに LemonCake のツールが表示されます。

Cursor / Cline / その他 MCP クライアント

同様に、サーバー起動コマンドを npx -y agent-payment-mcp / 環境変数に LEMON_CAKE_BUYER_JWT を設定してください。

Node.js 要件: v20 以上

🛠️ 提供ツール

すべての引数スキーマは MCP Inspector または tools/list で取得可能です。

🎮 Demo Mode（認証情報なしで試せる）

LEMON_CAKE_BUYER_JWT / LEMON_CAKE_PAY_TOKEN を何も設定せずに起動すると、自動で DEMO MODE になります。サインアップなしで以下が動きます：

• list_services → 実マーケット + demo_search (Wikipedia) / demo_echo (httpbin) / demo_fx (open.er-api) の 3 デモが先頭に
• call_service → demo_* サービスは実フリー API を叩いて生データを返却（課金なし、認証なし）
• check_balance → $1.00 のモック残高を返却（mode: "demo"）
• check_tax / get_service_stats → 通常通り（元から認証不要）

→ Glama Inspector や npm の試用環境 でも、何も設定せず実装挙動を確認できます。本番の有料 API を叩きたくなったら LEMON_CAKE_PAY_TOKEN を設定してください。

💡 Try these prompts（MCP プロンプト）

このサーバーは MCP の prompts capability に対応しています。Glama Inspector / Claude Desktop / Cursor の "prompt picker" に下記のプリセットが表示され、ワンクリックで実行できます：

→ Glama / Claude Desktop で pay-per-call MCP（旧 lemon-cake）を有効にすると、上記が自動で候補に出ます。

💡 使い方の例

Claude Desktop で:

「LemonCake で demo_agent_search_api を 0.50 USDC で呼び出して、"AI agent payments" を検索して」

Claude は自動で:

1. setup でセットアップ状況を確認（初回のみ）
2. call_service(serviceId="demo_agent_search_api", limitUsdc="0.50", body={query:"AI agent payments"})
3. 結果を要約して返答

🎯 Use Cases

• Autonomous research agents — Let your agent pay-per-call for premium search, scraping, or data APIs without giving it your credit card.
• Multi-API workflows — One JWT, one balance, dozens of upstream APIs. No per-vendor signup or rotating keys.
• Compliance-aware spending — KYA (Know-Your-Agent) limits cap how much an agent can spend per session/day.
• Japanese tax automation — check_tax validates 適格請求書 numbers against 国税庁 API for invoice compliance.
• Idempotent retries — idempotencyKey makes call_service safe to retry without double-charging.

🪙 x402-compatible interface (since v0.5.1)

This server speaks the x402 idiom even though settlement happens off-chain via a Pay Token. The same agent code that handles on-chain x402 receipts works against agent-payment-mcp unmodified.

Successful calls return an x402Receipt

{
  "status": 200,
  "chargeId": "ch_abc123",
  "amountUsdc": "0.005",
  "response": { "...": "upstream payload" },
  "x402Receipt": {
    "scheme":          "lemoncake-pay-token-v1",
    "x402Compatible":  true,
    "chain":           "off-chain (LemonCake Pay Token)",
    "asset":           "USDC",
    "amount":          "0.005",
    "recipient":       "serper",
    "paymentIntentId": "ch_abc123",
    "settledAt":       "2026-05-09T14:50:11.019Z"
  }
}

Upstream 402 challenges are parsed

If a service returns an x402 challenge, call_service surfaces it as x402Challenge for your agent to reason about. Three challenge sources are recognised:

⚠️ On-chain auto-pay of detected challenges (debiting the upstream's address from the Pay Token's USDC balance) is gated on the LemonCake HOT_WALLET rollout — see issue #4. For now, the agent should escalate or pick another service.

PAYMENT_PENDING semantics for async settlement

If upstream returns 202 + Retry-After + X-Payment-Status: pending, call_service returns:

{
  "status": "PAYMENT_PENDING",
  "paymentIntentId": "pi_xyz",
  "retryAfterMs": 5000,
  "retryContract": "Call call_service again with the SAME idempotencyKey after 5000ms. The original request will resume; no double-charge."
}

Agents should sleep retryAfterMs and retry with the same idempotencyKey. Demo Mode shows the same shape so you can write the handler against demo_search and ship it unchanged.

✅ Tested Clients

🔐 環境変数

🏃 ローカル開発

git clone https://github.com/evidai/lemon-cake.git
cd lemon-cake/mcp-server
npm install
npm run build
npm start

Docker

docker build -t agent-payment-mcp .
docker run --rm -i -e LEMON_CAKE_BUYER_JWT=eyJhbGci... agent-payment-mcp

イメージは Glama Inspector のブラウザ内プレビューにも利用されます。

🔗 関連リンク

• LemonCake ダッシュボード
• API ドキュメント
• Glama MCP listing
• Model Context Protocol
• GitHub
• Security Policy · Contributing · Code of Conduct

📄 ライセンス

MIT © LemonCake