x402-buyer-mcp

x402 경제를 위한 범용 구매자 에이전트.

Claude Desktop, Cursor 및 Claude Code 사용자가 모든 x402 엔드포인트를 자동으로 검색, 결제 및 호출할 수 있게 해주는 MCP 서버입니다. Claude에게 질문하면 USDC로 답변 비용을 지불합니다.

지갑도, 암호화폐 지식도, API 키도 필요 없습니다. 오직 질문과 답변만 존재합니다.

기능

x402 프로토콜을 사용하면 AI 에이전트가 USDC로 API 호출 비용을 지불할 수 있습니다. 하지만 지금까지 생태계의 대부분 도구는 결제를 수락하는 판매자 엔드포인트였습니다. 이 도구는 비용을 지불하는 구매자 에이전트입니다.

Claude에게 "stripe.com은 안전한가요?"라고 물으면 이 MCP는 다음과 같이 작동합니다:

적절한 x402 엔드포인트(Domain Shield — VirusTotal + DNS 보안)를 검색합니다.
AgentCash 지갑을 통해 Base 네트워크에서 0.12 USDC를 결제합니다.
전체 보안 점수 보고서를 Claude에게 반환합니다.
Claude가 답변을 자연스럽게 종합합니다.

지갑을 직접 다룰 필요도, 블록체인을 볼 필요도 없습니다. 프리미엄 데이터로 뒷받침되는 답변을 받기만 하면 됩니다.

설치

사전 요구 사항

AgentCash 지갑 충전 (1회성, 2분 소요):
```
npx agentcash install
```
안내에 따라 지갑을 생성하고 Base 네트워크의 USDC로 충전하세요. 5달러로 약 40회의 호출이 가능합니다.

Claude Desktop

claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "x402-buyer": {
      "command": "npx",
      "args": ["-y", "x402-buyer-mcp"]
    }
  }
}

Cursor

.cursor/mcp.json에 추가하세요:

{
  "mcpServers": {
    "x402-buyer": {
      "command": "npx",
      "args": ["-y", "x402-buyer-mcp"]
    }
  }
}

Claude Code

claude mcp add x402-buyer -- npx -y x402-buyer-mcp

도구

`x402_discover`

질문에 답변할 수 있는 x402 엔드포인트를 검색합니다.

"Find endpoints for domain security scanning"
"Search for company intelligence APIs"
"What x402 endpoints handle drug interactions?"

`x402_call`

자동 결제와 함께 모든 x402 엔드포인트를 호출합니다.

"Call https://www.alderpost.co/api/domain-shield?domain=stripe.com"
"Call https://www.alderpost.co/api/company-xray?domain=hubspot.com"

`x402_balance`

AgentCash 지갑 잔액을 확인합니다.

"What's my x402 balance?"
"How many calls can I afford?"

`x402_research` ⭐

핵심 기능. 다중 엔드포인트 병렬 조사. 도메인을 입력하면 3~5개의 엔드포인트를 동시에 호출하여 완전한 인텔리전스 정보를 반환합니다.

"Research stripe.com" → calls 5 endpoints (~$0.64):
  - Domain Shield (security scan)
  - Company X-Ray (firmographics)
  - Threat Pulse (threat intel)
  - Compliance Check (audit)
  - Prospect IQ (contact info)

"Research ibuprofen" → calls 1 endpoint (~$0.10):
  - Health Signal (FDA data + drug interactions)

"Research 123 Main St Milwaukee WI" → calls 1 endpoint (~$0.10):
  - Property Intel (demographics + amenities)

예산 관리: max_cost를 설정하여 연구 호출당 총 지출을 제한할 수 있습니다.

레지스트리 내 엔드포인트

내장된 레지스트리에는 유료 데이터 소스로 뒷받침되는 프리미엄 엔드포인트가 포함되어 있습니다:

