Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

CoinVello

de CoinVelloversión 0.1.4i★ 0iComputadora o nube
Nombre en el registroio.github.CoinVello/coinvello

Cómo instalar

What it does

Non-custodial crypto payments: checkout sessions, invoices, webhooks and test payments. No KYC.

  • Connects Computadora o nube
  • Account or key Cloud: Needs Authorization · Local: Needs COINVELLO_API_KEY
  • Category Cripto y blockchain

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (mcp.coinvello.com) · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 5 min

Necesitas una clave de CoinVello (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Regístrate y crea una clave de CoinVello

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de CoinVello ↗

  2. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreCoinVello
    Remote MCP server URL · Direcciónhttps://mcp.coinvello.com/mcp

    En Request headers, añade este nombre y valor

    Nombre del headerAuthorization
    ValorBearer <pega tu clave aquí>

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  4. Actívalo en un chat

    +ConnectorsCoinVello

  5. Pruébalo

    Usa CoinVello y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando CoinVello o muestra una herramienta de CoinVello en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar CoinVello

CoinVello necesita tu propia clave para conectarse, pero la ayuda de OpenAI solo describe el inicio de sesión con OAuth; no hay una opción de clave que hayamos podido verificar

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar CoinVello

  • Necesitas una clave de CoinVello (créala en el sitio del autor) · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner
  • Necesitas una clave de CoinVello (créala en el sitio del autor)
  • Necesitas una clave de CoinVello (créala en el sitio del autor)
  • Necesitas una clave de CoinVello (créala en el sitio del autor)

B · Otros en Cripto y blockchain que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code · unos 5 min

Necesitas una clave de CoinVello (créala en el sitio del autor)

  1. Regístrate y crea una clave de CoinVello

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de CoinVello ↗

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user coinvello https://mcp.coinvello.com/mcp --header 'Authorization: Bearer your-value'

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Escribe /mcp en Claude Code

    Deberías ver CoinVello en la lista como conectado

  5. Pruébalo

    Usa CoinVello y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando CoinVello o muestra una herramienta de CoinVello en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 5 min

Necesitas una clave de CoinVello (créala en el sitio del autor)

  1. Regístrate y crea una clave de CoinVello

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de CoinVello ↗

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de CoinVello, Authorization está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de Cursor en modo Agent

  5. Pruébalo

    Usa CoinVello y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando CoinVello o muestra una herramienta de CoinVello en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 5 min

Necesitas una clave de CoinVello (créala en el sitio del autor)

  1. Regístrate y crea una clave de CoinVello

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Abrir el sitio de CoinVello ↗

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Escribe tu clave

    En la configuración de CoinVello, Authorization está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  4. Abre el chat de IA de VS Code en modo Agent

  5. Pruébalo

    Usa CoinVello y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando CoinVello o muestra una herramienta de CoinVello en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://mcp.coinvello.com/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa CoinVello💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user coinvello https://mcp.coinvello.com/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "coinvello": {
      "url": "https://mcp.coinvello.com/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "coinvello": {
      "type": "http",
      "url": "https://mcp.coinvello.com/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

Instalado en tu computadora

Claude Code

claude mcp add --scope user coinvello --env COINVELLO_API_KEY=your-value -- npx -y @coinvello/mcp

Claude Desktop (claude_desktop_config.json)

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

Cursor (~/.cursor/mcp.json)

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

VS Code (mcp.json)

{
  "servers": {
    "coinvello": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@coinvello/mcp"
      ],
      "env": {
        "COINVELLO_API_KEY": "your-value"
      }
    }
  }
}

Valores que debes completar

  • COINVELLO_API_KEY secreto obligatorio env
    CoinVello API key. Use a cv_test_ key while developing; cv_live_ keys are refused unless COINVELLO_ALLOW_LIVE=1.
  • COINVELLO_API_BASE env
    API base URL. Default https://api.coinvello.com/v1; http://localhost:4242/v1 for the local reference server.
  • COINVELLO_ALLOW_LIVE env
    Set to 1 to allow a live key.
  • Authorization secreto obligatorio HTTP header
    Bearer followed by your CoinVello API key, e.g. Bearer cv_test_... (test keys only on the hosted server).

