# Yolfi Payments MCP

Lets your coding agent create Yolfi paylinks, wire up crypto checkout and check payment status without touching the dashboard.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 177
- Author: yolfinance
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/yolfinance/yolfi-agent
- Updated: 2026-07-20
- HTML: https://affpapa.org/en/nevibecode/mcp/yolfi-payments-mcp

## What it does

Yolfi Payments MCP connects an agent to Yolfi's payment API: it registers a workspace, creates paylinks, configures webhooks and checks crypto payment status. The `@yolfi/agent` package ships an MCP server, a CLI, a JavaScript SDK and a `SKILL.md` skill, all JSON-first, so the agent calls tools instead of clicking through a dashboard.

You can run it remotely at `https://app.yolfi.com/mcp` or locally with `npx -y @yolfi/agent`. The local server needs `YOLFI_API_KEY` and `YOLFI_WEBHOOK_SECRET`; without them it cannot reach your workspace. Browser authorization stores the credential in `~/.yolfi/config.json` with `0700` and `0600` permissions, and `YOLFI_CONFIG_HOME` overrides that directory.

The skill sets the order of operations and the limits: the agent inspects the project and installs checkout on its own, but asks you for the wallet, price and currency. It must not invent wallet addresses or delete paylinks. Node.js 18+ is required, otherwise `npx` will not start the server.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://app.yolfi.com/mcp`
- Environment variables: `YOLFI_API_KEY`, `YOLFI_WEBHOOK_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http yolfi-agent https://app.yolfi.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env YOLFI_API_KEY=<YOLFI_API_KEY> --env YOLFI_WEBHOOK_SECRET=<YOLFI_WEBHOOK_SECRET> --transport stdio yolfi-payments-mcp -- npx -y @yolfi/agent
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add yolfi-payments-mcp --url https://app.yolfi.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add yolfi-payments-mcp --env YOLFI_API_KEY=<YOLFI_API_KEY> --env YOLFI_WEBHOOK_SECRET=<YOLFI_WEBHOOK_SECRET> -- npx -y @yolfi/agent
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yolfi-payments-mcp": {
            "url": "https://app.yolfi.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "yolfi-payments-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@yolfi/agent"
            ],
            "env": {
                "YOLFI_API_KEY": "<YOLFI_API_KEY>",
                "YOLFI_WEBHOOK_SECRET": "<YOLFI_WEBHOOK_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "yolfi-payments-mcp": {
            "type": "http",
            "url": "https://app.yolfi.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "yolfi-payments-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@yolfi/agent"
            ],
            "env": {
                "YOLFI_API_KEY": "<YOLFI_API_KEY>",
                "YOLFI_WEBHOOK_SECRET": "<YOLFI_WEBHOOK_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http yolfi-payments-mcp https://app.yolfi.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e YOLFI_API_KEY=<YOLFI_API_KEY> -e YOLFI_WEBHOOK_SECRET=<YOLFI_WEBHOOK_SECRET> yolfi-payments-mcp npx -y @yolfi/agent
```
Replace <…> with your own values

## When to use it
- accept stablecoin payments on a site
- create a payment link for a digital product
- check whether a crypto payment went through
- gate access behind a confirmed payment event
- verify the `X-Yolfi-Signature` header on a webhook

## Example prompts
- Add Yolfi crypto checkout to the payment page in `checkout.js`
- Create a paylink for 10 USDT for the item in `products.json`
- Check the payment status for that paylink and tell me if it cleared

## Similar
- [stripe-payments](https://affpapa.org/en/nevibecode/skills/jezweb-stripe-payments.md) — skill · 1100 installs
- [payments](https://affpapa.org/en/nevibecode/skills/payments.md) — skill · 5 installs
- [x402-payments](https://affpapa.org/en/nevibecode/skills/x402-payments.md) — skill · 462 installs
- [pluggy-payments](https://affpapa.org/en/nevibecode/skills/pluggy-payments.md) — skill · 386 installs
- [okx-agent-payments-protocol](https://affpapa.org/en/nevibecode/skills/okx-agent-payments-protocol.md) — skill · 13700 installs
- [Stripe Payments](https://affpapa.org/en/nevibecode/skills/stripe-payments.md) — skill · 4900 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md