Каталог MCP
yolfinance/yolfi-agent

yolfinance/yolfi-agent

Yolfi Agent Kit — MCP-сервер и SDK для интеграции крипто-платежей. Позволяет AI-агентам создавать платежные ссылки, проверять статус оплаты и обрабатывать вебхуки. Подходит для SaaS, игр и маркетпл...

README

19 инструментов

Версии

Установить сервер

Yolfi Agent Kit: AI agent payment integration for crypto checkout, payment links, MCP, CLI, SDK, and webhooks

Yolfi Agent Kit

license

AI agent payment integration for crypto checkout. Yolfi Agent Kit is a JSON-first SDK, CLI, Agent Skill, and MCP server that lets AI coding agents add stablecoin checkout, payment links, payment status checks, webhook verification, and webhook-based access logic to applications through Yolfi.

Use @yolfi/agent when Codex, Claude Code, Cursor, OpenClaw, an MCP host, or a custom AI agent can build the product but still needs a reliable payment API to register a Yolfi workspace, create a paylink, configure webhooks, and verify crypto payment status without sending the user through manual dashboard setup.

Languages

Read this package guide in: English, Español, Deutsch, Français, 简体中文, Русский, हिन्दी, Türkçe, 한국어, 日本語.

Why Developers Use It

Add AI agent payments to SaaS products, games, marketplaces, donation pages, digital downloads, internal tools, and agent-built apps.
Give coding agents a safe payment workflow: inspect the app, register or reuse a workspace, ask for wallet and price decisions, create paylinks, install checkout, verify webhooks, and check payment status.
Use one package for MCP crypto payments, JSON CLI automation, JavaScript SDK calls, webhook signature verification, and agent-readable instructions.
Build with the existing Yolfi API instead of maintaining a second agent-only payment API.
Help agents discover Yolfi through npm, GitHub, MCP directories, llms.txt, docs, examples, and integration guides.

Инструменты были проиндексированы: 11.09.2026

yolfi_agent_checkinвнешний мир

Проверяет, завершена ли авторизация в браузере. В случае успеха безопасно сохраняет возвращённые учётные данные yolfi_agent_* для последующих локальных вызовов SDK, CLI и MCP.

Проверка настройки агента Yolfi

Параметры

agentstring
Stable lowercase slug used for yolfi_agent_setup_start.
agentIdstring
Compatibility alias for agent. Use agent for new integrations.

yolfi_agent_registerвнешний мир

Начинает регистрацию нового пользователя Yolfi с подтверждённого пользователем email. Первый вызов отправляет ссылку для подтверждения и сохраняет защищённое состояние регистрации; вызовите тот же инструмент снова после подтверждения, чтобы сохранить одноразовые учётные данные, не раскрывая их.

Зарегистрировать рабочее пространство Yolfi для агента

Параметры

agentNamestringобязательный
Name of the coding agent or MCP host, for example Codex, Claude Code, Cursor, or OpenClaw.
emailstringобязательный
New Yolfi account email explicitly confirmed by the user. Existing Yolfi account emails are rejected and must use OAuth or browser setup.
idempotencyKeystring
Optional retry key. Reuse the same value when calling this tool after email confirmation; a UUID is generated and persisted when omitted.
integrationIntentstring
User-approved reason for the integration. Defaults to accept_payments when omitted.
languagestring
Optional preferred language code for agent-facing responses.
metadataobject
Optional safe non-secret metadata. Do not include API keys, wallet private keys, tokens, or personal secrets.
projectNamestringобязательный
User-approved product or project name for the Yolfi workspace.
projectUrlstring
Optional public or local URL of the target product, if known.
refstring
Optional source tag such as mcp, glama, npm, docs, codex, claude-code, or cursor.

yolfi_agent_setup_startвнешний мир

Запускает предпочтительный браузерный процесс авторизации Yolfi. Возвращает URL для входа и сохраняет только кратковременный токен проверки в защищённой локальной конфигурации Yolfi.

Запустить настройку Yolfi Agent.

Параметры

agentstring
Stable lowercase slug for the MCP host, for example codex, claude-code, cursor, or local-agent.
agentIdstring
Compatibility alias for agent. Use agent for new integrations.

yolfi_auth_statusтолько чтениеидемпотентный

Проверяет активные учётные данные OAuth, локального агента или API-ключа и возвращает текущий контекст организации Yolfi перед изменением настроек оплаты.

