402-mcp

Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

AI 에이전트에게 경제적 주체성을 부여하는 L402 + x402 클라이언트 MCP입니다. 인간의 등록, API 키, 중개자 없이 결제 게이트가 설정된 모든 API를 발견하고, 결제하며, 소비하세요.

• 발견: Nostr에서 유료 API 발견 — 사전에 URL 필요 없음

• 자동 결제: 라이트닝(NWC), Cashu ecash 또는 인간 QR 폴백을 통한 자동 결제

• 자격 증명 캐싱 및 암호화: 저장 시 암호화 (AES-256-GCM)

• 모든 L402 서버와 호환: toll-booth, Aperture 또는 향후 구현될 모든 서버와 작동

빠른 시작

1. 설치

npx 402-mcp

2. Claude Code에 연결

claude mcp add 402-mcp -- npx 402-mcp

3. 사용해 보기

Claude에게 다음과 같이 질문하세요: "l402-search를 사용하여 유료 농담 API를 검색해 줘" — 지갑이 필요 없으며, 발견만 수행합니다.

유료 호출을 수행할 준비가 되셨나요? 전체 빠른 시작 가이드를 참조하여 지갑을 설정하고 에이전트가 첫 번째 API 호출을 결제하는 과정을 확인하세요.

Related MCP server: ag402-mcp

작동 원리

graph LR
    A["1. l402-config()"] --> B["2. l402-discover(url)"]
    B --> C["3. Agent reasons<br/>about pricing"]
    C --> D["4. l402-buy-credits()<br/>or l402-fetch()"]
    D --> E["5. l402-fetch(url)<br/>with credentials"]
    E --> F["6. Data returned<br/>+ balance cached"]

예시 세션:

Agent: "I need routing data from routing.trotters.cc"

1. l402-config()
   -> nwcConfigured: true, maxAutoPaySats: 1000

2. l402-discover("https://routing.trotters.cc/api/route")
   -> 10 sats/request, toll-booth detected, tiers available

3. Agent reasons: "I need ~20 requests. The 500-sat tier
   gives 555 credits. Better value."

4. l402-buy-credits(url, amountSats=500)
   -> Paid 500 sats, received 555 credits

5. l402-fetch("https://routing.trotters.cc/api/route?from=...&to=...")
   -> 200 OK, route data, 545 credits remaining

상세한 아키텍처 및 결제 흐름 다이어그램은 docs/architecture.md를 참조하세요.

구성

전송 선택 및 폴백

kind 31402 이벤트가 여러 URL(전송당 하나)을 광고할 때, 402-mcp는 구성에 따라 최적의 URL을 선택합니다:

1. 선호도 우선 — TRANSPORT_PREFERENCE=tor이고 .onion URL을 사용할 수 있는 경우, 이를 먼저 시도합니다.

2. 가용성 폴백 — 선호하는 전송에 도달할 수 없는 경우(프록시 미구성, 타임아웃), 클라이언트는 목록의 다음 URL로 폴백합니다.

3. Clearnet 기본값 — 선호도가 설정되지 않은 경우, .onion 또는 HNS 항목보다 Clearnet URL을 먼저 시도합니다.

서비스는 서로 다른 전송에서 동일한 서비스(동일한 가격, 동일한 마카룬 키)에 대해 여러 엔드포인트를 발표할 수 있습니다. 이는 순전히 검열 저항을 위한 것이며, 전송을 전환할 때 다시 인증할 필요가 없습니다. Tor 또는 HNS 엔드포인트에 도달하려면 위의 해당 프록시/게이트웨이 환경 변수를 구성해야 합니다.

도구

핵심 L402 (모든 서버)

toll-booth 확장

결제 방법

우선순위에 따라 시도되는 세 가지 결제 레일:

1. NWC (Nostr Wallet Connect) — 완전 자율; 연결된 지갑에서 결제

2. Cashu — 완전 자율; ecash 토큰을 녹여 인보이스 결제

3. 인간 개입 — QR 코드를 제시하고 결제 완료 대기

에이전트는 호출별로 방법을 재정의할 수 있으며, 원하는 방법만 구성할 수도 있습니다.

l402-fetch는 네 가지 HTTP 402 챌린지 변형을 투명하게 처리합니다:

안전성

MAX_AUTO_PAY_SATS는 모든 단일 자율 결제에 대한 상한선을 설정합니다. 이 제한을 초과하면 에이전트는 인간에게 승인을 요청해야 합니다. 에이전트는 l402-config를 통해 이 제한을 읽고 구매 결정에 반영할 수 있습니다.

개인정보 보호

402-mcp는 자격 증명을 로컬 머신에만 저장합니다 (~/.402-mcp/credentials.json, 저장 시 암호화). 제3자에게 데이터가 전송되지 않습니다. 계정, 추적, 분석이 없습니다. 결제는 설계상 가명인 라이트닝 또는 Cashu를 사용합니다.

생태계

결제 게이트가 설정된 API를 위한 탈중앙화 마켓플레이스인 402.pub에서 실시간 L402 서비스를 찾아보세요.

402-mcp는 Lightning Labs의 lightning-agent-tools 및 Coinbase의 x402에 대한 결제 레일 독립적 대안입니다. 라이트닝 노드가 필요 없으며, 다중 지갑과 암호화된 자격 증명을 지원합니다.

에이전트가 자신의 라이트닝 노드를 실행하기를 원한다면 Lightning Labs의 도구를 사용하세요. 에이전트가 인프라 없이 모든 지갑에서 결제하기를 원한다면 402-mcp를 사용하세요.

개발 설정 및 가이드라인은 CONTRIBUTING.md를 참조하세요.

@forgesworn 제작.

• 라이트닝 팁: thedonkey@strike.me

• Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

ForgeSworn 툴킷의 일부

ForgeSworn은 Nostr을 위한 오픈 소스 암호화 ID, 결제 및 조정 도구를 구축합니다.

라이선스

MIT