agenticpay

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

Получайте оплату от ИИ-агентов. Инфраструктура платежей с открытым исходным кодом для экосистемы MCP — установите цену на любой инструмент, агенты платят в USDC через x402, расчеты в Solana занимают ~1,5 секунды.

Никакого Stripe. Никаких аккаунтов. Никаких API-ключей.

Полный стек здесь — SDK, CLI, промежуточное ПО для пейволла, самохостируемый фасилитатор x402 и демо-версия работающего LLM-агента. Все на TypeScript, лицензия MIT.

Хотите просто протестировать? Укажите ваш mcp-server на наш хостинговый фасилитатор в devnet: FACILITATOR_URL=https://agentpay-facilitator-e9b20a5fee6a.herokuapp.com — настройка не требуется.

Живая демонстрация

Настоящий агент Claude Opus получает задачу, решает, какие платные инструменты использовать, автономно оплачивает их через микроплатежи x402 в Solana и отвечает пользователю.

$ 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...Bnku
Более ранний расчет через x402.org: 2d2HcefgJ...vkqY

Зачем это нужно

Текущий стек ИИ-агентов предполагает, что кредитная карта находится у человека. Это перестает работать, как только агенты начинают действовать по собственной инициативе — вызывать 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 на публичный x402.org/facilitator для testnet/devnet или на Coinbase CDP для mainnet. Мы просто упростили путь для самохостинга.

Пакеты

Пакет	Что он делает
`packages/sdk`	Примитивы TypeScript: переводы USDC, управление кошельком, конфигурация сети
`packages/cli`	Команда `agenticpay` — кошелек, баланс, отправка
`packages/mcp-server`	HTTP-сервер с промежуточным ПО для пейволла x402. У каждого инструмента есть цена.
`packages/facilitator`	Самохостируемый фасилитатор x402 — проверка + расчет платежей USDC в Solana. Оплачивает комиссии SOL от имени агентов.
`packages/eliza-plugin`	Плагин Eliza — оборачивает платные HTTP-эндпоинты в нативные действия Eliza. ИИ-агенты на базе Solana платят за каждый вызов инструмента.
`packages/ai-sdk`	Помощники Vercel AI SDK — добавляйте платные инструменты прямо в `generateText` / `streamText`.
`packages/mcp-bridge`	Настоящий MCP-сервер (stdio + `@modelcontextprotocol/sdk`), оборачивающий платные инструменты x402. Добавьте в 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

Или клонируйте монорепозиторий, чтобы получить демо-версию с двумя агентами и удобные шаблоны (рекомендуется для первого запуска — см. Quickstart ниже).

Использование с Claude Code

Этот репозиторий содержит Anthropic Skill по адресу .claude/skills/agenticpay/SKILL.md. Скопируйте его в ~/.claude/skills/, чтобы дать Claude Code первоклассный контекст об agenticpay — тогда он проведет вас через процесс монетизации MCP-сервера, генерации маршрутов инструментов и проверки расчетов в блокчейне без необходимости каждый раз перечитывать README.

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

Интеграции с фреймворками

Готовые шаблоны для самых популярных стеков ИИ-агентов находятся в папке 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. Конфигурация для Mainnet поддерживается, но требует пополнения фасилитатора реальными SOL и указания RPC, поддерживающего mainnet (Helius, QuickNode и т.д.).

Дорожная карта

[x] Сквозная демо-версия в Devnet (smoke-тест + LLM-агент)
[x] Самохостируемый фасилитатор x402 (проверка + расчет, абстракция fee_payer)
[ ] Шаблон реального MCP-сервера (поиск, получение, суммаризация, извлечение — вместо игрушечного reverse_string)
[ ] Эскроу в блокчейне для длительных задач (программа Anchor)
[ ] Реестр репутации агентов в блокчейне
[ ] Хостинговый сервис фасилитатора (agenticpay.com)

Что такое фасилитатор?

Если вы никогда раньше не видели x402: фасилитатор — это доверенный посредник, который (1) проверяет подписанный платежный пакет агента, (2) отправляет перевод USDC в блокчейн и (3) оплачивает комиссии за газ в SOL, чтобы агенту не требовались SOL — только USDC. Большинство разработчиков MCP не хотят запускать свой собственный; они используют хостинговый.

Этот репозиторий содержит полную реализацию фасилитатора. Вы можете разместить его самостоятельно, форкнуть, провести аудит или развернуть как сервис для своих пользователей.

Лицензия

MIT

agenticpay

agenticpay

Живая демонстрация

Зачем это нужно

Архитектура

Пакеты

Установка

Использование с Claude Code

Быстрый старт (devnet, ~5 минут, бесплатно)

Интеграции с фреймворками

Статус

Дорожная карта

Что такое фасилитатор?

Лицензия

Resources

Tools

Latest Blog Posts

MCP directory API