Las descripciones siguen en el inglés original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
193/sem
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.1.4
Publicado en el registroi
1 nov 2026
Último cambio de códigoi
4 nov 2026
Creador
CoinVello
Paquetes
npm: @coinvello/mcp
Sitio web
coinvello.com
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 11 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • create_checkout_session

    Create a CoinVello hosted checkout session (an invoice plus a payment page at pay.coinvello.com). Redirect the customer to the returned `url`. Amounts are decimal strings. `currency` is an ISO code (USD, EUR...) or an asset id to price in crypto. Fulfil orders from the invoice.pa

  • get_invoice

    Retrieve an invoice (inv_...) with its status, payment_options (address, amount, payment_uri, qr_payload) and paid summary. Use for polling or reconciliation. Accepts a checkout session id (cs_...) too and returns the session with the invoice expanded.

  • list_invoices

    List invoices, newest first, filterable by status, order_id or customer_email. Returns { object: 'list', data, has_more, next_cursor }.

  • list_payments

    List on-chain payments (pay_...) with tx_hash, confirmations, amount and status (detected, confirming, confirmed, failed). Filter by invoice_id, status, chain or tx_hash.

  • create_wallet

    Register a receiving wallet the merchant controls. type=xpub for bitcoin (CoinVello derives a fresh address per invoice from the extended PUBLIC key); type=address for ethereum, base, arbitrum, optimism, polygon, bnb, avalanche, robinhood, solana, tron. Never pass a private key o

  • list_wallets

    List registered wallets with chain, type, status (active/verified/archived) and accepted assets. Use it to see which assets can be offered on an invoice.

  • create_webhook

    Register a webhook endpoint. The response contains `secret` (whsec_...) ONCE: store it as COINVELLO_WEBHOOK_SECRET. Live endpoints must be HTTPS; test endpoints may be http://localhost. Use events ["*"] for everything or a list such as ["invoice.paid","invoice.expired"].

  • verify_webhook_signature

    Verify a webhook delivery locally (no API call). Pass the exact raw request body, the CoinVello-Signature header (t=...,v1=...) and the endpoint secret (whsec_...). Implements the spec: HMAC-SHA256 over " . ", 300 s tolerance, constant-time compare against any v1. Returns valid=t

  • get_credits_balance

    Return the merchant's prepaid processing-credit balance: balance (= available + reserved, never negative), available (free to spend), reserved (estimated fees of open invoices paid with credits), low_balance_threshold, estimated_payments_remaining, auto_topup. There are no free l

  • list_credit_bundles

    List purchasable credit bundles with USD price, price_per_credit and indicative crypto_prices per asset. Bigger bundles cost less per credit (effective rate ~0.30% down to <0.10%).

  • create_credit_purchase

    Create a crypto credit purchase (cpu_...). Returns payment.payment_options with the address/amount to pay (CoinVello's operator wallet) and a hosted checkout_url. Credits are added when the payment confirms. Card purchases and automatic top-up are set up by the merchant in the da

  • list_records

    List the account's book of record, newest first: one immutable row per movement of value (payment_received, fee_prepaid, credit_purchase, refund_sent, fee_onchain, conversion, offramp_payout...) valued when it happened. Each record has `value` (market value at the block time in t

  • get_records_summary

    Sales (invoiced at the locked rates), received_market_value (what the coins were worth when they landed), valuation_difference, tax_collected, refunds, fees_prepaid and credits_consumed, fees_onchain, network_fees, credit_purchases and net_received, with payment counts, over occu

  • create_export

    Create an export of the records (default), another dataset, or `all` (the year-end package) for a period, or for the entire history when period is null or omitted. Returns the export object: small exports are already `ready` with `file` (name, content_type, bytes, sha256) and a s

  • get_export

    Retrieve an export (exp_...): status (queued, processing, ready, failed, expired), rows, file { name, content_type, bytes, sha256 }, download_url and download_expires_at, failure_reason. Poll after create_export until ready.

  • get_rates

    Mid-market rates for supported assets against a fiat base (default USD). Indicative only; invoices lock their own rate at creation.

  • list_assets

    Every asset CoinVello accepts in the API key's mode: id (btc:bitcoin, usdc:polygon, eurc:base...), symbol, chain, kind (native/token), contract_address, decimals, required_confirmations, min_amount, testnet name and the wallet_type (xpub or address) needed to accept it. Tokens wi

  • simulate_test_payment

    Create a synthetic on-chain payment for an invoice (inv_) or credit purchase (cpu_) and run it through the real state machine and webhook pipeline. Test keys only. confirmations=0 -> payment.detected / invoice.pending; confirmations >= required -> invoice.paid. Use a smaller/larg

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 14 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub CoinVello, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 10 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 600 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 18 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Cripto y blockchaini

  • Más estrellas que el 0% de los otros 1683 servidores de esta categoría
  • Publicado en el registro más recientemente que el 80% de los otros 1683 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 100% de los otros 1683 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro CoinVello?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: Authorization, COINVELLO_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 10 días, y la última versión (0.1.4) llegó al registro hace 13 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: Solana MCP by Vybe, Oracle3 prediction-market arbitrage checks, Polymarket Paper Trader

Otros de la misma categoría

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Solana MCP by Vybe

Solana MCP developer toolkit: wallets, trades, markets, PnL, transfers, onchain, swaps & API tools.

de vybenetworkEn crecimiento★ 2,7 mil Estrellas de todo el repositorioActualizado hace 6 meses

Se ejecuta en la nube

Oracle3 prediction-market arbitrage checks

Kalshi and Polymarket data, venue fees, no-arbitrage checks and paper execution for AI agents.

de YichengYang-EthanEn crecimiento↓ 35/sem★ 569Actualizado hace 44 días

Se ejecuta en tu computadora

Polymarket Paper Trader

Polymarket paper trading for AI agents: $10k paper money, real order books, official fees.

de agent-nextEn crecimiento↓ 226/sem★ 507Actualizado hace 29 días

Se ejecuta en tu computadora

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

@coinvello/mcp

Model Context Protocol server for the CoinVello API, the non-custodial crypto payment processor (no KYC, merchant keeps the keys, fees as prepaid credits, 11 networks).

Give Claude, Cursor, Windsurf, ChatGPT or any MCP client the ability to create checkout sessions, inspect invoices and payments, register webhooks, verify webhook signatures, manage credits and simulate test payments while it writes your integration.

npx -y @coinvello/mcp            # stdio (what every desktop client uses)

npx -y @coinvello/mcp --http 3333 # Streamable HTTP on http://127.0.0.1:3333/mcp

# from a checkout of this repo instead

npm install && npm run build && node dist/index.js

Hosted (nothing to install)

https://mcp.coinvello.com/mcp runs this server for you over Streamable HTTP. Send your own key with every request as Authorization: Bearer cv_test_... (or X-CoinVello-Api-Key, or an api_key setting in clients that only take query parameters). The hosted server stores nothing, accepts test keys only, and never logs keys. Run it yourself with npx -y @coinvello/mcp --http --hosted.

{ "mcpServers": { "coinvello": { "url": "https://mcp.coinvello.com/mcp", "headers": { "Authorization": "Bearer cv_test_..." } } } }

Documentation

Website and setup for AI assistantshttps://coinvello.com/ai
Complete integration guide (one file, written for LLMs)https://coinvello.com/llms-full.txt
Developer docs and SDKshttps://coinvello.com/developers
OpenAPI 3.1 referencehttps://coinvello.com/.well-known/openapi.yaml
MCP Registryio.github.CoinVello/coinvello
Sourcehttps://github.com/CoinVello/coinvello-ai (api/ai/mcp-server)
Supportsupport@coinvello.com

Configuration

VariableRequiredMeaning
COINVELLO_API_KEYyescv_test_... from https://coinvello.com/app/settings.php (Settings -> API keys). Any cv_test_ string works against the local mock.
COINVELLO_API_BASEnoDefault https://api.coinvello.com/v1. Use http://localhost:4242/v1 for the reference mock server.
COINVELLO_ALLOW_LIVEnoThe server refuses to start with a `cv_live_` key unless this is 1. Agents should develop against test mode.
COINVELLO_API_VERSIONnoPins CoinVello-Version (default: account version, currently 2026-10-01).

Client setup

Claude Desktop

claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\):

