🍋 LemonCake — AI 에이전트 지갑 & USDC 호출당 결제 MCP 서버

🎮 즉시 체험 — 가입 불필요. 위 **"Try in Browser"**를 클릭 → 두 개의 환경 변수 필드를 비워두고 → Start Inspector를 클릭하세요. 데모 모드는 실제 Wikipedia / httpbin / 라이브 FX API를 호출합니다. 계정, 카드, API 키가 필요 없습니다.

📦 v0.5.0 이름 변경: npm 패키지 이름이 **pay-per-call-mcp**로 변경되었습니다(기존 lemon-cake-mcp). 이전 이름도 씬 래퍼(thin wrapper)로 작동하지만, 새로운 설정에는 npx -y pay-per-call-mcp를 사용해야 합니다.

AI 에이전트에게 지갑을 부여하세요. Claude Desktop, Cursor, Cline 또는 모든 MCP 클라이언트에서 직접 모든 HTTP API에 대해 USDC로 호출당 결제를 수행하세요. 인간의 개입이나 API별 가입, API 키 관리의 번거로움이 없습니다.

LemonCake MCP 서버를 사용하면 Claude Desktop / Cursor / Cline 등 MCP 호환 클라이언트에서 인간의 개입 없이 USDC로 유료 API를 호출할 수 있습니다.

English ↓ Quickstart · Tools · Use Cases · Compatibility

🚀 3분으로 시작하기

MCP 서버를 사용하려면 LemonCake 계정과 USDC 잔액이 필요합니다.

1. 무료 계정 생성 — 이메일 하나로 완료

2. 잔액 충전 — 최소 $5 USDC 또는 JPYC (Billing)

3. Buyer JWT 복사 — Dashboard → API Keys에서 확인

4. 아래 claude_desktop_config.json에 설정

📚 상세 정보: 퀵스타트 문서

Related MCP server: BotWallet MCP Server

📦 설치

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", "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 이상

🛠️ 제공 도구

모든 인수 스키마는 MCP Inspector 또는 tools/list를 통해 확인할 수 있습니다.

🎮 데모 모드(인증 정보 없이 체험)

LEMON_CAKE_BUYER_JWT / LEMON_CAKE_PAY_TOKEN을 설정하지 않고 실행하면 자동으로 데모 모드가 됩니다. 가입 없이 다음 기능을 사용할 수 있습니다:

• 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을 설정하세요.

💡 프롬프트 활용 (MCP 프롬프트)

이 서버는 MCP의 프롬프트 기능을 지원합니다. Glama Inspector / Claude Desktop / Cursor의 "프롬프트 선택기"에 아래 프리셋이 표시되며 클릭 한 번으로 실행할 수 있습니다:

→ 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으로 설정 상태 확인(최초 1회)

2. call_service(serviceId="demo_agent_search_api", limitUsdc="0.50", body={query:"AI agent payments"}) 호출

3. 결과를 요약하여 답변

🎯 Use Cases

• 자율 리서치 에이전트 — 신용카드 정보를 제공하지 않고도 프리미엄 검색, 스크래핑 또는 데이터 API를 호출당 결제 방식으로 이용하게 하세요.

• 멀티 API 워크플로우 — 하나의 JWT, 하나의 잔액으로 수십 개의 업스트림 API를 이용하세요. 공급업체별 가입이나 키 교체가 필요 없습니다.

• 규정 준수 지출 — KYA(Know-Your-Agent) 한도를 통해 에이전트가 세션/일별로 사용할 수 있는 금액을 제한합니다.

• 일본 세금 자동화 — check_tax는 인보이스 규정 준수를 위해 국세청 API를 통해 적격 청구서 번호를 검증합니다.

• 멱등성 재시도 — idempotencyKey를 사용하여 중복 결제 없이 안전하게 call_service를 재시도할 수 있습니다.

✅ 테스트된 클라이언트

🔐 환경 변수

🏃 로컬 개발

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 pay-per-call-mcp .
docker run --rm -i -e LEMON_CAKE_BUYER_JWT=eyJhbGci... pay-per-call-mcp

이미지는 Glama Inspector의 브라우저 내 미리보기에도 사용됩니다.

🔗 관련 링크

• LemonCake 대시보드

• API 문서

• Glama MCP 목록

• Model Context Protocol

• GitHub

• 보안 정책 · 기여 방법 · 행동 강령

📄 라이선스

MIT © LemonCake