본문으로 건너뛰기

© 2026 Molayo

Dev.to헤드라인2026. 06. 06. 02:53

Base 메인넷에서 Pay-Per-Call MCP 서버 구축 — 26가지 라이브 기능, API 키 불필요, USDC 마이크로페이먼트

요약

Base 메인넷의 USDC 마이크로페이먼트를 활용하여 API 키 없이 사용한 만큼만 지불하는 x402 프로토콜 기반 MCP 서버 구축 사례를 소개합니다. AI 에이전트가 프로그래밍 방식으로 결제하고 데이터를 즉시 획득할 수 있는 새로운 데이터 접근 패턴을 제시합니다.

핵심 포인트

  • x402 프로토콜을 통한 HTTP 402 결제 상태 코드 활용
  • API 키나 월간 구독 없이 USDC로 실시간 마이크로페이먼트 처리
  • Base 메인넷 기반의 온체인 결제 검증 아키텍처
  • MCP(Model Context Protocol)를 지원하는 인프라 섀시 구축

AI 에이전트(AI agent)의 데이터 접근을 위한 표준 패턴은 다음과 같습니다: API 키를 발급받고, 월간 요금을 지불하며, Rate Limit(속도 제한)을 초과하지 않기를 기도하는 것입니다. 저는 다른 방식을 원했습니다 — 계정 생성 없이, 사용한 만큼만 USDC로 정확히 지불하는 방식 말입니다.

그래서 저는 The Stall을 구축했습니다 — Railway에 배포되었으며, Base 메인넷에서 USDC 마이크로페이먼트(micropayments)를 수락하는 26가지 데이터 서비스를 갖춘 라이브 x402 기능 섀시(chassis)입니다. 이 서비스는 공식 MCP 레지스트리에도 게시되었습니다. 가입도 필요 없고, API 키도 필요 없습니다. 당신의 에이전트가 USDC로 결제하면 데이터를 돌려받습니다.

작동 방식과 이를 구축하며 배운 점은 다음과 같습니다.

x402란 무엇인가?

x402는 버려졌던 HTTP 402 Payment Required 상태 코드를 부활시킨 결제 프로토콜입니다. 흐름은 다음과 같습니다:

  1. 에이전트가 결제 없이 보호된 엔드포인트(endpoint)에 접속합니다.
  2. 서버가 결제 챌린지(네트워크, 자산, 금액, 수신자)와 함께 HTTP 402를 반환합니다.
  3. 에이전트가 x402 퍼실리테이터(facilitator)를 통해 Base 상에서 USDC를 결제합니다.
  4. 에이전트가 X-PAYMENT 헤더를 포함하여 재시도합니다.
  5. 서버가 온체인(on-chain)에서 검증한 후 페이로드(payload)를 반환합니다.

x402 Foundation은 2025년 초에 이 사양(spec)을 발표했습니다. Coinbase가 퍼실리테이터를 구축했습니다. 실질적인 결과는 다음과 같습니다: AI 에이전트가 다른 온체인 작업을 실행하는 것과 동일한 방식으로 API 호출 비용을 지불할 수 있다는 것입니다. 즉, OAuth나 빌링 포털(billing portal), 월간 약정 없이 프로그래밍 방식으로 처리할 수 있습니다.

원시 호출(raw call)은 다음과 같은 모습입니다:

# 1단계: 엔드포인트 접속 — 402 응답을 받습니다
curl https://the-stall.intuitek.ai/cap/us-stock-price?ticker=AAPL
# → HTTP 402
...

x402 TypeScript SDK를 사용하면 다음과 같습니다:

import { withPaymentInterceptor } from "x402-fetch";
import { createWalletClient } from "viem";

...

결제 금액은 0.03 USDC입니다. 이는 Base 메인넷에서 정산됩니다. 중간 관리자가 돈을 보유하지 않습니다.

아키텍처: STALL + PROSPECTOR

저는 변경 빈도가 다른 두 가지 구성 요소로 시스템을 분리했습니다:

The Stall은 인프라입니다 — 도메인에 구애받지 않는 x402 섀시(chassis)입니다. 다음을 처리합니다:

  • 결제 검증 (Payment verification, Base 메인넷 온체인 검증)
  • 기능 라우팅 (Capability routing, 각 기능은 /capabilities/ 내의 독립적인 모듈임)
  • 스키마 검증 및 에러 정규화 (Schema validation and error normalization)
  • MCP 프로토콜 래퍼 (MCP protocol wrapper, Streamable HTTP, 2025-11-25 사양)
  • /.well-known/agent.json 위치의 A2A 에이전트 카드 (A2A agent card)

섀시(chassis)는 거의 변하지 않습니다. 새로운 기능은 단 하나의 새로운 파일일 뿐입니다.

PROSPECTOR는 지능 계층(intelligence layer)입니다 — 다음에 무엇을 구축할지 결정하기 위해 Base 메인넷의 결제 데이터(settlement data)를 모니터링하는 흐름 관찰자(flow observer)입니다.

카탈로그 스캐닝 대신 결제 데이터를 사용하는 이유