엔드포인트	제공 내용	가격	프리미엄 소스
Domain Shield	DNS 보안 + 악성코드 검사	$0.12	VirusTotal (70개 이상 엔진)
Company X-Ray	기업 정보 + 기술 스택	$0.15	People Data Labs
Threat Pulse	IP/도메인 위협 인텔리전스	$0.10	VirusTotal + AbuseIPDB
Prospect IQ	영업 정보 + 이메일 연락처	$0.12	Hunter.io
Compliance Check	IT 규정 준수 감사	$0.15	Qualys SSL Labs
Health Signal	약물 정보 + 상호작용	$0.10	NIH RxNorm + FDA
Property Intel	위치 + 인구 통계	$0.10	US Census + OpenWeather
Sports Edge	경기 전 AI 분석	$0.12	The Odds API + Claude AI

모든 엔드포인트는 Alderpost Intelligence에서 제공합니다.

결제 작동 방식

You ask Claude a question
  → Claude calls x402_research or x402_call
    → This MCP calls AgentCash CLI
      → AgentCash signs a USDC payment on Base
        → The endpoint verifies + settles on-chain
          → Data returned to Claude
            → Claude answers your question

AgentCash를 한 번 충전하면 모든 x402 호출 시 해당 잔액에서 차감됩니다. 구독도, API 키도 없습니다. 사용한 만큼만 지불하세요.

예시 세션

You: "Tell me everything about hubspot.com"

Claude: I'll run a comprehensive research scan on hubspot.com.
[Calls x402_research with subject "hubspot.com"]

Results from 5 endpoints ($0.64 total):

Domain Shield: Security score 85/100. DMARC=reject, SPF=pass,
DKIM configured. VirusTotal: clean (0/94 engines flagged).

Company X-Ray: HubSpot, Inc. Founded 2006. 10,268 employees.
Computer Software. Cambridge, MA. Public company.
Tech: Cloudflare CDN, Google Workspace, Next.js.

Threat Pulse: Threat score 92/100. No blacklist hits.
AbuseIPDB: 0 reports. Clean reputation.

Compliance Check: SSL Labs grade A. 6/6 security headers.
DNSSEC not enabled. Cookie consent detected.

Prospect IQ: Prospect score 82/100 (hot). 5 verified email
contacts found via Hunter.io. Email pattern: {first}@hubspot.com.

가격

이 MCP 서버는 무료입니다. 호출하는 x402 엔드포인트에 대해서만 비용을 지불합니다. 일반적인 비용:

단일 엔드포인트 호출: $0.10 - $0.15
전체 도메인 조사 (5개 엔드포인트): 약 $0.64
건강/부동산/스포츠 쿼리: 약 $0.10

AgentCash 5달러로 약 40회의 개별 호출 또는 8회의 전체 조사 보고서를 이용할 수 있습니다.

존재 이유

x402 프로토콜은 에이전트가 자율적으로 데이터 비용을 지불하도록 설계되었습니다. 하지만 생태계에는 초기 문제(cold-start problem)가 있습니다. 판매자는 엔드포인트를 구축했지만, 이를 호출하는 구매자가 충분하지 않습니다. 이 MCP는 x402가 의도한 대로 작동하게 만드는 구매자 측 인프라입니다.

설치할 때마다 x402 경제의 새로운 구매자가 생성됩니다. 모든 조사 호출은 3~5개의 실제 온체인 트랜잭션을 생성합니다. 이것이 바로 에이전트 경제가 부트스트랩되는 방식입니다.

링크

Alderpost Intelligence — 엔드포인트 제공자
AgentCash — 지갑 및 결제 인프라
x402scan — 생태계 탐색기
x402 Protocol — 프로토콜 사양

라이선스

MIT — Alderpost LLC, Wisconsin

x402-buyer-mcp

x402-buyer-mcp

기능

설치

사전 요구 사항

Claude Desktop

Cursor

Claude Code

도구

`x402_discover`

`x402_call`

`x402_balance`

`x402_research` ⭐

레지스트리 내 엔드포인트

결제 작동 방식

예시 세션

가격

존재 이유

링크

라이선스

Resources

Latest Blog Posts

MCP directory API

x402-buyer-mcp

기능

설치

사전 요구 사항

Claude Desktop

Cursor

Claude Code

도구

x402_discover

x402_call

x402_balance

x402_research ⭐

레지스트리 내 엔드포인트

결제 작동 방식

예시 세션

가격

존재 이유

링크

라이선스

Resources

Latest Blog Posts

MCP directory API

`x402_discover`

`x402_call`

`x402_balance`

`x402_research` ⭐