Проверить статус аутентификации Yolfi

Параметры

Без параметров.

yolfi_organization_getтолько чтениеидемпотентный

Читает текущие настройки организации Yolfi, включая конфигурацию вебхуков и расчётов, видимую для этого API-ключа.

Получить Yolfi Organization

Параметры

Без параметров.

yolfi_organization_updateвнешний мир

Обновляет поля профиля организации через существующий Yolfi organization endpoint. Не выдумывайте merchant identity, support email или settlement settings.

Обновить организацию Yolfi

Параметры

emailstring
Merchant support or account email approved by the user.
namestring
Merchant or project display name approved by the user.

yolfi_paylinks_createвнешний мир

Создаёт ссылку оплаты Yolfi только после того, как пользователь одобрит название продукта, сумму, валюту и тип платежа (разовый или регулярный).

Создать Yolfi Paylink

Параметры

collectAddressboolean
Whether checkout should collect the customer address.
collectDateOfBirthboolean
Whether checkout should collect the customer date of birth.
collectEmailboolean
Whether checkout should collect customer email.
collectNameboolean
Whether checkout should collect the customer name.
collectPhoneNumberboolean
Whether checkout should collect the customer phone number.
currencyenum
Account currency code. Supported values are USD, EUR, and CNY.
descriptionstring
Optional user-approved customer-facing description.
imageUrlstring
Optional public product image URL shown on checkout.
metadataobject
Safe non-secret metadata such as source, productSlug, planId, or environment.
namestringобязательный
User-approved product, plan, donation, or access name shown on checkout.
pricestringобязательный
User-approved decimal price, represented as a string to avoid numeric rounding.
recurringIntervalenum
Recurring billing interval when type is RECURRING.
typeenum
Payment link type: ONE_TIME or RECURRING.

yolfi_paylinks_disableвнешний мир

Отключить платёжную ссылку. Это деструктивное действие, которое должно выполняться только после явного подтверждения пользователем.

Отключить Yolfi Paylink

Параметры

confirmanyобязательный
Must be true only after explicit user confirmation.
idstringобязательный
Yolfi paylink ID to disable.

yolfi_paylinks_getтолько чтениеидемпотентный

Получает детали приватной платёжной ссылки по ID для проверки, сверки проводки или обнаружения дубликатов.

Получить Yolfi Paylink

Параметры

idstringобязательный
Yolfi paylink ID returned by yolfi_paylinks_create or yolfi_paylinks_list.

yolfi_paylinks_listтолько чтениеидемпотентный

Перед созданием новых paylinks Yolfi выведите список существующих, чтобы агенты избежали дубликатов после повторных попыток или тайм-аутов.

Перечислить Yolfi Paylinks

Параметры

pagenumber
Page number. Defaults to 1.
rowsnumber
Rows per page. Defaults to 10.

yolfi_payments_createвнешний мир

Создаёт публичный платёжный счёт из существующей платёжной ссылки для интеграции оформления заказа, тестирования или настройки потока клиента.

Создать Yolfi Public Payment

Параметры

clientReferenceIdstring
Optional merchant reference for the customer or order; returned as customer.clientReferenceId in webhook payloads.
customerAddressstring
Optional customer address.
customerDateOfBirthstring
Optional customer date of birth.
customerEmailstringобязательный
Customer email required for checkout and payment receipts.
customerNamestring
Optional customer name.
customerPhonestring
Optional customer phone number.
languagestring
Optional checkout language code supported by Yolfi.
metadataobject
Safe non-secret metadata for the target app payment flow.
networkstringобязательный
Blockchain network identifier supported by the Yolfi organization, for example ARB.
paylinkIdstringобязательный
Yolfi paylink ID used to create the customer payment.
subscriptionIdstring
Optional existing subscription ID to associate the payment with.
symbolstringобязательный
Payment token symbol supported on the selected network, for example USDC.

yolfi_payments_statusтолько чтениеидемпотентный

Получить публичный статус платежа по ID. Не рассматривайте перенаправление на фронтенде как подтверждение оплаты.

Получить статус платежа Yolfi

Параметры

idstringобязательный
Yolfi payment ID returned by yolfi_payments_create.

yolfi_settlement_configureвнешний мир

Настраивает расчетные кошельки после того, как пользователь укажет адреса кошельков, сети и включенные токены. Никогда не выдумывайте адреса кошельков.

