Log inSubmit server
Yolfi Agent logo

Yolfi Agent

by yolfinance

Adds Yolfi crypto checkout, payment links, webhook handling, and payment status tools to AI coding agents.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Yolfi Agent

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "yolfinance-yolfi-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@yolfi/agent"
      ],
      "env": {
        "YOLFI_API_KEY": "YOUR_VALUE_HERE",
        "YOLFI_CONFIG_HOME": "YOUR_VALUE_HERE",
        "YOLFI_REGISTRATION_IDEMPOTENCY_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

yolfinance/yolfi-agent MCP server connects AI coding agents to Yolfi’s crypto payment API through a local stdio process. It supports workspace registration and authorization, settlement configuration, paylink creation, payment status checks, webhook setup, and signature verification. Reach for it when an agent needs to add stablecoin checkout or payment-based access logic without relying on manual dashboard configuration. Node.js 18 or newer is required, and authentication can use browser authorization with protected local credentials or an explicit API key.

Use cases

  • Add stablecoin checkout to a SaaS application
  • Create payment links for digital products or game items
  • Configure webhook-driven access entitlements
  • Check payment status from an agent-built application
  • Register and configure a Yolfi workspace

Key features

  • Yolfi workspace registration and authentication
  • Crypto paylink creation and invoice generation
  • Settlement wallet configuration
  • Webhook endpoint management
  • Webhook signature verification
  • Payment status checks

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

19/20 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · @yolfi/agent (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars177Stargazers on the source repository.
npm downloads254Package downloads in the last 30 days.
Last commit3mo agoMost recent push to the default branch.
Directory activity2 viewsConfig copies, upvotes, and views on AllMCPs.

How Yolfi Agent works

What yolfinance/yolfi-agent MCP server does

yolfinance/yolfi-agent provides an MCP interface to Yolfi payment operations for AI coding agents. It is intended for applications that need crypto checkout, one-time or recurring-style payment links, donation pages, paid downloads, credits, game items, or access controlled by confirmed payment events.

The package combines an MCP server with a CLI, JavaScript SDK, and agent instructions. The payment infrastructure remains in Yolfi, while the agent is responsible for inspecting the target project, asking the user for decisions such as wallet addresses and prices, making code changes, and wiring the application to Yolfi.

How it works

The server runs locally over MCP stdio. An MCP host starts the package with npx -y @yolfi/agent mcp, after which the agent can work with Yolfi operations from the host’s tool interface. The supported workflow includes registering or reusing a workspace, checking authentication, configuring settlement wallets, creating or reusing paylinks, and adding checkout integration.

Webhook workflows can configure endpoints, retain delivery settings, and verify the X-Yolfi-Signature header. Applications can then use confirmed webhook events for entitlement logic. Payment status can also be checked through Yolfi’s public payment endpoints.

The included Yolfi Payments Skill defines confirmation boundaries for agents. Agents must not invent wallet addresses, prices, plans, currencies, credential locations, or destructive paylink operations.

Setup and configuration

Install the package into a project with npm install @yolfi/agent, or run it without installation using npx -y @yolfi/agent mcp. Node.js 18 or later is supported. The repository also provides a local CLI entry point for development.

The preferred setup opens browser authorization and stores a credential in ~/.yolfi/config.json. Run setup with an agent name, complete the returned login flow, then use checkin and auth:status. YOLFI_CONFIG_HOME can move this configuration into an isolated directory for development or CI. An explicit YOLFI_API_KEY takes precedence over stored credentials.

New users can use the email-confirmed registration flow. The registration command requires user confirmation of the email and project name, and may use YOLFI_REGISTRATION_IDEMPOTENCY_KEY to safely repeat a pending registration.

Tools and capabilities

The yolfinance/yolfi-agent MCP server covers these operations:

  • Registering an agent or Yolfi workspace.
  • Checking authentication and workspace status.
  • Configuring settlement wallets.
  • Listing and creating payment links.
  • Creating public payment invoices from paylinks.
  • Checking payment status.
  • Adding, listing, updating, and removing webhook endpoints.
  • Verifying webhook signatures and supporting webhook-based access logic.

Webhook metadata filters are flat key-value maps with documented size limits. Removing an endpoint requires confirmation, and endpoints with delivery history are disabled rather than detached from their audit relationship.

Limitations and notes

This package does not replace Yolfi’s payment infrastructure or decide application-specific prices, wallets, plans, or secret-storage locations. Those choices must come from the user. Full API keys should not be logged, committed, or written into the target project’s documentation.

The registration flow is for signup only. Existing Yolfi users should use browser authorization or local setup instead. Recurring or subscription-style links depend on account support. The provided MCP command is a local stdio server; the material does not document a hosted MCP endpoint.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Yolfi Agent

yolfinance/yolfi-agent is an MCP server that connects AI coding agents to Yolfi’s crypto payment API. Its main tools support workspace registration, authentication checks, payment-link and invoice creation, payment-status checks, settlement configuration, webhook management, and webhook signature verification for applications adding crypto checkout.

Install it with `npm install @yolfi/agent`, or start it without a project install using `npx -y @yolfi/agent mcp`. The package requires Node.js 18 or later and runs as a local stdio MCP server.

Use `npx -y @yolfi/agent setup --agent <name>`, complete the browser authorization URL, then run `checkin` and `auth:status`. Credentials are stored in the protected local Yolfi configuration. You can instead provide `YOLFI_API_KEY`, which takes precedence over stored credentials.

Yes. The README names Cursor as a supported agent workflow, and the package starts as a standard local stdio MCP server. Configure Cursor to launch `npx -y @yolfi/agent mcp` as its MCP command.

Related MCP servers

All in Finance & Fintech All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewYolfi Agent AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/yolfinance-yolfi-agent?style=directory)](https://allmcps.com/mcp/yolfinance-yolfi-agent)
HTML Embed
<a href="https://allmcps.com/mcp/yolfinance-yolfi-agent"><img src="https://allmcps.com/api/badge/yolfinance-yolfi-agent?style=directory" alt="Yolfi Agent on AllMCPs" /></a>