# Yolfi Payments MCP (MCP server)

> Yolfi Payments MCP is an MCP server that adds finance tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Let AI agents add Yolfi crypto checkout, paylinks, webhooks, and status checks. It has 178 GitHub stars, is released under the MIT license and runs locally with npx -y @yolfi/agent.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/yolfinance/yolfi-agent |
| GitHub stars | 178 |
| License | MIT |
| Language | JavaScript |
| Transport | stdio, streamable-http |
| Packages | npm: @yolfi/agent |
| Remote URL | https://app.yolfi.com/mcp |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code, Claude.ai, ChatGPT |
| Category | Finance |
| Latest release | v0.2.0 (Jul 20, 2026) |
| Last commit | Jul 20, 2026 |
| MCP registry name | io.github.yolfinance/yolfi-agent |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "yolfi-payments-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yolfi/agent"
      ],
      "env": {
        "YOLFI_API_KEY": "your-value",
        "YOLFI_WEBHOOK_SECRET": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env YOLFI_API_KEY=your-value --env YOLFI_WEBHOOK_SECRET=your-value --transport stdio yolfi-payments-mcp -- npx -y @yolfi/agent
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "yolfi-payments-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yolfi/agent"
      ],
      "env": {
        "YOLFI_API_KEY": "your-value",
        "YOLFI_WEBHOOK_SECRET": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "yolfi_api_key",
      "description": "YOLFI_API_KEY",
      "password": true
    },
    {
      "type": "promptString",
      "id": "yolfi_webhook_secret",
      "description": "YOLFI_WEBHOOK_SECRET",
      "password": true
    }
  ],
  "servers": {
    "yolfi-payments-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yolfi/agent"
      ],
      "env": {
        "YOLFI_API_KEY": "${input:yolfi_api_key}",
        "YOLFI_WEBHOOK_SECRET": "${input:yolfi_webhook_secret}"
      }
    }
  }
}
```

### Claude Code (remote)

```sh
claude mcp add --transport http yolfi-payments-mcp "https://app.yolfi.com/mcp"
```

The same server is also hosted as a remote MCP endpoint, so nothing runs on your machine.

Config formats checked against the official docs on 2026-10-07.

## Environment variables

- `YOLFI_API_KEY` (secret): Optional. Explicit environment credentials take precedence over the protected credential stored by yolfi setup/checkin. Private API tools require one of these…
- `YOLFI_WEBHOOK_SECRET` (secret): Optional override for webhook verification in CI or deployed environments. Local create/rotate tools otherwise use endpoint-specific secrets from the…

## Similar MCP servers

- [CCXT](https://appsgit.com/mcp-servers/ccxt): Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets. (44,271 stars, MIT, official)
- [Finance Toolkit](https://appsgit.com/mcp-servers/finance-toolkit): 200+ transparent financial metrics calculated from raw statements, not third-party endpoints. (5,402 stars, MIT, needs API key)
- [Tradingview MCP](https://appsgit.com/mcp-servers/tradingview-mcp): Real-time market data, screeners, technical analysis & backtesting for stocks, crypto and forex. (4,948 stars, MIT)
- [EdgarTools](https://appsgit.com/mcp-servers/edgartools): Open-source SEC EDGAR toolkit — 13 tools, 7 prompts, every filing type. (2,776 stars, MIT)
- [AI](https://appsgit.com/mcp-servers/ai): MCP server integrating with Stripe - tools for customers, products, payments, and more. (1,859 stars, MIT, official)
- [Tradememory Protocol](https://appsgit.com/mcp-servers/tradememory-protocol): Tamper-evident decision audit trail and outcome-weighted memory for AI trading agents. (1,425 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/yolfi-payments-mcp
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