Настроить расчетные кошельки Yolfi

Параметры

settlementAccountsobject[]обязательный
Settlement account objects accepted by the Yolfi organization endpoint. Example fields: id, address, tokens.

yolfi_webhooks_configureвнешний мир

Настройте доставку вебхуков для целевого приложения. Хост не должен придумывать URL бэкенда и должен гарантировать, что приложение проверяет X-Yolfi-Signature.

Настроить Yolfi Webhooks

Параметры

adapterenum
Webhook adapter output format. Defaults to NONE if omitted.
metadataFiltersobject
Optional flat key/value metadata filters. A delivery must match every configured string value.
namestring
Endpoint display name, for example Merchant analytics.
urlstringобязательный
HTTPS webhook URL in the target app, for example https://example.com/api/yolfi/webhook.

yolfi_webhooks_deleteидемпотентныйвнешний мир

Удаляет неиспользуемый endpoint вебхука или отключает его, когда необходимо сохранить существующую историю доставок.

Удаляет эндпоинт вебхука Yolfi

Параметры

confirmanyобязательный
Must be true only after explicit user confirmation.
idstringобязательный
Webhook endpoint id.

yolfi_webhooks_listтолько чтениеидемпотентный

Перечисляет все независимые конечные точки вебхуков, настроенные для текущей организации.

Перечисляет вебхук-эндпоинты Yolfi

Параметры

Без параметров.

yolfi_webhooks_rotate_secret

Поворачивает секрет подписи вебхука для конкретного эндпоинта и сохраняет его в защищённой локальной конфигурации Yolfi без возврата этого секрета.

Сменяет секрет подписи вебхука Yolfi

Параметры

confirmanyобязательный
Must be true only after explicit user confirmation.
idstringобязательный
Webhook endpoint id.

yolfi_webhooks_updateидемпотентныйвнешний мир

Обновляет имя, URL, адаптер или состояние включения одного независимого эндпоинта вебхука Yolfi.

Обновляет Yolfi Webhook Endpoint

Параметры

adapterenum
Webhook adapter output format.
enabledboolean
Whether this endpoint receives new deliveries.
idstringобязательный
Webhook endpoint id.
metadataFiltersobject
Optional flat key/value metadata filters. A delivery must match every configured string value.
namestring
Endpoint display name.
urlstring
HTTPS webhook URL.

yolfi_webhooks_verifyтолько чтениеидемпотентный

Не доверяйте платежным событиям, пока не проверите HMAC подпись X-Yolfi-Signature по сырому JSON-телу вебхука.

Проверить подпись вебхука Yolfi

Параметры

endpointIdstring
Webhook endpoint id whose signing secret was stored locally during create or rotate. YOLFI_WEBHOOK_SECRET takes precedence when set.
payloadstringобязательный
Raw webhook request body string, before JSON parsing.
signaturestringобязательный
X-Yolfi-Signature header value.

Github Сайт сервера

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@yolfi/agent",
    "mcp"
  ],
  "env": {
    "YOLFI_API_KEY": "..."
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

Для чего этот сервер?

Yolfi Agent Kit — MCP-сервер для интеграции крипто-платежей в AI-агентов. Он создаёт платёжные ссылки, проверяет статус оплаты, настраивает вебхуки и принимает стейблкоины без ручного входа в дашборд. С его помощью AI-агенты самостоятельно добавляют приём платежей в приложения, игры, сайты и сервисы.

Что он умеет?

Сервер управляет платёжными ссылками Yolfi: создаёт их после подтверждения, читает, ищет и отключает. Создаёт платёжные инвойсы из paylink и проверяет статус оплаты. Настраивает вебхуки: создаёт, обновляет, удаляет, проверяет подпись X-Yolfi-Signature и ротирует секреты. Читает и обновляет настройки организации, конфигурирует кошельки для расчётов. Регистрирует рабочее пространство и запускает браузерную авторизацию агента.

Информация о сервере

Номер в рейтинге: #170
Звезд на Github: 188
Форков на Github: 1
Загрузок: 1 304
Язык реализации: JavaScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 10.09 в 23:50
Идентификатор: DT7zRQE4VoRMTRrg
Категории: Web3 и децентрализованные технологии, Агенты для программирования, Блокчейн, Инструменты для разработчиков, Криптовалюты и Defi, Платежи и выставление счетов, Финансы