Добавить сервер
yolfinance/yolfi-agent
  1. Каталог MCP
  2. yolfinance/yolfi-agent

yolfinance/yolfi-agent

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

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

Yolfi Agent Kit

npm version license Node.js 18+ Yolfi MCP server Yolfi MCP score

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.

Website | Agent Kit | Docs | npm | GitHub | Glama | Guide

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, authorize 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.

Часто задаваемые вопросы

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

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

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

Параметры
  • agentstring

    Стабильный slug в нижнем регистре, используемый для yolfi_agent_setup_start.

  • agentIdstring

    Алиас совместимости для агента. Используйте агента для новых интеграций.

yolfi_agent_registerвнешний мир

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

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

Параметры
  • agentNamestringобязательный

    Название агента кодирования или хоста MCP, например Codex, Claude Code, Cursor или OpenClaw.

  • emailstringобязательный

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

  • idempotencyKeystring

    Необязательный ключ повторной попытки. Используйте повторно то же значение при вызове этого инструмента после подтверждения email; если значение не указано, генерируется и сохраняется UUID.

  • integrationIntentstring

    Утверждённая пользователем причина интеграции. По умолчанию используется accept_payments, если поле не указано.

  • languagestring

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

  • metadataobject

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

  • projectNamestringобязательный

    Одобренное пользователями название продукта или проекта для рабочего пространства Yolfi.

  • projectUrlstring

    Необязательный публичный или локальный URL целевого продукта, если он известен.

  • refstring

    Необязательный тег источника, например mcp, glama, npm, docs, codex, claude-code или cursor.

yolfi_agent_setup_startвнешний мир

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

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

Параметры
  • agentstring

    Стабильный slug в нижнем регистре для MCP-хоста, например codex, claude-code, cursor или local-agent.

  • agentIdstring

    Алиас совместимости для агента. Используйте агента для новых интеграций.

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

    Поддержка продавца или электронная почта аккаунта, одобренная пользователем.

  • namestring

    Название мерчанта или проекта, одобренное пользователем.

yolfi_paylinks_createвнешний мир

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

Создать Yolfi Paylink

Параметры
  • collectAddressboolean

    Следует ли при оформлении заказа запрашивать адрес клиента.

  • collectDateOfBirthboolean

    Нужно ли запрашивать дату рождения клиента при оформлении заказа.

  • collectEmailboolean

    Следует ли при оформлении заказа запрашивать адрес электронной почты клиента.

  • collectNameboolean

    Нужно ли собирать имя клиента при оформлении заказа.

  • collectPhoneNumberboolean

    Нужно ли при оформлении заказа запрашивать номер телефона клиента.

  • currencyenum

    Валюта счёта. Поддерживаются значения USD, EUR и CNY.

  • descriptionstring

    Необязательное описание, одобренное пользователем, для отображения клиентам.

  • imageUrlstring

    Необязательный публичный URL изображения товара, отображаемый при оформлении заказа.

  • metadataobject

    Безопасные несекретные метаданные, такие как source, productSlug, planId или environment.

  • namestringобязательный

    Название одобренного пользователем продукта, плана, пожертвования или доступа, отображаемое при оформлении заказа.

  • pricestringобязательный

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

  • recurringIntervalenum

    Период повторного выставления счетов, когда тип — RECURRING.

  • typeenum

    Тип платежной ссылки: ONE_TIME или RECURRING.

yolfi_paylinks_disableвнешний мир

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

Отключить Yolfi Paylink

Параметры
  • confirmanyобязательный

    Должно быть верным только после явного подтверждения пользователя.

  • idstringобязательный

    Yolfi paylink ID для отключения.

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

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

Получить Yolfi Paylink

Параметры
  • idstringобязательный

    Yolfi paylink ID, который возвращается функциями yolfi_paylinks_create или yolfi_paylinks_list.

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

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

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

Параметры
  • pagenumber

    Номер страницы. По умолчанию — 1.

  • rowsnumber

    Строк на странице. По умолчанию: 10.

