Yolfi Payments MCP Server

by yolfinanceio.github.yolfinance/yolfi-agentv0.2.0

Yolfi Payments integration: register workspaces, create crypto checkout links, configure and verify webhooks and check payment status.

178Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install Yolfi Payments MCP server

claude mcp add agent-yolfinance -e YOLFI_API_KEY='<yolfi-api-key>' -e YOLFI_WEBHOOK_SECRET='<yolfi-webhook-secret>' -- npx -y @yolfi/agent mcp

{
  "mcpServers": {
    "agent-yolfinance": {
      "command": "npx",
      "args": [
        "-y",
        "@yolfi/agent",
        "mcp"
      ],
      "env": {
        "YOLFI_API_KEY": "<yolfi-api-key>",
        "YOLFI_WEBHOOK_SECRET": "<yolfi-webhook-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "agent-yolfinance": {
      "command": "npx",
      "args": [
        "-y",
        "@yolfi/agent",
        "mcp"
      ],
      "env": {
        "YOLFI_API_KEY": "<yolfi-api-key>",
        "YOLFI_WEBHOOK_SECRET": "<yolfi-webhook-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "agent-yolfinance": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yolfi/agent",
        "mcp"
      ],
      "env": {
        "YOLFI_API_KEY": "<yolfi-api-key>",
        "YOLFI_WEBHOOK_SECRET": "<yolfi-webhook-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "agent-yolfinance": {
      "command": "npx",
      "args": [
        "-y",
        "@yolfi/agent",
        "mcp"
      ],
      "env": {
        "YOLFI_API_KEY": "<yolfi-api-key>",
        "YOLFI_WEBHOOK_SECRET": "<yolfi-webhook-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
YOLFI_API_KEY	—	yes	Optional. Explicit environment credentials take precedence over the protected credential stored by yolfi setup/checkin. Private API tools require one of these credentials.
YOLFI_WEBHOOK_SECRET	—	yes	Optional override for webhook verification in CI or deployed environments. Local create/rotate tools otherwise use endpoint-specific secrets from the protected Yolfi config.

Remote endpoints

streamable-httphttps://app.yolfi.com/mcp

Freshness

Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-20 · 3mo ago · GitHub
Latest release
2026-07-20 · 3mo ago · GitHub · v0.2.0
Package published
no data · npm/PyPI
Registry entry updated
2026-07-21 · 3mo ago · official registry · v0.2.0

FAQ

›How do I install the Yolfi Payments MCP server in Claude Code?

Run: claude mcp add agent-yolfinance -e YOLFI_API_KEY='<yolfi-api-key>' -e YOLFI_WEBHOOK_SECRET='<yolfi-webhook-secret>' -- npx -y @yolfi/agent mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Yolfi Payments require an API key?

Yes. It expects YOLFI_API_KEY, YOLFI_WEBHOOK_SECRET, of which 2 are secrets.

›Can I use Yolfi Payments as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Yolfi Payments in the official MCP registry?

Yes, as io.github.yolfinance/yolfi-agent.