뻔한 접근 방식은 다음과 같습니다: x402 Bazaar 카탈로그를 스캔하여 등록 항목이 많은 카테고리를 찾아 그것을 만드는 것입니다. 저도 시도해 보았습니다. 카탈로그 항목이 2,000개일 때, 거의 모든 버킷(bucket)에 10개 이상의 경쟁자가 있었고, 카탈로그는 40,000개 이상의 엔드포인트(endpoint)로 성장했습니다. 카탈로그 스캐닝은 한계에 부딪혔습니다.

통찰: 중요한 신호는 무엇이 _등록되어 있는가(listed)_가 아니라, 실제로 무엇에 _결제가 이루어지고 있는가(paid)_입니다. 여러 개의 서로 다른 지갑으로부터 실제 유기적인 결제(organic settlements)를 수집하고 있는 엔드포인트는 수요가 증명된 것입니다. 결제가 전혀 없는 엔드포인트는 추측에 불과합니다.

PROSPECTOR v0.4는 다섯 가지 데이터 스트림을 SQLite 아카이브로 실행합니다:

스트림 (Stream)인증 필요 여부 (Auth needed)제공 정보 (What it gives)
bazaar없음 (none)최초 발견/최종 발견 정보가 포함된 모든 Bazaar 엔드포인트
...

base_rpc 스트림이 핵심입니다. 공개 Base RPC와 USDC 컨트랙트의 AuthorizationUsed 이벤트를 통해 Base 상의 모든 x402 결제를 커버할 수 있으며, 별도의 자격 증명(credentials)이 전혀 필요하지 않습니다.

첫 실행 결과: 2.6초 만에 1,222건의 실제 결제 확인. 100% 강도의 의존성(단일 엔드포인트에 대해 2개의 서로 다른 지갑으로부터 발생한 106건의 결제)을 포함하여 4개의 집중 신호(concentration signals)가 방출되었습니다. 해당 엔드포인트는 현재 저의 구축 목록(build list)에 올라와 있습니다.

26가지 기능 (가격 포함)

카탈로그는 /catalog에서 확인할 수 있습니다. 오늘 기준 현황은 다음과 같습니다:

기능 (Capability)가격 (Price)반환 데이터 (What it returns)
us-stock-price$0.030모든 NYSE/NASDAQ 티커에 대한 가격, 변동률 (change %), 거래량, 당일 고가/저가, 52주 범위
...
전체 범위: 호출당 $0.001 ~ $0.500

MCP 서버로 사용하기

The Stall은 공식 MCP 레지스트리인 ai.intuitek.the-stall/the-stall (v2.5.0)에 게시되어 있습니다. Claude Desktop 또는 모든 MCP 클라이언트에 다음을 추가하세요:

{
  "mcpServers": {
    "the-stall": {
...

26가지 모든 기능이 도구 (tools)로 나타납니다. 기능을 호출하면 설정된 지갑을 통해 x402 결제가 자동으로 이루어집니다.

또는 MCP 도구/호출 (tools/call) 인터페이스를 통해 모든 기능을 직접 호출할 수 있습니다:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
...

가격 모델 (배운 점)

x402 모델은 흥미로운 가격 제약 조건을 가지고 있습니다: 결제가 데이터 전달 전에 이루어진다는 점입니다. 선택 시점에 에이전트 (agent)는 기능 설명, 스키마 (schema), 그리고 가격만을 볼 수 있으며, 그 외의 정보는 없습니다. 아직 평판 신호 (reputation signal)는 존재하지 않습니다.

저의 가격 책정 원칙은 다음과 같습니다:

  1. 프리미엄 티어 ($0.10 이상)에서만 경쟁한다. 범용적인 가격 책정 ($0.001–$0.01)은 한계 비용이 없는 기존 업체들과의 제로섬 경쟁 (race to zero)입니다. 호출당 실제 가치를 제공하려면 호출당 실제 가격이 필요합니다.

  2. 비교 가능한 시장 가격보다 10~20% 낮게 책정한다. 선두 주자인 주식 분석 엔드포인트 (endpoint)가 $0.55를 청구한다면, 저는 equity-technicals를 $0.49로 책정합니다. 에이전트는 더 저렴한 동등 기능을 선택할 것입니다.

  3. 결제 전에 보이는 요소로 차별화한다 — 더 풍부한 출력 스키마 (output schemas), 더 완전한 설명, 더 많은 반환 필드 등을 제공합니다. 에이전트의 선택 휴리스틱 (selection heuristic)이 결제하기 전에 달러당 더 많은 가치를 볼 수 있어야 합니다.

  4. 가격 인상을 위한 평판을 쌓는다. 온체인 (on-chain)에서 정산된 호출 횟수는 공개적인 신호가 됩니다. 호출이 쌓임에 따라 가격을 상향 조정할 것입니다.

현재 활성화된 기능 및 찾는 방법

현재 활성화된 기능 및 찾는 방법

x402 SDK는 github.com/coinbase/x402에 있습니다. 사양(spec)은 x402.org에서 확인할 수 있습니다.

~K¹ (William Kyle Million)이 제작 · IntuiTek¹

AI 자동 생성 콘텐츠

본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.

원문 바로가기
0

댓글

0