Skip to main content
Glama
deenesjakoruzh
krystiangw

agenticpay

by krystiangw
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

agenticpay

CI CodeQL gitleaks License: MIT GitHub stars npm: @agenticpay/sdk npm downloads

AI 에이전트로부터 수익을 창출하세요. MCP 생태계를 위한 오픈 소스 결제 인프라 — 모든 도구에 가격을 설정하고, 에이전트는 x402를 통해 USDC로 결제하며, Solana에서 약 1.5초 만에 정산됩니다.

Stripe도, 계정도, API 키도 필요 없습니다.

SDK, CLI, 페이월 미들웨어, 자체 호스팅 가능한 x402 퍼실리테이터(facilitator), 그리고 실시간 LLM 에이전트 데모까지 전체 스택이 여기에 포함되어 있습니다. 모두 TypeScript로 작성되었으며 MIT 라이선스를 따릅니다.

테스트만 해보고 싶으신가요? mcp-server를 저희가 호스팅하는 devnet 퍼실리테이터로 지정하세요: FACILITATOR_URL=https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com — 별도의 설정이 필요 없습니다.

실시간 데모

실제 Claude Opus 에이전트가 작업을 수신하고, 사용할 유료 도구를 결정하며, Solana에서 x402 소액 결제를 통해 자율적으로 비용을 지불하고 사용자에게 답변합니다.

$ pnpm --filter @agenticpay/two-agent-demo agent

Agent wallet: 3rHoEumCpH8EGrr6Lq2vBKeyec6h3yPRGj2nGG2FzEfX
Server:       http://localhost:4021
Facilitator:  http://localhost:4022   ← our own
Model:        claude-opus-4-7
Task:         Reverse the string 'agentpay rocks' and tell me how many words
              are in 'The quick brown fox jumps over the lazy dog'.

[turn 1] tool_use: reverse_string({"text":"agenticpay rocks"})  →  paying $0.001 USDC ...
  ✓ paid + got result in 1596ms: {"result":"skcor yaptnega"}
[turn 1] tool_use: word_count({"text":"The quick..."})  →  paying $0.0005 USDC ...
  ✓ paid + got result in 1286ms: {"count":9}

Agent final answer:
  1. Reversed string: skcor yaptnega
  2. Word count: 9 words

=== payments summary ===
  reverse_string   $0.0010 USDC   1596ms
  word_count       $0.0005 USDC   1286ms
  TOTAL            $0.0015 USDC   2 calls

온체인 증명 (Solana devnet):

이유

현재의 AI 에이전트 스택은 인간이 신용카드를 가지고 있다고 가정합니다. 에이전트가 스스로 API를 호출하거나, 하위 에이전트를 고용하거나, 컴퓨팅 비용을 지불하는 등 주도적으로 행동하는 순간 이 가정은 깨집니다. OAuth로는 해결할 수 없습니다.

HTTP 기반의 스테이블코인 소액 결제가 이를 해결합니다. agenticpay는 특히 MCP 생태계를 위한 필수적인 사용성을 패키징했습니다. 모든 도구는 가격을 선언할 수 있고, 모든 에이전트는 결제할 수 있으며, 온체인 정산을 실제로 수행하는 퍼실리테이터를 포함한 전체 파이프라인은 오픈 소스이며 자체 호스팅이 가능합니다.

아키텍처

┌──────────────┐     1) HTTP request                    ┌─────────────┐
│   Claude /   │ ────────────────────────────────────▶ │  mcp-server │
│   GPT agent  │     2) HTTP 402 + payment requirements │  (yours)    │
│              │ ◀──────────────────────────────────── │             │
│              │     3) signed USDC payload             │             │
│              │ ────────────────────────────────────▶ │             │
└──────────────┘                                        └─────┬───────┘
                                                              │ verify+settle
                                                              ▼
                                                   ┌──────────────────────┐
                                                   │ agenticpay facilitator │
                                                   │   (also yours, this  │
                                                   │    repo, port 4022)  │
                                                   └──────────┬───────────┘
                                                              │ submit
                                                              ▼
                                                          Solana
                                                       (USDC SPL,
                                                       sub-cent fees)

mcp-server를 테스트넷/devnet용 공개 x402.org/facilitator나 메인넷용 Coinbase CDP로 지정할 수도 있습니다. 저희는 자체 호스팅 경로를 쉽게 만들었습니다.

패키지

패키지

기능

packages/sdk

TypeScript 기본 요소: USDC 전송, 지갑 관리, 네트워크 설정

packages/cli

agenticpay 명령어 — 지갑, 잔액, 전송

packages/mcp-server

x402 페이월 미들웨어가 포함된 HTTP 서버. 각 도구마다 가격이 지정됨.

packages/facilitator

자체 호스팅 x402 퍼실리테이터 — Solana에서 USDC 결제 검증 및 정산. 에이전트를 대신하여 SOL 수수료 지불.

packages/eliza-plugin

Eliza 플러그인 — 유료 HTTP 엔드포인트를 네이티브 Eliza 액션으로 래핑. Solana 네이티브 AI 에이전트가 도구 호출당 결제.

packages/ai-sdk

Vercel AI SDK 도우미 — 유료 도구를 generateText / streamText에 바로 삽입.

packages/mcp-bridge

x402 유료 도구를 래핑하는 실제 MCP 서버 (stdio + @modelcontextprotocol/sdk). Claude Desktop / Cursor에 삽입 가능.

