AI 에이전트가 API 키 없이 실시간 SEC 데이터를 단돈 $0.01에 이용하는 방법

AI 에이전트가 유용하게 작동하려면 현실 세계의 데이터가 필요합니다. 문제는 대부분의 데이터 제공업체가 API 키, 월간 결제 계정, 그리고 사람이 협상해야 하는 속도 제한 (rate-limit) 합의를 요구한다는 점입니다. 에이전트가 자율적(autonomous)일 때는 이 모델이 무너집니다. 가입할 사람도 없고, 키를 교체할 프로세스도 없으며, 구독을 승인할 예산 관리자도 없기 때문입니다. 더 나은 패턴이 존재합니다.

x402란 무엇인가

x402는 Base 메인넷(mainnet) 위에 구축된 HTTP 네이티브 마이크로페이먼트 (micropayment) 프로토콜입니다. 헤더에 API 키를 넣는 대신, 클라이언트는 EIP-3009 transferWithAuthorization를 사용하여 서명된 USDC 승인(authorization)을 보냅니다. 서버는 온체인(on-chain)에서 서명을 검증하고, 데이터를 제공하며, 결제를 정산합니다. 이 모든 과정은 단 한 번의 HTTP 라운드 트립 (round-trip) 내에서 이루어집니다.

핵심적인 세부 사항은 개발자의 신용카드가 아니라 에이전트 자신의 지갑이 결제한다는 점입니다. 에이전트는 소량의 USDC 잔액을 보유하고, 해당 호출에만 국한된 일회성 승인에 서명하면 데이터가 도착합니다. API 키도, 구독도, 개입하는 사람도 필요 없습니다.

이것이 프로토콜 수준에서 말하는 진정한 "호출당 결제 (pay-per-call)"의 의미입니다.

Toolstem SEC EDGAR MCP 서버

Toolstem은 https://mcp.toolstem.com/mcp/sec에서 x402를 통해 5가지 SEC EDGAR 도구를 노출하는 MCP 서버를 운영합니다. 가격은 데이터의 풍부함에 따라 계층화되어 있습니다:

이 서버는 표준 MCP 프로토콜을 사용하므로, MCP 호환 클라이언트라면 수정 없이 연결할 수 있습니다. 결제는 클라이언트 라이브러리에 의해 투명하게 처리되며, 에이전트는 일반적인 도구 호출로 인식합니다.

또한 이 서버는 Coinbase x402 Bazaar의 payTo 지갑 0xB009DA692cF3EFF7567bF727b8B2F3b5BFc3383E 아래에 등록되어 있으며, 이는 자율적 발견 (autonomous discovery) 측면에서 중요합니다 (이에 대해서는 아래에서 더 자세히 다룹니다).

코드 살펴보기

패키지를 설치합니다:

# TypeScript / Node
npm install langchain-toolstem

...

다음은 NVDA에 대해 get_insider_signal을 호출하는 TypeScript 기반의 완전한 작동 에이전트 예시입니다. 이 에이전트는 자동으로 결제하며, 코드 어디에도 API 키가 포함되어 있지 않습니다.

import { ChatOpenAI } from "@langchain/openai";
import { AgentExecutor, createOpenAIToolsAgent } from "langchain/agents";
import { ChatPromptTemplate } from "@langchain/core/prompts";
...

get_insider_signal이 호출될 때 내부적으로 발생하는 과정은 다음과 같습니다:

1. langchain-toolstem이 MCP 서버로 보낼 HTTP 요청을 구성합니다.
2. x402 클라이언트가 EIP-3009를 사용하여 transferWithAuthorization에 서명합니다. 이는 $0.05 범위로 제한된 일회성 USDC 전송 승인입니다.
3. 해당 승인(authorization)이 요청 헤더에 첨부됩니다.
4. 서버가 서명을 검증하고, SEC 데이터를 가져온 뒤 결과를 반환합니다.
5. $0.05가 Base 메인넷(mainnet)에서 정산됩니다.

Python 버전은 동일한 패키지(PyPI의 v0.1.0)의 createsectools를 사용합니다. 패턴은 동일합니다. 지갑 키를 입력하면 도구가 출력되며, 결제는 자동으로 이루어집니다.

에이전트 디스커버리(Agent Discovery) 작동 방식

x402 Bazaar는 x402 호환 서버들이 자신의 엔드포인트(endpoint), 가격, payTo 주소를 등록하는 레지스트리(registry)입니다. 자율 에이전트는 브라우저가 웹페이지를 찾는 것과 같은 방식으로, 별도의 인간 설정 없이도 Bazaar를 쿼리하여 사용 가능한 데이터 제공자를 찾아낼 수 있습니다.

Toolstem의 경우를 구체적으로 살펴보면: 에이전트가 Bazaar에서 SEC 또는 금융 공시 도구를 검색하면 Toolstem 항목을 찾고, 도구 매니페스트(manifest)를 읽고, 지갑에 몇 달러의 USDC를 충전한 뒤 유료 호출을 시작합니다. 이 모든 과정은 개발자의 개입 없이 엔드투엔드(end-to-end)로 자율적으로 이루어집니다.

이로써 루프(loop)가 완성됩니다. 에이전트의 지갑은 곧 정체성이자 결제 수단이 됩니다. Bazaar는 서비스 레지스트리가 됩니다. API 키도, SaaS 계정도, 중간에 개입하는 인간도 필요 없습니다.

다음 단계

코드를 작성하기 전에 Toolstem playground에서 도구들을 대화형으로 사용해 보세요. npm 패키지(langchain-toolstem@0.1.4)는 npm에 있으며, Python 패키지(langchain-toolstem@0.1.0)는 PyPI에 있습니다. 두 패키지 모두 https://mcp.toolstem.com/mcp/finance 및 https://mcp.toolstem.com/mcp/sec에 있는 동일한 MCP 엔드포인트(endpoints)에 연결됩니다.