{

"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

or in .mcp.json at the project root (shared with the team, key via env):

{

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

Cursor

.cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

{

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

Windsurf

~/.codeium/windsurf/mcp_config.json:

{

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

VS Code (Copilot agent mode)

.vscode/mcp.json:

{

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

Remote / HTTP clients (ChatGPT connectors, hosted agents)

Run coinvello-mcp --http 3333 behind your own HTTPS reverse proxy and point the client at https://your-host/mcp. The HTTP mode is stateless (one server instance per request) and binds to 127.0.0.1 by default (MCP_HTTP_HOST=0.0.0.0 to change). It uses the key from the environment, so put it behind authentication: it is meant for your own agents, not the public.

Tools

ToolDoes
create_checkout_sessionPOST /checkout-sessions: hosted payment page; returns url to redirect to and invoice_id
get_invoiceGET /invoices/{id} (or GET /checkout-sessions/{cs_id}?expand=invoice)
list_invoicesGET /invoices with status / order_id / email filters
list_paymentsGET /payments with invoice_id / status / chain / tx_hash filters
create_walletPOST /wallets (xpub for BTC, address for EVM/Solana/Tron). Refuses xprv locally.
list_walletsGET /wallets
create_webhookPOST /webhooks; returns the whsec_ secret once
verify_webhook_signatureLocal HMAC check of a CoinVello-Signature header against a raw body (no API call)
get_credits_balanceGET /credits/balance
list_credit_bundlesGET /credits/bundles
create_credit_purchasePOST /credits/purchases; returns payment options + checkout_url
get_ratesGET /rates
list_assetsGET /assets (optional chain filter)
simulate_test_paymentPOST /test/simulate_payment (test keys only)
list_recordsGET /records: the book of record (payments, fees, credit purchases) valued when they happened; filters type / asset / chain / invoice / order / tx / dates / currency
get_records_summaryGET /records/summary: sales, market value received, refunds, fees, net received for a period, optionally grouped
create_exportPOST /exports: CSV, Excel or JSON file of records or any dataset (QuickBooks, Xero, Koinly, CoinTracker, CoinLedger presets); returns the export with download_url
get_exportGET /exports/{id}: poll status until ready, read file.sha256 and download_url

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

URIContent
coinvello://docs/llms-full.txtComplete single-file integration guide (auth, checkout, redirect, webhook verification, polling, credits, errors, examples in curl/Node/Python/PHP)
coinvello://docs/llms.txtShort llms.txt index
coinvello://openapi.yamlOpenAPI 3.1 specification

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

Prompts

integrate-coinvello-into- 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.

Typical agent session

  1. list_assets -> pick assets the merchant can accept.
  2. create_webhook with the app's /webhooks/coinvello URL -> store the secret in the env file.
  3. Write the code (see the integrate-coinvello-into-* prompt or api/ai/cookbook).
  4. create_checkout_session -> simulate_test_payment on invoice_id with enough confirmations.
  5. get_invoice shows paid; the app's webhook handler was called with a real signed event.
  6. verify_webhook_signature to debug a handler that rejects deliveries.
  7. Bookkeeping: list_records (with include_simulated: true in test mode) -> get_records_summary for a period -> create_export (format: "xlsx") -> get_export until ready -> download the download_url and check file.sha256.

Development

npm install

npm run build # copies docs into dist/docs and compiles TypeScript npm test # smoke test against the mock: needs api/reference-server running on :4242 npm run dev # tsx src/index.ts (stdio)

Smoke test: cd api/reference-server && npm install && npm start, then COINVELLO_API_BASE=http://localhost:4242/v1 npm test here. It exercises all 18 tools, the three resources and the prompts, verifies a real signed delivery captured by the mock's webhook sink, and checks the xprv guard. The mock does not implement wallet CRUD, so create_wallet / list_wallets are expected to return a clean 404 tool error there.

Security notes

  • Keep the server on test keys while an agent is writing code. COINVELLO_ALLOW_LIVE=1 is a deliberate opt-in.
  • The server never logs the API key or webhook secrets. Tool output does include secret from create_webhook because that is the only time the API returns it.
  • create_wallet rejects anything that looks like an extended private key before it leaves the machine.
  • Nothing here moves funds: CoinVello is non-custodial, and the API has no "send" operation.

License MIT. Source: https://github.com/CoinVello/coinvello-ai (mirror). Issues: https://github.com/CoinVello/coinvello-ai/issues or support@coinvello.com