pay-per-call-mcp 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Evid AI / LemonCake
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,191 @@
+# 🍋 LemonCake — AI Agent Wallet & USDC Pay-per-call MCP Server
+
+> 🎮 **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.
+
+[![npm version](https://img.shields.io/npm/v/pay-per-call-mcp)](https://www.npmjs.com/package/pay-per-call-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/pay-per-call-mcp)](https://www.npmjs.com/package/pay-per-call-mcp)
+[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![Glama MCP](https://img.shields.io/badge/Listed%20on-Glama-7c3aed)](https://glama.ai/mcp/servers/evidai/lemon-cake)
+[![Node.js](https://img.shields.io/node/v/pay-per-call-mcp)](https://nodejs.org)
+
+> 📦 **v0.5.0 rename:** the npm package is now **`pay-per-call-mcp`** (was `lemon-cake-mcp`). The old name still works as a thin wrapper, but new configs should use `npx -y pay-per-call-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](#-3分で始める) · [Tools](#%EF%B8%8F-提供ツール) · [Use Cases](#-use-cases) · [Compatibility](#-tested-clients)
+
+---
+
+## 🚀 3分で始める
+
+MCP サーバーの利用には LemonCake アカウントと USDC 残高が必要です。
+
+1. **[無料アカウント作成](https://lemoncake.xyz/register?utm_source=mcp-server&utm_medium=npm-readme&utm_campaign=onboard)** — メール1つで完了
+2. **残高チャージ** — 最低 $5 USDC または JPYC（[Billing](https://lemoncake.xyz/dashboard/billing?utm_source=mcp-server&utm_medium=npm-readme&utm_campaign=topup)）
+3. **Buyer JWT をコピー** — [Dashboard → API Keys](https://lemoncake.xyz/dashboard?utm_source=mcp-server&utm_medium=npm-readme) から
+4. 下記の `claude_desktop_config.json` に設定
+
+> 📚 詳細: [クイックスタート ドキュメント](https://lemoncake.xyz/docs/quickstart?utm_source=mcp-server&utm_medium=npm-readme)
+
+---
+
+## 📦 インストール
+
+### Claude Desktop の場合
+
+`~/Library/Application Support/Claude/claude_desktop_config.json`（macOS）または
+`%APPDATA%\Claude\claude_desktop_config.json`（Windows）に追加:
+
+```json
+{
+  "mcpServers": {
+    "pay-per-call": {
+      "command": "npx",
+      "args": ["-y", "pay-per-call-mcp"],
+      "env": {
+        "LEMON_CAKE_BUYER_JWT": "eyJhbGci..."
+      }
+    }
+  }
+}
+```
+
+Claude Desktop を再起動すれば、🔨 ツールアイコンに LemonCake のツールが表示されます。
+
+### Cursor / Cline / その他 MCP クライアント
+
+同様に、サーバー起動コマンドを `npx -y pay-per-call-mcp` / 環境変数に `LEMON_CAKE_BUYER_JWT` を設定してください。
+
+**Node.js 要件**: v20 以上
+
+---
+
+## 🛠️ 提供ツール
+
+| ツール名 | 用途 | 主なパラメータ |
+|---|---|---|
+| `setup` | 初回セットアップガイド（アカウント作成・チャージ方法を返す） | — |
+| `list_services` | LemonCake マーケットプレイスで利用可能な有料 API 一覧 | `limit?` (1–100) |
+| `call_service` | 指定サービスへ Pay Token 経由で課金付き呼び出し | `serviceId`, `path?`, `method?`, `body?`, `idempotencyKey?` |
+| `check_balance` | 現在の USDC 残高と KYA 上限を取得 | — |
+| `check_tax` | 国税庁 API で適格請求書発行事業者番号を検証 | `registrationNumber` (T+13桁), `description?`, `amountJpy?` |
+| `get_service_stats` | サービス別の利用統計・課金履歴集計 | — |
+
+すべての引数スキーマは 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 の試用環境](https://www.npmjs.com/package/pay-per-call-mcp) でも、何も設定せず実装挙動を確認できます。本番の有料 API を叩きたくなったら `LEMON_CAKE_PAY_TOKEN` を設定してください。
+
+---
+
+## 💡 Try these prompts（MCP プロンプト）
+
+このサーバーは MCP の **prompts capability** に対応しています。Glama Inspector / Claude Desktop / Cursor の "prompt picker" に下記のプリセットが表示され、ワンクリックで実行できます：
+
+| Prompt 名 | 内容 | 認証 |
+|---|---|---|
+| 🎮 `explore-demo` | デモモードで setup → list_services → demo_search → demo_fx を一気通貫 | 不要 |
+| 🛍 `discover-marketplace` | 実マーケットの全サービスを listing して、用途別に top 3 を推薦 | 不要 |
+| 🇯🇵 `japan-tax-check` | 適格請求書発行事業者番号を国税庁で検証＋源泉徴収判定 | 不要 |
+| 💰 `spend-with-budget` | check_balance → call_service → check_balance のパターンで予算管理を実演 | demo OK / 実 service には PAY_TOKEN |
+| 🔄 `real-vs-demo` | 同じクエリを demo_search と実 Serper で叩いて比較 | demo OK / 比較に PAY_TOKEN |
+| 🏯 `japan-finance-bundle` | gBizINFO + 国税庁 + e-Gov を組み合わせた日本企業リサーチ | PAY_TOKEN（demo 部分は不要） |
+
+→ 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.
+
+---
+
+## ✅ Tested Clients
+
+| Client | Status | Notes |
+|---|:---:|---|
+| Claude Desktop (macOS / Windows) | ✅ | Primary target |
+| Cursor | ✅ | stdio transport |
+| Cline (VS Code) | ✅ | stdio transport |
+| Claude Code CLI | ✅ | stdio transport |
+| Continue.dev | ✅ | MCP support since v0.9 |
+| Custom MCP clients | ✅ | Any client speaking MCP 1.10+ over stdio |
+
+---
+
+## 🔐 環境変数
+
+| 変数名 | 必須 | 説明 |
+|---|:---:|---|
+| `LEMON_CAKE_BUYER_JWT` | ✅ | Buyer JWT（ダッシュボードの Settings → API Keys から取得）|
+| `LEMON_CAKE_PAY_TOKEN` | — | Pay Token JWT（`call_service` で必要、未設定なら demo_* サービスのみ呼べる）|
+| `LEMON_CAKE_API_URL` | — | API エンドポイント（デフォルト: `https://api.lemoncake.xyz`）|
+
+---
+
+## 🏃 ローカル開発
+
+```bash
+git clone https://github.com/evidai/lemon-cake.git
+cd lemon-cake/mcp-server
+npm install
+npm run build
+npm start
+```
+
+### Docker
+
+```bash
+docker build -t pay-per-call-mcp .
+docker run --rm -i -e LEMON_CAKE_BUYER_JWT=eyJhbGci... pay-per-call-mcp
+```
+
+イメージは Glama Inspector のブラウザ内プレビューにも利用されます。
+
+---
+
+## 🔗 関連リンク
+
+- [LemonCake ダッシュボード](https://lemoncake.xyz/dashboard?utm_source=mcp-server&utm_medium=npm-readme)
+- [API ドキュメント](https://lemoncake.xyz/docs?utm_source=mcp-server&utm_medium=npm-readme)
+- [Glama MCP listing](https://glama.ai/mcp/servers/evidai/lemon-cake)
+- [Model Context Protocol](https://modelcontextprotocol.io)
+- [GitHub](https://github.com/evidai/lemon-cake)
+- [Security Policy](https://github.com/evidai/lemon-cake/blob/main/SECURITY.md) · [Contributing](https://github.com/evidai/lemon-cake/blob/main/CONTRIBUTING.md) · [Code of Conduct](https://github.com/evidai/lemon-cake/blob/main/CODE_OF_CONDUCT.md)
+
+---
+
+## 📄 ライセンス
+
+MIT © [LemonCake](https://lemoncake.xyz)

package/dist/index.js

@@ -0,0 +1,903 @@
+#!/usr/bin/env node
+/**
+ * LemonCake MCP Server v0.2.0
+ *
+ * AIエージェントにLemonCakeの決済インフラを提供するMCPサーバー。
+ *
+ * Tools:
+ *  - setup             : 初回セットアップガイド（認証不要）
+ *  - list_services     : マーケットプレイスの公開サービス一覧（認証不要）
+ *  - get_service_stats : サービスの利用統計（認証不要）
+ *  - check_tax         : 日本の税務コンプライアンス確認（認証不要）
+ *  - check_balance     : USDC残高確認（LEMON_CAKE_BUYER_JWT 必須）
+ *  - call_service      : Pay-per-call APIプロキシ（LEMON_CAKE_PAY_TOKEN 必須）
+ *
+ * 環境変数:
+ *  LEMON_CAKE_PAY_TOKEN  : Pay Token JWT（ダッシュボードで発行）※ call_service に必須
+ *  LEMON_CAKE_BUYER_JWT  : Buyer JWT（ログイン時に取得）     ※ check_balance に必須
+ *  LEMON_CAKE_API_URL    : APIベースURL（省略可）
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+// ── 設定 ──────────────────────────────────────────────────────────────────────
+const API_URL = (process.env.LEMON_CAKE_API_URL ?? "https://api.lemoncake.xyz").replace(/\/$/, "");
+const PAY_TOKEN = process.env.LEMON_CAKE_PAY_TOKEN ?? "";
+const BUYER_JWT = process.env.LEMON_CAKE_BUYER_JWT ?? "";
+// ── バージョン・ユーザーエージェント ─────────────────────────────────────
+// 単一ソース化: package.json の version を読む。ESM の import attributes を
+// 使わずに createRequire 経由にすることで、バンドラなしで Node 22 でも動く。
+import { createRequire } from "node:module";
+const requireFromHere = createRequire(import.meta.url);
+const MCP_VERSION = requireFromHere("../package.json").version;
+const USER_AGENT = `pay-per-call-mcp/${MCP_VERSION} (node/${process.versions.node}; ${process.platform} ${process.arch})`;
+// ── デモモード（認証情報なしで Glama Inspector / 新規ユーザーが試せるように） ──
+const DEMO_MODE = !PAY_TOKEN && !BUYER_JWT;
+/**
+ * Fire-and-forget fetch with a hard timeout. Returns null on any failure
+ * so demo handlers can fall back to canned data without blocking the user.
+ */
+async function tryFetch(url, init, timeoutMs = 4000) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), timeoutMs);
+    try {
+        const res = await fetch(url, { ...init, signal: ctrl.signal, headers: { "User-Agent": USER_AGENT, ...(init?.headers ?? {}) } });
+        if (!res.ok)
+            return null;
+        const ct = res.headers.get("content-type") ?? "";
+        return ct.includes("application/json") ? await res.json() : await res.text();
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+const DEMO_SERVICES = [
+    {
+        id: "demo_search",
+        name: "Demo Search (Wikipedia, free)",
+        provider: "LemonCake DEMO → Wikipedia",
+        type: "API",
+        pricePerCall: "0.00 USDC (free demo, real upstream)",
+        description: "Searches English Wikipedia via opensearch API. Returns up to 5 matching titles with snippets and URLs for any query. No auth required.",
+        example: { path: "/search", method: "POST", body: { q: "Model Context Protocol" } },
+        handler: async (_path, body) => {
+            const q = body?.q ?? "Model Context Protocol";
+            const data = await tryFetch(`https://en.wikipedia.org/w/api.php?action=opensearch&search=${encodeURIComponent(q)}&limit=5&format=json&namespace=0&origin=*`);
+            // opensearch returns [query, titles[], descriptions[], urls[]]
+            if (Array.isArray(data) && data.length === 4 && Array.isArray(data[1])) {
+                const titles = data[1];
+                const descriptions = data[2] ?? [];
+                const urls = data[3] ?? [];
+                return {
+                    query: q,
+                    results: titles.map((title, i) => ({ title, snippet: descriptions[i] ?? "", url: urls[i] ?? "" })),
+                    upstream: "en.wikipedia.org/opensearch (real)",
+                };
+            }
+            // Fallback if upstream is down
+            return {
+                query: q,
+                results: [
+                    { title: "LemonCake — Give your AI agent a wallet", url: "https://lemoncake.xyz", snippet: "Pay-per-call USDC payments for any HTTP API." },
+                    { title: "Model Context Protocol", url: "https://modelcontextprotocol.io", snippet: "Open standard for connecting AI agents to tools." },
+                ],
+                upstream: "canned (Wikipedia unreachable)",
+            };
+        },
+    },
+    {
+        id: "demo_echo",
+        name: "Demo Echo (httpbin.org, free)",
+        provider: "LemonCake DEMO → httpbin.org",
+        type: "API",
+        pricePerCall: "0.00 USDC (free demo, real upstream)",
+        description: "Echoes your request via httpbin.org/anything. Returns headers, query params, and body — useful to verify your call_service request shape against a real HTTP server.",
+        example: { path: "/anything", method: "POST", body: { hello: "world" } },
+        handler: async (path, body) => {
+            const data = await tryFetch(`https://httpbin.org/anything${path}`, {
+                method: body ? "POST" : "GET",
+                headers: { "Content-Type": "application/json" },
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            if (data)
+                return { ...data, upstream: "httpbin.org (real)" };
+            return { receivedPath: path, receivedBody: body ?? null, timestamp: new Date().toISOString(), upstream: "canned (httpbin unreachable)" };
+        },
+    },
+    {
+        id: "demo_fx",
+        name: "Demo FX rates (open.er-api.com, free)",
+        provider: "LemonCake DEMO → open.er-api.com",
+        type: "API",
+        pricePerCall: "0.00 USDC (free demo, real upstream)",
+        description: "Real USD-base FX rates from open.er-api.com (free, no auth). Returns 160+ currencies updated daily.",
+        example: { path: "/latest", method: "GET" },
+        handler: async () => {
+            const data = await tryFetch("https://open.er-api.com/v6/latest/USD");
+            if (data && data.rates) {
+                return {
+                    base: data.base_code ?? "USD",
+                    rates: { JPY: data.rates.JPY, EUR: data.rates.EUR, GBP: data.rates.GBP, CNY: data.rates.CNY, KRW: data.rates.KRW },
+                    asOf: data.time_last_update_utc ?? null,
+                    upstream: "open.er-api.com (real)",
+                };
+            }
+            return { base: "USD", rates: { JPY: 150.42, EUR: 0.92, GBP: 0.79, CNY: 7.12 }, asOf: new Date().toISOString().slice(0, 10), upstream: "canned (er-api unreachable)" };
+        },
+    },
+];
+function findDemoService(id) {
+    return DEMO_SERVICES.find((s) => s.id === id);
+}
+const DEMO_NOTICE = "🎮 DEMO MODE — no real charge, no real upstream. Set LEMON_CAKE_PAY_TOKEN / LEMON_CAKE_BUYER_JWT to call real services. Run the `setup` tool for instructions.";
+// ── 登録/入金/ダッシュボード URL（UTM 付きで経由クライアントを区別） ──
+const UTM = "utm_source=mcp-server&utm_medium=cli";
+const REGISTER_URL = `https://lemoncake.xyz/register?${UTM}&utm_campaign=credential-missing`;
+const DASHBOARD_URL = `https://lemoncake.xyz/dashboard?${UTM}`;
+const BILLING_URL = `https://lemoncake.xyz/dashboard/billing?${UTM}&utm_campaign=topup`;
+const DOCS_URL = `https://lemoncake.xyz/docs/quickstart?${UTM}`;
+// ── 起動時: 認証状態を stderr に出力（MCP クライアントのログに残る）───────────
+const hasPayToken = PAY_TOKEN.length > 0;
+const hasBuyerJwt = BUYER_JWT.length > 0;
+console.error("[LemonCake MCP] Starting...");
+console.error(`[LemonCake MCP]   API URL     : ${API_URL}`);
+console.error(`[LemonCake MCP]   PAY_TOKEN   : ${hasPayToken ? "✓ set" : "✗ NOT SET — call_service will be unavailable"}`);
+console.error(`[LemonCake MCP]   BUYER_JWT   : ${hasBuyerJwt ? "✓ set" : "✗ NOT SET — check_balance will be unavailable"}`);
+console.error(`[LemonCake MCP]   MODE        : ${DEMO_MODE ? "🎮 DEMO (try-without-signup; demo_* services + mock balance)" : "LIVE"}`);
+if (DEMO_MODE) {
+    console.error("[LemonCake MCP]");
+    console.error("[LemonCake MCP]   🎮 Demo mode active — you can try these without any signup:");
+    console.error("[LemonCake MCP]     • list_services      → see real marketplace + 3 demo services");
+    console.error("[LemonCake MCP]     • call_service       → demo_search (DuckDuckGo) / demo_echo (httpbin) / demo_fx (open.er-api) — real upstreams, no auth");
+    console.error("[LemonCake MCP]     • check_balance      → returns a mock $1.00 demo balance");
+    console.error("[LemonCake MCP]     • check_tax / get_service_stats → real (no auth needed)");
+    console.error("[LemonCake MCP]");
+    console.error(`[LemonCake MCP]   For real calls, create a free account → ${REGISTER_URL}`);
+}
+else if (!hasPayToken || !hasBuyerJwt) {
+    console.error("[LemonCake MCP]");
+    console.error("[LemonCake MCP]   🚀 Get started in 3 minutes:");
+    console.error(`[LemonCake MCP]     1. Create a free account  →  ${REGISTER_URL}`);
+    console.error("[LemonCake MCP]     2. Top up balance ($5 USDC / JPYC supported)");
+    console.error("[LemonCake MCP]     3. Issue a Pay Token or copy Buyer JWT from Dashboard");
+    console.error("[LemonCake MCP]");
+    console.error("[LemonCake MCP]   Or call the `setup` tool from your MCP client for interactive guidance.");
+}
+// ── ヘルパー ──────────────────────────────────────────────────────────────────
+async function apiGet(path, auth) {
+    const res = await fetch(`${API_URL}${path}`, {
+        headers: {
+            "Content-Type": "application/json",
+            "User-Agent": USER_AGENT,
+            "X-LemonCake-Client": USER_AGENT,
+            ...(auth ? { Authorization: `Bearer ${auth}` } : {}),
+        },
+    });
+    const body = await res.json();
+    if (!res.ok)
+        throw new Error(`API ${res.status}: ${JSON.stringify(body)}`);
+    return body;
+}
+async function apiPost(path, data, auth, extraHeaders) {
+    const res = await fetch(`${API_URL}${path}`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "User-Agent": USER_AGENT,
+            "X-LemonCake-Client": USER_AGENT,
+            ...(auth ? { Authorization: `Bearer ${auth}` } : {}),
+            ...(extraHeaders ?? {}),
+        },
+        body: JSON.stringify(data),
+    });
+    const body = await res.json();
+    if (!res.ok)
+        throw new Error(`API ${res.status}: ${JSON.stringify(body)}`);
+    return body;
+}
+function json(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+}
+/**
+ * サービス名から呼び方ヒントを返す。
+ * エージェントが call_service で正しい path/method/body を即座に推測できるよう
+ * 既知の人気サービスについて推奨呼び出しを示す。
+ */
+function usageHintFor(name) {
+    const n = name.toLowerCase();
+    if (n.includes("serper"))
+        return { path: "/search", method: "POST", body: { q: "<query>", num: 5 }, description: "Google検索 (organic, news, images, knowledge graph)" };
+    if (n.includes("hunter"))
+        return { path: "/domain-search?domain=<domain>&limit=5", method: "GET", description: "ドメインから企業の連絡先メール一覧 (役職・信頼度付き)" };
+    if (n.includes("jina"))
+        return { path: "/?url=<url>", method: "GET", description: "Webページを LLM-ready Markdown に変換" };
+    if (n.includes("firecrawl"))
+        return { path: "/scrape", method: "POST", body: { url: "<url>" }, description: "JS実行ありのWebスクレイピング → Markdown" };
+    if (n.includes("ipinfo"))
+        return { path: "/<ip>", method: "GET", description: "IP geolocation・ISP・ASN・risk score" };
+    if (n.includes("exchange") || n.includes("為替"))
+        return { path: "/latest.json", method: "GET", description: "USD基準の170+通貨レート (1日1回更新)" };
+    if (n.includes("slack"))
+        return { path: "/chat.postMessage", method: "POST", body: { channel: "<id>", text: "<msg>" }, description: "Slackメッセージ送信、人間の判断仰ぎに最適" };
+    if (n.includes("gbiz") || n.includes("法人"))
+        return { path: "/hojin/<corporate_number>", method: "GET", description: "経産省 gBizINFO 法人情報 (法人番号13桁)" };
+    if (n.includes("インボイス") || n.includes("invoice"))
+        return { path: "/check?id=T<13桁>", method: "GET", description: "国税庁 適格請求書発行事業者番号の照合" };
+    if (n.includes("e-gov") || n.includes("法令"))
+        return { path: "/keyword?keyword=<語>", method: "GET", description: "日本の法律・政令・省令を全文検索" };
+    if (n.includes("vat") || n.includes("abstract"))
+        return { path: "/validate?vat_number=<vat>", method: "GET", description: "EU VAT番号有効性検証" };
+    if (n.includes("coze") || n.includes("test"))
+        return { path: "/anything", method: "POST", body: { test: "any" }, description: "Echoサーバ (リクエストをそのまま200で返す、デバッグ用)" };
+    return undefined;
+}
+/** 未設定の認証情報に対して、取得方法を含む分かりやすいエラーを返す */
+function credentialError(envVar, toolName) {
+    return {
+        content: [{
+                type: "text",
+                text: JSON.stringify({
+                    error: `${envVar} is not configured.`,
+                    code: "CREDENTIAL_MISSING",
+                    howToFix: [
+                        `1. Create a free account → ${REGISTER_URL}`,
+                        `2. Top up balance ($5 USDC or JPYC) → ${BILLING_URL}`,
+                        envVar === "LEMON_CAKE_PAY_TOKEN"
+                            ? `3. Dashboard → Tokens → Issue Pay Token (set your spending limit) → ${DASHBOARD_URL}`
+                            : `3. Dashboard → Settings → Copy your Buyer JWT → ${DASHBOARD_URL}`,
+                        `4. Add to your MCP client config:`,
+                        `   "env": { "${envVar}": "<paste token here>" }`,
+                        `5. Restart your MCP client`,
+                    ],
+                    docs: DOCS_URL,
+                    tip: `You can also call the 'setup' tool to see full setup instructions.`,
+                }, null, 2),
+            }],
+        isError: true,
+    };
+}
+// ── サーバー初期化 ────────────────────────────────────────────────────────────
+const SERVER_INSTRUCTIONS = DEMO_MODE
+    ? [
+        "🎮 DEMO MODE ACTIVE — no signup, no API key, no card required.",
+        "",
+        "You are connected with no credentials, so this server is in Demo Mode:",
+        "  • list_services      → marketplace listing + 3 free demo services",
+        "  • call_service(demo_search)  → real Wikipedia search",
+        "  • call_service(demo_fx)      → real live FX rates (open.er-api.com)",
+        "  • call_service(demo_echo)    → httpbin.org echo",
+        "  • check_balance      → mock $1.00 balance",
+        "  • check_tax / get_service_stats → real (no auth)",
+        "",
+        "👉 Quick start: try the `explore-demo` prompt above, or call `setup` for the full guide.",
+        "",
+        "To unlock paid services (Serper, Hunter.io, gBizINFO, NTA invoice check, etc.),",
+        "set LEMON_CAKE_PAY_TOKEN. Free signup at https://lemoncake.xyz/register.",
+    ].join("\n")
+    : [
+        "LemonCake MCP — Pay-per-call USDC payments for any HTTP API.",
+        "",
+        "Call `setup` first to verify credentials and list available paid services.",
+        "Use `list_services` to browse the marketplace, then `call_service` to invoke.",
+    ].join("\n");
+const server = new Server({ name: "pay-per-call-mcp", version: MCP_VERSION }, {
+    capabilities: { tools: {}, prompts: {}, logging: {} },
+    instructions: SERVER_INSTRUCTIONS,
+});
+// ── ツール定義 ────────────────────────────────────────────────────────────────
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        // ─── setup（認証不要） ────────────────────────────────────────────────
+        {
+            name: "setup",
+            description: [
+                "Show the LemonCake MCP first-run setup guide. No authentication required.",
+                "Call this tool FIRST to learn what credentials are missing and how to obtain them.",
+                "",
+                "If no auth env vars are set, the server is in DEMO MODE: list_services returns",
+                "three demo services (demo_search / demo_echo / demo_fx) and call_service / check_balance",
+                "respond with mock data so you can verify integration before signing up.",
+                "",
+                "Returns the current credential status (Pay Token / Buyer JWT), demo-mode flag, and",
+                "step-by-step instructions to obtain anything that is missing, including a sample MCP",
+                "client config snippet ready to paste.",
+                "",
+                "Returns: { version, apiUrl, mode, credentials, availableTools, setupSteps, register, dashboard, docs }",
+                "Errors: none — this tool always succeeds.",
+            ].join("\n"),
+            annotations: {
+                title: "Setup guide",
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: false,
+            },
+            inputSchema: { type: "object", properties: {}, additionalProperties: false },
+        },
+        // ─── list_services（認証不要） ───────────────────────────────────────
+        {
+            name: "list_services",
+            description: [
+                "List approved API services available on the LemonCake marketplace. No authentication required.",
+                "",
+                "Use this BEFORE call_service to discover serviceId values and per-call USDC pricing.",
+                "",
+                "When LEMON_CAKE_PAY_TOKEN is missing, three demo services are prepended",
+                "(demo_search → Wikipedia, demo_echo → httpbin, demo_fx → open.er-api) so you",
+                "can try call_service without signing up. Live users (PAY_TOKEN set) see only",
+                "real marketplace entries; demo_* IDs remain callable directly.",
+                "",
+                "Each item: { id, name, provider, type ('API' | 'MCP'), pricePerCall, [usage], [mode] }.",
+                "Errors: HTTP-level errors are returned as `Error: API <status>: <body>`.",
+            ].join("\n"),
+            annotations: {
+                title: "List marketplace services",
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+            inputSchema: {
+                type: "object",
+                additionalProperties: false,
+                properties: {
+                    limit: {
+                        type: "integer",
+                        minimum: 1,
+                        maximum: 100,
+                        default: 50,
+                        description: "Maximum number of services to return (default 50, max 100).",
+                    },
+                },
+            },
+        },
+        // ─── call_service（PAY_TOKEN 必須 / demo_* は不要） ─────────────────
+        {
+            name: "call_service",
+            description: [
+                "Invoke an upstream API service through LemonCake's pay-per-call proxy.",
+                "Each successful call automatically charges USDC against your configured Pay Token.",
+                "",
+                "PRECONDITIONS:",
+                "  • LEMON_CAKE_PAY_TOKEN env var must be set for real services. If missing, the tool",
+                "    returns a structured CREDENTIAL_MISSING error with how-to-fix steps.",
+                "  • DEMO MODE: serviceId values starting with `demo_` (demo_search / demo_echo / demo_fx)",
+                "    work WITHOUT any auth and return canned responses — useful for Glama Inspector",
+                "    or new-user trial. They are clearly marked with `mode: \"demo\"` and incur no charge.",
+                "  • serviceId must come from list_services.",
+                "",
+                "BEHAVIOR:",
+                "  • Returns the upstream response body verbatim (JSON or text), plus the X-Charge-Id",
+                "    and X-Amount-Usdc headers reported by the proxy.",
+                "  • HTTP 402 Payment Required is returned as a normal result (NOT thrown) so the",
+                "    agent can autonomously stop spending when the Pay Token's limitUsdc is exhausted.",
+                "  • Pass the same idempotencyKey to retry safely without double-charging.",
+                "  • This tool spends real money and contacts an external service — it is",
+                "    non-idempotent by default and has external side effects.",
+                "",
+                "Returns: { status, chargeId, amountUsdc, response }",
+            ].join("\n"),
+            annotations: {
+                title: "Call a paid service (charges USDC)",
+                readOnlyHint: false,
+                destructiveHint: false,
+                idempotentHint: false,
+                openWorldHint: true,
+            },
+            inputSchema: {
+                type: "object",
+                required: ["serviceId"],
+                additionalProperties: false,
+                properties: {
+                    serviceId: {
+                        type: "string",
+                        description: "ID of the service to call (obtain from list_services).",
+                        minLength: 1,
+                    },
+                    path: {
+                        type: "string",
+                        description: "Sub-path on the service (e.g. \"/search\", \"/v1/completions\"). Defaults to \"/\".",
+                        default: "/",
+                        pattern: "^/.*",
+                    },
+                    method: {
+                        type: "string",
+                        enum: ["GET", "POST", "PUT", "PATCH", "DELETE"],
+                        description: "HTTP method to use against the service. Defaults to GET.",
+                        default: "GET",
+                    },
+                    body: {
+                        type: "object",
+                        description: "JSON request body (only used for POST/PUT/PATCH).",
+                        additionalProperties: true,
+                    },
+                    idempotencyKey: {
+                        type: "string",
+                        description: "Optional idempotency key (UUID recommended). Identical keys within the proxy's retention window return the cached result without re-charging.",
+                        format: "uuid",
+                    },
+                },
+            },
+        },
+        // ─── check_balance（BUYER_JWT 必須 / DEMO_MODE 時は mock） ───────────
+        {
+            name: "check_balance",
+            description: [
+                "Check the current USDC balance, KYC tier, and account info of the configured buyer.",
+                "",
+                "PRECONDITIONS:",
+                "  • LEMON_CAKE_BUYER_JWT env var must be set. If missing AND no PAY_TOKEN is set,",
+                "    DEMO MODE returns a canned $1.00 demo balance with kycTier=\"DEMO\" so trial users",
+                "    see something instead of an error. With PAY_TOKEN set but no BUYER_JWT, returns",
+                "    a structured CREDENTIAL_MISSING error.",
+                "",
+                "Use BEFORE call_service to confirm sufficient funds, especially before a long batch.",
+                "",
+                "Returns: { balanceUsdc, kycTier, email, name, [mode], [note] }",
+            ].join("\n"),
+            annotations: {
+                title: "Check USDC balance",
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+            inputSchema: { type: "object", properties: {}, additionalProperties: false },
+        },
+        // ─── check_tax（認証不要） ───────────────────────────────────────────
+        {
+            name: "check_tax",
+            description: [
+                "Run a Japanese tax compliance check on a single transaction. No authentication required.",
+                "",
+                "Performs three checks in one call:",
+                "  1. Validates the qualified-invoice registration number (T-number) against the NTA registry.",
+                "  2. Determines whether source-withholding (源泉徴収) applies based on the service description.",
+                "  3. If withholding applies, computes the withholding amount and net payable.",
+                "",
+                "Intended for Japanese corporations that pay AI / API services and need to file",
+                "withholding correctly under the qualified-invoice (インボイス制度) regime.",
+                "",
+                "Returns: { invoice: { valid, name, ... }, withholding: { required, rate, amount, net } }",
+                "Errors: invalid registrationNumber returns invoice.valid = false (not an exception).",
+            ].join("\n"),
+            annotations: {
+                title: "Japanese tax compliance check",
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+            inputSchema: {
+                type: "object",
+                required: ["registrationNumber", "serviceDescription", "grossAmountJpy"],
+                additionalProperties: false,
+                properties: {
+                    registrationNumber: {
+                        type: "string",
+                        description: "Qualified-invoice registration number issued by the Japanese NTA (e.g. \"T1234567890123\").",
+                        pattern: "^T?\\d{13}$",
+                    },
+                    serviceDescription: {
+                        type: "string",
+                        description: "Plain-text description of what was purchased. Used to classify whether source-withholding applies.",
+                        minLength: 1,
+                    },
+                    grossAmountJpy: {
+                        type: "number",
+                        description: "Gross transaction amount in JPY, tax inclusive.",
+                        exclusiveMinimum: 0,
+                    },
+                },
+            },
+        },
+        // ─── get_service_stats（認証不要） ───────────────────────────────────
+        {
+            name: "get_service_stats",
+            description: [
+                "Return public usage statistics for every approved service on the marketplace. No authentication required.",
+                "",
+                "Use this AFTER list_services and BEFORE call_service to pick a service based on",
+                "real-world traction (call counts, USDC revenue, last-used timestamp).",
+                "",
+                "Returns: an array of { serviceId, callCount, totalRevenueUsdc, lastCalledAt }.",
+            ].join("\n"),
+            annotations: {
+                title: "Marketplace usage stats",
+                readOnlyHint: true,
+                destructiveHint: false,
+                idempotentHint: true,
+                openWorldHint: true,
+            },
+            inputSchema: { type: "object", properties: {}, additionalProperties: false },
+        },
+    ],
+}));
+// ── プロンプト定義 ────────────────────────────────────────────────────────────
+// MCP Prompts: Glama Inspector / Claude Desktop / Cursor の prompt-picker に
+// 「Try this」ボタンとして表示される pre-written conversation starters。
+// Demo Mode（auth 不要）でもすぐ動くものを優先しているので、新規ユーザーが
+// click 1 つで実プロダクトの挙動を確認できる。
+const PROMPTS = [
+    {
+        name: "explore-demo",
+        title: "🎮 Try the demo (no signup)",
+        description: "Walk through demo_search → demo_fx → demo_echo with no auth required.",
+        template: [
+            "Use the LemonCake MCP server (pay-per-call-mcp) in demo mode (no auth needed) to:",
+            "1. Run `setup` to confirm we're in demo mode.",
+            "2. Run `list_services` and tell me which entries are demos.",
+            "3. Call `call_service` with serviceId='demo_search' and body={\"q\":\"Model Context Protocol\"} — show me the Wikipedia results.",
+            "4. Call `call_service` with serviceId='demo_fx' and report current USD/JPY.",
+            "Then summarize what LemonCake is, in 2 sentences.",
+        ].join("\n"),
+    },
+    {
+        name: "discover-marketplace",
+        title: "🛍 Discover marketplace services",
+        description: "List approved services and pick one that matches a use case.",
+        template: [
+            "Using this server's `list_services` tool, list every approved service with its category and price.",
+            "Then recommend the top 3 for an AI agent that needs to: (a) find recent news, (b) verify a Japanese invoice number, (c) translate text.",
+            "For each recommendation, show the exact `call_service` arguments to invoke it.",
+        ].join("\n"),
+    },
+    {
+        name: "japan-tax-check",
+        title: "🇯🇵 Validate a Japanese invoice number",
+        description: "Use the check_tax tool to verify a 適格請求書発行事業者番号 against the NTA registry.",
+        arguments: [
+            { name: "registrationNumber", description: "T + 13 digit number. Leave empty to use a sample (T1234567890123).", required: false },
+            { name: "amountJpy", description: "Gross amount in JPY. Defaults to 110000.", required: false },
+        ],
+        template: (args) => [
+            `Use the \`check_tax\` tool to validate registration number ${args.registrationNumber ?? "T1234567890123"}.`,
+            args.amountJpy ? `The transaction amount is ${args.amountJpy} JPY (tax-inclusive).` : "Use a sample amount of 110000 JPY.",
+            "Report: (1) is the number valid? (2) registered name and address. (3) does source-withholding (源泉徴収) apply, and how much?",
+        ].join("\n"),
+    },
+    {
+        name: "spend-with-budget",
+        title: "💰 Spend with a strict budget cap",
+        description: "Pattern: check_balance → call_service → check_balance again, demonstrating KYA/Pay-Token spending limits.",
+        arguments: [
+            { name: "serviceId", description: "Marketplace service ID (omit for demo_search)", required: false },
+            { name: "query", description: "Search query (for search/data services)", required: false },
+        ],
+        template: (args) => {
+            const sid = args.serviceId ?? "demo_search";
+            const q = args.query ?? "AI agent payments 2026";
+            return [
+                `Demonstrate the LemonCake spending pattern with serviceId=\`${sid}\`:`,
+                "1. Call `check_balance` and report current USDC balance + KYA tier.",
+                `2. Call \`call_service\` with serviceId='${sid}', method='POST', path='/search', body={\"q\":\"${q}\"}.`,
+                "3. Call `check_balance` again and report the delta. If we're in demo mode, note that no real charge happened.",
+                "Throughout, mention any 4xx hints the proxy returns so I learn the failure modes.",
+            ].join("\n");
+        },
+    },
+    {
+        name: "real-vs-demo",
+        title: "🔄 Compare demo vs real upstream",
+        description: "Hit the same logical query against demo_search (Wikipedia) and a real marketplace search service to see the difference.",
+        template: [
+            "Compare LemonCake's demo vs real search:",
+            "1. Call `call_service` with serviceId='demo_search', body={\"q\":\"Model Context Protocol\"}. Note the Wikipedia results.",
+            "2. From `list_services`, find a real Serper / search service (category='検索') and call it with the same query.",
+            "3. Tabulate: result count, top result title, latency feel (you'll see chargeId only for the real one).",
+            "If LEMON_CAKE_PAY_TOKEN isn't set, gracefully skip step 2 and explain how to set it.",
+        ].join("\n"),
+    },
+    {
+        name: "japan-finance-bundle",
+        title: "🏯 Japan finance research bundle",
+        description: "Combine gBizINFO 法人情報 + 国税庁 invoice check + e-Gov 法令 in one workflow.",
+        arguments: [
+            { name: "corporateNumber", description: "13-digit corporate number (法人番号)", required: false },
+        ],
+        template: (args) => {
+            const cn = args.corporateNumber ?? "3010001088782";
+            return [
+                `Run a Japan finance research workflow with 法人番号 ${cn}:`,
+                "1. `list_services` — confirm gBizINFO / 国税庁インボイス / e-Gov are available (category='日本特化').",
+                `2. Call gBizINFO with path='/hojin/${cn}'. Report company name, address, capital, representative.`,
+                `3. Call 国税庁インボイス with path='/check?id=T${cn}'. Verify if this corp is a registered invoice issuer.`,
+                "4. Call e-Gov with keyword='インボイス制度'. Find 1-2 relevant law articles.",
+                "Summarize all findings in a single executive briefing.",
+            ].join("\n");
+        },
+    },
+];
+server.setRequestHandler(ListPromptsRequestSchema, async () => ({
+    prompts: PROMPTS.map((p) => ({
+        name: p.name,
+        title: p.title,
+        description: p.description,
+        arguments: "arguments" in p ? p.arguments : undefined,
+    })),
+}));
+server.setRequestHandler(GetPromptRequestSchema, async (req) => {
+    const name = req.params.name;
+    const args = (req.params.arguments ?? {});
+    const prompt = PROMPTS.find((p) => p.name === name);
+    if (!prompt) {
+        throw new Error(`Unknown prompt: ${name}`);
+    }
+    const text = typeof prompt.template === "function"
+        ? prompt.template(args)
+        : prompt.template;
+    return {
+        description: prompt.description,
+        messages: [
+            {
+                role: "user",
+                content: { type: "text", text },
+            },
+        ],
+    };
+});
+// ── ツール実装 ────────────────────────────────────────────────────────────────
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+    const { name, arguments: args = {} } = req.params;
+    try {
+        switch (name) {
+            // ─── setup ──────────────────────────────────────────────────────────
+            case "setup": {
+                const status = {
+                    payToken: hasPayToken ? "✓ 設定済み" : "✗ 未設定（call_service が使えません）",
+                    buyerJwt: hasBuyerJwt ? "✓ 設定済み" : "✗ 未設定（check_balance が使えません）",
+                };
+                const steps = [];
+                if (!hasPayToken || !hasBuyerJwt) {
+                    steps.push("=== セットアップ手順 ===");
+                    steps.push("");
+                    steps.push("1. 無料アカウント作成（3分で完了）");
+                    steps.push(`   → ${REGISTER_URL}`);
+                    steps.push("");
+                    steps.push("2. USDC残高をチャージ（$5〜）");
+                    steps.push(`   → ${BILLING_URL}`);
+                    steps.push("   JPYCまたはUSDCで入金可能");
+                    steps.push("");
+                }
+                if (!hasPayToken) {
+                    steps.push("3. Pay Tokenを発行（call_service に必要）");
+                    steps.push("   Dashboard → Tokens → 「Pay Tokenを発行」");
+                    steps.push("   ・serviceId: 使いたいサービスのIDを選択");
+                    steps.push("   ・limitUsdc: このトークンで使える上限額（例: 5.00）");
+                    steps.push("   → 発行されたJWTをコピー");
+                    steps.push("");
+                    steps.push("4. MCP設定ファイルに追加:");
+                    steps.push('   "LEMON_CAKE_PAY_TOKEN": "<コピーしたJWT>"');
+                    steps.push("");
+                }
+                if (!hasBuyerJwt) {
+                    steps.push(!hasPayToken ? "5." : "3." + " Buyer JWTを取得（check_balance に必要）");
+                    steps.push("   Dashboard → Settings → 「Buyer JWTをコピー」");
+                    steps.push('   "LEMON_CAKE_BUYER_JWT": "<コピーしたJWT>"');
+                    steps.push("");
+                }
+                steps.push("=== MCP設定ファイルのサンプル ===");
+                steps.push("");
+                steps.push(JSON.stringify({
+                    mcpServers: {
+                        "pay-per-call": {
+                            command: "npx",
+                            args: ["-y", "pay-per-call-mcp"],
+                            env: {
+                                LEMON_CAKE_PAY_TOKEN: hasPayToken ? "(設定済み)" : "<ダッシュボードで発行したPay Token JWT>",
+                                LEMON_CAKE_BUYER_JWT: hasBuyerJwt ? "(設定済み)" : "<ダッシュボードのSettingsからコピーしたJWT>",
+                            },
+                        },
+                    },
+                }, null, 2));
+                steps.push("");
+                steps.push("※ 旧パッケージ名 `lemon-cake-mcp` も同じく動作します（ラッパーとして維持中）。");
+                return json({
+                    version: MCP_VERSION,
+                    apiUrl: API_URL,
+                    mode: DEMO_MODE ? "demo" : "live",
+                    credentials: status,
+                    availableTools: DEMO_MODE
+                        ? {
+                            noAuth: ["setup", "list_services", "get_service_stats", "check_tax", "check_balance (mock)", "call_service (demo_* only)"],
+                            demoServices: DEMO_SERVICES.map((d) => d.id),
+                            upgradeHint: "Set LEMON_CAKE_PAY_TOKEN to call real services; set LEMON_CAKE_BUYER_JWT for real balance.",
+                        }
+                        : {
+                            noAuth: ["setup", "list_services", "get_service_stats", "check_tax"],
+                            needPayToken: ["call_service"],
+                            needBuyerJwt: ["check_balance"],
+                        },
+                    setupSteps: steps.length > 0 ? steps.join("\n") : "✅ 全ての認証情報が設定されています。",
+                    register: REGISTER_URL,
+                    dashboard: DASHBOARD_URL,
+                    docs: "https://github.com/evidai/lemon-cake",
+                });
+            }
+            // ─── list_services ───────────────────────────────────────────────────
+            case "list_services": {
+                const limit = args.limit ?? 50;
+                const services = await apiGet(`/api/services?reviewStatus=APPROVED&limit=${limit}`);
+                const real = services
+                    .filter((s) => s.verified)
+                    .map((s) => ({
+                    id: s.id,
+                    name: s.name,
+                    provider: s.providerName,
+                    type: s.type,
+                    pricePerCall: `${s.pricePerCallUsdc} USDC`,
+                    usage: usageHintFor(s.name),
+                }));
+                // Surface demo services whenever PAY_TOKEN is missing (covers full
+                // DEMO_MODE and the partial-auth case where only BUYER_JWT is set).
+                // Live users with PAY_TOKEN see only real services to avoid clutter,
+                // but can still call demo_* serviceIds directly.
+                if (!PAY_TOKEN) {
+                    const demos = DEMO_SERVICES.map((d) => ({
+                        id: d.id,
+                        name: d.name,
+                        provider: d.provider,
+                        type: d.type,
+                        pricePerCall: d.pricePerCall,
+                        description: d.description,
+                        usage: d.example,
+                        mode: "demo",
+                    }));
+                    return json([...demos, ...real]);
+                }
+                return json(real);
+            }
+            // ─── call_service ────────────────────────────────────────────────────
+            case "call_service": {
+                const serviceId = args.serviceId;
+                const subPath = args.path ?? "/";
+                const method = args.method ?? "GET";
+                const body = args.body;
+                const idempotencyKey = args.idempotencyKey;
+                const normalizedPath = subPath.startsWith("/") ? subPath : `/${subPath}`;
+                // Demo mode: handle demo_* services without auth so Glama Inspector
+                // and new users can verify the call shape before signing up.
+                const demoSvc = findDemoService(serviceId);
+                if (demoSvc) {
+                    return json({
+                        status: 200,
+                        chargeId: `demo_${Date.now().toString(36)}`,
+                        amountUsdc: demoSvc.pricePerCall.split(" ")[0],
+                        response: await demoSvc.handler(normalizedPath, body),
+                        mode: "demo",
+                        note: DEMO_NOTICE,
+                    });
+                }
+                if (!PAY_TOKEN)
+                    return credentialError("LEMON_CAKE_PAY_TOKEN", "call_service");
+                const url = `${API_URL}/api/proxy/${serviceId}${normalizedPath}`;
+                const headers = {
+                    "Content-Type": "application/json",
+                    "Authorization": `Bearer ${PAY_TOKEN}`,
+                    "User-Agent": USER_AGENT,
+                    "X-LemonCake-Client": USER_AGENT,
+                };
+                if (idempotencyKey)
+                    headers["Idempotency-Key"] = idempotencyKey;
+                const fetchOptions = { method, headers };
+                if (body && ["POST", "PUT", "PATCH"].includes(method)) {
+                    fetchOptions.body = JSON.stringify(body);
+                }
+                const res = await fetch(url, fetchOptions);
+                const chargeId = res.headers.get("X-Charge-Id");
+                const amountUsdc = res.headers.get("X-Amount-Usdc");
+                let responseBody;
+                if ((res.headers.get("content-type") ?? "").includes("application/json")) {
+                    responseBody = await res.json();
+                }
+                else {
+                    responseBody = await res.text();
+                }
+                // 402 の場合もエラーではなく構造化レスポンスとして返す
+                // （エージェントが自律的に停止判断できるように）
+                const result = { status: res.status, chargeId, amountUsdc, response: responseBody };
+                // よくある 4xx に対するエージェント向けヒントを付与
+                if (res.status >= 400) {
+                    let hint;
+                    const bodyStr = typeof responseBody === "string" ? responseBody : JSON.stringify(responseBody ?? "");
+                    if (res.status === 401)
+                        hint = "Upstream authentication failed. The service's API key may be invalid or expired. Try a different service.";
+                    else if (res.status === 402)
+                        hint = "Pay Token limit exhausted or buyer balance insufficient. Stop further calls and notify the user to top up.";
+                    else if (res.status === 403)
+                        hint = "Forbidden. Token scope may not match this serviceId, or service is not approved.";
+                    else if (res.status === 404)
+                        hint = "Path not found on upstream. Re-check the `path` argument — common shapes vary by service.";
+                    else if (res.status === 422 && bodyStr.includes("service_uneconomical"))
+                        hint = "This service is below the platform's minimum revenue floor. Cannot be called regardless of buyer balance.";
+                    else if (res.status === 429)
+                        hint = "Upstream rate-limited. Retry after backoff or pick a different service.";
+                    else if (res.status === 501)
+                        hint = "Service has no proxy endpoint configured. Pick a different service from list_services.";
+                    else if (res.status >= 500)
+                        hint = "Upstream server error. Retry once with the same idempotencyKey, then escalate or switch service.";
+                    if (hint)
+                        result.hint = hint;
+                }
+                return json(result);
+            }
+            // ─── check_balance ───────────────────────────────────────────────────
+            case "check_balance": {
+                if (!BUYER_JWT) {
+                    if (DEMO_MODE)
+                        return json({
+                            balanceUsdc: "1.00",
+                            kycTier: "DEMO",
+                            email: "demo@lemoncake.xyz",
+                            name: "Demo Buyer",
+                            mode: "demo",
+                            note: DEMO_NOTICE,
+                        });
+                    return credentialError("LEMON_CAKE_BUYER_JWT", "check_balance");
+                }
+                const me = await apiGet("/api/auth/me", BUYER_JWT);
+                return json({
+                    balanceUsdc: me.buyer?.balanceUsdc ?? me.balanceUsdc,
+                    kycTier: me.buyer?.kycTier ?? me.kycTier,
+                    email: me.email,
+                    name: me.name,
+                });
+            }
+            // ─── check_tax ───────────────────────────────────────────────────────
+            case "check_tax": {
+                const result = await apiPost("/api/tax/full-check", {
+                    registrationNumber: args.registrationNumber,
+                    serviceDescription: args.serviceDescription,
+                    grossAmountJpy: args.grossAmountJpy,
+                });
+                return json(result);
+            }
+            // ─── get_service_stats ───────────────────────────────────────────────
+            case "get_service_stats": {
+                const stats = await apiGet("/api/services/stats");
+                return json(stats);
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            content: [{ type: "text", text: `Error: ${msg}` }],
+            isError: true,
+        };
+    }
+});
+// ── 起動 ──────────────────────────────────────────────────────────────────────
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("[LemonCake MCP] Ready.");
+    // 接続直後に Inspector の Request Log にバナーを出す。
+    // Glama UI の env-var ダイアログを抜けて Inspector まで来た人に
+    // 「空のまま動いてる、Demo Mode だよ」を即座に伝えるのが目的。
+    try {
+        await server.notification({
+            method: "notifications/message",
+            params: {
+                level: "info",
+                logger: "pay-per-call-mcp",
+                data: DEMO_MODE
+                    ? "🎮 DEMO MODE — connected without credentials. Try the `explore-demo` prompt or call `setup` for guided onboarding. No signup needed."
+                    : `LemonCake MCP v${MCP_VERSION} ready. Run \`setup\` to verify credentials and \`list_services\` to browse paid APIs.`,
+            },
+        });
+    }
+    catch {
+        // Older clients may not accept notifications before initialize completes.
+        // The console.error banners above already cover stdio-only environments.
+    }
+}
+main().catch((err) => {
+    console.error("[LemonCake MCP] Fatal:", err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "pay-per-call-mcp",
+  "version": "0.5.0",
+  "description": "Pay-per-call USDC payments for any HTTP API. Give your AI agent a wallet — M2M finance, agent payments, Japan tax invoice check. (formerly lemon-cake-mcp)",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "pay-per-call-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai-agent",
+    "agent-wallet",
+    "payment",
+    "pay-per-call",
+    "usdc",
+    "stablecoin",
+    "crypto",
+    "wallet",
+    "m2m",
+    "api-proxy",
+    "api-gateway",
+    "finance",
+    "japan-tax",
+    "invoice",
+    "autonomous-agent",
+    "llm",
+    "claude",
+    "cursor"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/evidai/lemon-cake.git"
+  },
+  "homepage": "https://lemoncake.xyz",
+  "bugs": {
+    "url": "https://github.com/evidai/lemon-cake/issues"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.10.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}