yolfi_payments_createвнешний мир

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

Создать Yolfi Public Payment

Параметры
  • clientReferenceIdstring

    Необязательная ссылка продавца для клиента или заказа; возвращается как customer.clientReferenceId в полезной нагрузке вебхука.

  • customerAddressstring

    Необязательный адрес клиента.

  • customerDateOfBirthstring

    Необязательная дата рождения клиента.

  • customerEmailstringобязательный

    Электронная почта клиента требуется для оформления заказа и получения чеков об оплате.

  • customerNamestring

    Необязательное имя клиента.

  • customerPhonestring

    Номер телефона клиента (необязательно).

  • languagestring

    Необязательный код языка оформления заказа, поддерживаемый Yolfi.

  • metadataobject

    Безопасные несекретные метаданные для платежного процесса целевого приложения.

  • networkstringобязательный

    Идентификатор блокчейн-сети, поддерживаемый организацией Yolfi, например ARB.

  • paylinkIdstringобязательный

    Идентификатор Yolfi paylink, используемый для создания платежа клиента.

  • subscriptionIdstring

    Необязательный идентификатор существующей подписки для привязки платежа.

  • symbolstringобязательный

    Символ токена для оплаты, поддерживаемый на выбранной сети, например USDC.

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

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

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

Параметры
  • idstringобязательный

    Идентификатор платежа Yolfi, возвращаемый yolfi_payments_create.

yolfi_settlement_configureвнешний мир

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

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

Параметры
  • settlementAccountsobject[]обязательный

    Объекты расчётных счетов, принимаемые конечной точкой организации Yolfi. Примеры полей: id, адрес, токены.

yolfi_webhooks_configureвнешний мир

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

Настроить Yolfi Webhooks

Параметры
  • adapterenum

    Формат вывода адаптера Webhook. Если не указан, по умолчанию используется NONE.

  • metadataFiltersobject

    Необязательные плоские фильтры «ключ/значение». Доставка должна соответствовать каждому настроенному строковому значению.

  • namestring

    Отображаемое имя конечной точки, например Merchant analytics.

  • urlstringобязательный

    HTTPS-адрес вебхука в целевом приложении, например https://example.com/api/yolfi/webhook.

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

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

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

Параметры
  • confirmanyобязательный

    Должно быть верным только после явного подтверждения пользователя.

  • idstringобязательный

    Идентификатор конечной точки вебхука.

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

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

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

Параметры

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

yolfi_webhooks_rotate_secret

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

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

Параметры
  • confirmanyобязательный

    Должно быть верным только после явного подтверждения пользователя.

  • idstringобязательный

    Идентификатор конечной точки вебхука.

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

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

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

Параметры
  • adapterenum

    Формат вывода адаптера вебхука.

  • enabledboolean

    Получает ли эта конечная точка новые поставки?

  • idstringобязательный

    Идентификатор конечной точки вебхука.

  • metadataFiltersobject

    Необязательные плоские фильтры «ключ/значение». Доставка должна соответствовать каждому настроенному строковому значению.

  • namestring

    Отображаемое имя конечной точки.

  • urlstring

    URL вебхука HTTPS.

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

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

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

Параметры
  • endpointIdstring

    Идентификатор вебхук-эндпоинта, чей секрет подписи был сохранён локально во время создания или ротации. YOLFI_WEBHOOK_SECRET имеет приоритет, когда задан.

  • payloadstringобязательный

    Сырая строка тела вебхук-запроса до парсинга JSON.

  • signaturestringобязательный

    Значение заголовка X-Yolfi-Signature.

0.2.0основная
0.1.4
0.1.3
0.1.2
0.1.1
0.1.0

