Coinvello Ai MCP Server

CoinVello MCP server and AI kit

MCP server and integration kit for CoinVello, the non-custodial crypto payment processor: payments go straight to the merchant's own wallet on 11 networks (Bitcoin, Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Robinhood Chain, Solana, Tron; USDC, USDT and more), no KYC, fees are prepaid credits or a fixed on-chain split. Nothing here can move funds.

Documentation

• Website and AI setup: https://coinvello.com/ai
• Complete integration guide for LLMs: https://coinvello.com/llms-full.txt
• Developer docs and SDKs: https://coinvello.com/developers
• OpenAPI 3.1 reference: https://coinvello.com/.well-known/openapi.yaml
• npm: https://www.npmjs.com/package/@coinvello/mcp
• MCP Registry: io.github.CoinVello/coinvello

Installation

Get a cv_test_ API key at https://coinvello.com/app/settings.php (or use any cv_test_ string against the local mock server in api/reference-server), then add the server to your MCP client. Claude Desktop, Cursor, Windsurf and VS Code all take this block:

{
  "mcpServers": {
    "coinvello": {
      "command": "npx",
      "args": ["-y", "@coinvello/mcp"],
      "env": { "COINVELLO_API_KEY": "cv_test_..." }
    }
  }
}

Claude Code: claude mcp add coinvello -e COINVELLO_API_KEY=cv_test_... -- npx -y @coinvello/mcp. Live keys (cv_live_) are refused unless COINVELLO_ALLOW_LIVE=1. More clients and the Streamable HTTP mode: api/ai/mcp-server/README.md.

Screenshots

The server in the MCP Inspector, creating a checkout session against the local mock API, and the hosted payment page that session opens:

Tools

Every tool returns the raw API JSON (also as structuredContent). API errors come back as tool errors containing http_status, the CoinVello error envelope (type, code, message, request_id) and a hint.

Resources

Documents are bundled at build time; if missing they are fetched from coinvello.com.

Prompts

integrate-coinvello-into-<framework> for nextjs, express, fastapi, flask, django, laravel, rails, sinatra, go, woocommerce, shopify, generic, plus integrate-coinvello-into-framework with a free-form framework argument. Optional arguments: currency, assets. Each prompt tells the agent to read the guide resource, add a checkout route, a raw-body webhook route with signature verification and event.id dedupe, and to verify end to end with simulate_test_payment.

What else is in this repository

SDKs: npm install @coinvello/sdk; Python and PHP install commands are on https://coinvello.com/developers.

This repository is a read-only mirror, synced from CoinVello's main repository. Issues are welcome; security reports go to support@coinvello.com.