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):
μ체 νΈμ€ν νΌμ€λ¦¬ν μ΄ν°μ μν μ μ°:
EsqzTG8id...Bnkux402.orgλ₯Ό ν΅ν μ΄μ μ μ°:
2d2HcefgJ...vkqY
Related MCP server: opendexter
μ΄μ
νμ¬μ 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λ‘ μ§μ ν μλ μμ΅λλ€. μ ν¬λ μ체 νΈμ€ν
κ²½λ‘λ₯Ό μ½κ² λ§λ€μμ΅λλ€.
ν¨ν€μ§
ν¨ν€μ§ | κΈ°λ₯ |
| TypeScript κΈ°λ³Έ μμ: USDC μ μ‘, μ§κ° κ΄λ¦¬, λ€νΈμν¬ μ€μ |
|
|
| x402 νμ΄μ λ―Έλ€μ¨μ΄κ° ν¬ν¨λ HTTP μλ². κ° λꡬλ§λ€ κ°κ²©μ΄ μ§μ λ¨. |
| μ체 νΈμ€ν x402 νΌμ€λ¦¬ν μ΄ν° β Solanaμμ USDC κ²°μ κ²μ¦ λ° μ μ°. μμ΄μ νΈλ₯Ό λμ νμ¬ SOL μμλ£ μ§λΆ. |
| Eliza νλ¬κ·ΈμΈ β μ λ£ HTTP μλν¬μΈνΈλ₯Ό λ€μ΄ν°λΈ Eliza μ‘μ μΌλ‘ λν. Solana λ€μ΄ν°λΈ AI μμ΄μ νΈκ° λꡬ νΈμΆλΉ κ²°μ . |
| Vercel AI SDK λμ°λ―Έ β μ λ£ λꡬλ₯Ό |
| x402 μ λ£ λꡬλ₯Ό λννλ μ€μ MCP μλ² (stdio + |
| λꡬ νΈμΆ λΉμ©μ μ§λΆνλ μ€μ 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 (νμ€) |
|
μ€μ μ λ£ μλ² ν νλ¦Ώ (Claude κΈ°λ° λꡬ) |
|
LangChain.js |
|
LangChain Python |
|
Eliza (Solana λ€μ΄ν°λΈ) |
|
Mastra |
|
Vercel AI SDK |
|
OpenAI Custom GPT |
|
ν΅ν© λ§€νΈλ¦μ€λ 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
Maintenance
Tools
Latest Blog Posts
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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