examples/two-agent-demo

도구 호출 비용을 지불하는 실제 Claude Opus 에이전트

설치

npm install @agenticpay/sdk           # Solana + USDC primitives
npm install -g @agenticpay/cli        # `agenticpay` command
npm install @agenticpay/mcp-server    # paywalled HTTP server
npm install @agenticpay/facilitator   # self-hosted x402 facilitator
npm install @agenticpay/eliza-plugin  # Eliza plugin (Solana-native agents)
npm install @agenticpay/ai-sdk        # Vercel AI SDK paid tools
npm install -g @agenticpay/mcp-bridge # MCP server for Claude Desktop / Cursor

또는 모노레포를 클론하여 실시간 두 에이전트 데모와 편집하기 쉬운 템플릿을 확인하세요 (첫 실행 시 권장 — 아래의 빠른 시작 참조).

Claude Code와 함께 사용하기

이 저장소는 .claude/skills/agenticpay/SKILL.md에 Anthropic Skill을 포함하고 있습니다. 이를 ~/.claude/skills/에 복사하면 Claude Code에게 agenticpay에 대한 일류 컨텍스트를 제공할 수 있습니다. 그러면 Claude Code가 매번 README를 다시 읽지 않고도 MCP 서버 수익화, 도구 경로 생성, 온체인 정산 검증 과정을 안내해 줄 것입니다.

mkdir -p ~/.claude/skills
cp -r .claude/skills/agenticpay ~/.claude/skills/

빠른 시작 (devnet, 약 5분, 무료)

# 1. Install
pnpm install
pnpm -r build

# 2. Generate a payer wallet, fund it on devnet
node packages/cli/dist/index.js wallet new
node packages/cli/dist/index.js wallet show
# → fund SOL at https://faucet.solana.com  (paste pubkey)
# → fund USDC at https://faucet.circle.com (Solana Devnet, same pubkey)

# 3. (option A — fastest) Use our hosted devnet facilitator. Skip step 4.
export FACILITATOR_URL=https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com

# 3. (option B — fully self-hosted) Start your own facilitator (terminal 1)
pnpm --filter @agenticpay/facilitator dev
# Note the printed feePayer address. It needs ~0.05 SOL devnet to cover fees.
# Either airdrop or use the helper:
pnpm --filter @agenticpay/facilitator fund
export FACILITATOR_URL=http://localhost:4022

# 4. Start the paywalled mcp-server (terminal 2)
PAY_TO=<recipient pubkey> pnpm --filter @agenticpay/mcp-server dev

# 5. Run the live LLM agent demo (terminal 3, needs ANTHROPIC_API_KEY in .env)
pnpm --filter @agenticpay/two-agent-demo agent

프레임워크 통합

가장 일반적인 AI 에이전트 스택을 위한 드롭인 템플릿이 examples/ 아래에 있습니다:

프레임워크

파일

Anthropic SDK (표준)

examples/two-agent-demo/src/agent-llm.ts

실제 유료 서버 템플릿 (Claude 기반 도구)

examples/research-server/

LangChain.js

examples/langchain-js/agent-with-paid-tools.ts

LangChain Python

examples/langchain-python/agent_with_paid_tools.py

Eliza (Solana 네이티브)

examples/eliza/plugin-agenticpay.ts

Mastra

examples/mastra/paid-tool.ts

Vercel AI SDK

examples/vercel-ai-sdk/paid-tool.ts

OpenAI Custom GPT

examples/openai-gpt/action-schema.json

통합 매트릭스는 examples/README.md를 참조하세요.

상태

Pre-alpha 단계입니다. Devnet에서 엔드투엔드 검증을 마쳤습니다. 메인넷 설정도 지원하지만, 퍼실리테이터에 실제 SOL을 충전하고 메인넷 지원 RPC(Helius, QuickNode 등)를 지정해야 합니다.

로드맵

  • [x] Devnet 엔드투엔드 데모 (스모크 테스트 + LLM 에이전트)

  • [x] 자체 호스팅 x402 퍼실리테이터 (검증 + 정산, fee_payer 추상화)

  • [ ] 실제 MCP 서버 템플릿 (장난감 같은 reverse_string 대신 검색, 가져오기, 요약, 추출 등)

  • [ ] 장기 실행 작업을 위한 온체인 에스크로 (Anchor 프로그램)

  • [ ] 온체인 에이전트 평판 레지스트리

  • [ ] 호스팅된 퍼실리테이터 서비스 (agenticpay.com)

퍼실리테이터란 무엇인가요?

x402를 처음 보신다면: 퍼실리테이터는 (1) 에이전트의 서명된 결제 페이로드를 검증하고, (2) 온체인에서 USDC 전송을 제출하며, (3) 에이전트가 SOL을 가질 필요 없이 USDC만으로 결제할 수 있도록 SOL 가스비를 대신 지불하는 신뢰할 수 있는 중개자입니다. 대부분의 MCP 개발자는 직접 운영하기를 원하지 않으므로 호스팅된 서비스를 사용합니다.

이 저장소는 완전한 퍼실리테이터 구현을 제공합니다. 직접 호스팅하거나, 포크하거나, 감사하거나, 사용자들을 위한 서비스로 배포할 수 있습니다.

라이선스

MIT

Install Server
A
license - permissive license
B
quality
D
maintenance

How are these scores calculated?

Resources

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/krystiangw/agenticpay'

If you have feedback or need assistance with the MCP directory API, please join our Discord server