Выберите клиент, чтобы установить yolfinance/yolfi-agent:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

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

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"yolfinance-yolfi-agent-ejn8oie3u4\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@yolfi/agent\",\"mcp\"],\"env\":{\"YOLFI_API_KEY\":\"...\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "yolfinance-yolfi-agent-ejn8oie3u4": {
      "command": "npx",
      "args": [
        "-y",
        "@yolfi/agent",
        "mcp"
      ],
      "env": {
        "YOLFI_API_KEY": "..."
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add yolfinance-yolfi-agent-ejn8oie3u4 --env YOLFI_API_KEY=... -- npx -y @yolfi/agent mcp

Либо через JSON-конфиг:

claude mcp add-json yolfinance-yolfi-agent-ejn8oie3u4 "{\"command\":\"npx\",\"args\":[\"-y\",\"@yolfi/agent\",\"mcp\"],\"env\":{\"YOLFI_API_KEY\":\"...\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add yolfinance-yolfi-agent-ejn8oie3u4 --env YOLFI_API_KEY=... -- npx -y @yolfi/agent mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.yolfinance-yolfi-agent-ejn8oie3u4]
command = "npx"
args = ["-y", "@yolfi/agent", "mcp"]

[mcp_servers.yolfinance-yolfi-agent-ejn8oie3u4.env]
YOLFI_API_KEY = "..."
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите yolfinance/yolfi-agent, а в поле команды запуска — строку ниже:
npx -y @yolfi/agent mcp

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "yolfinance-yolfi-agent-ejn8oie3u4": {
      "command": "npx",
      "args": [
        "-y",
        "@yolfi/agent",
        "mcp"
      ],
      "env": {
        "YOLFI_API_KEY": "..."
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например yolfinance-yolfi-agent-ejn8oie3u4.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: yolfinance-yolfi-agent-ejn8oie3u4
    command: npx
    args:
      - "-y"
      - "@yolfi/agent"
      - "mcp"
    env:
      YOLFI_API_KEY: ...
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Похожие MCP-сервера

joepangallo/mcp-server-agentpay

joepangallo/mcp-server-agentpay

от joepangallo

Платёжный шлюз для ИИ-агентов: пополните кошелёк один раз, и агент сам ищет, подключает и оплачивает API инструментов. Один ключ на все сервисы - никаких отдельных аккаунтов и ручных платежей. Поле...

JavaScript⭐ 1
tipdotmd/tip-md-x402-mcp-server

tipdotmd/tip-md-x402-mcp-server

от tipdotmd

Сервер tip.md x402+CDP превращает любого AI-агента в платёжный инструмент для крипто-чаевых. Использует протокол x402 для сбора платежей и CDP для автоматического распределения (96% получателю). Работает с Claude, ChatGPT, Cursor — универсальный MCP инструмент для монетизации агентов.

TypeScript⭐ 9
Logitale/toreador-mcp-server

Logitale/toreador-mcp-server

от logitale

MCP сервер Toreador генерирует крипто QR-коды (BTC, ETH, SOL, USDC) и управляет ERC-20 платежными сессиями. Интегрируется с Claude и Cursor для быстрых ончейн-платежей без написания кода.

JavaScript⭐ 1
ShinyDapps/l402-kit

ShinyDapps/l402-kit

от shinydapps

MCP-сервер l402-kit добавляет оплату через Bitcoin Lightning к любому API за три строки кода. AI-агенты могут автономно платить за вызовы без участия человека. Монетизация без возвратов и банковски...

TypeScript⭐ 4
Робокасса MCP

Робокасса MCP

от theyahia

MCP сервер для Robokassa: создает платежные счета с MD5 подписью и проверяет статус через XML-интерфейс. Полезен разработчикам, интегрирующим оплату в ИИ-агентов или чат-ботов. Включает два инструмента: create_invoice и check_invoice.

TypeScript⭐ 1
lightningfaucet/lightning-wallet-mcp

lightningfaucet/lightning-wallet-mcp

от lightningfaucet

MCP-сервер и CLI, который даёт AI-агентам биткоин-кошелёк на Lightning Network. Поддерживает автоматическую оплату L402 и X402 API, управление бюджетом агентов, вебхуки. Полезен разработчикам, внед...

TypeScript⭐ 10
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин