{"id":"io.github.CoinVello/coinvello","slug":"io-github-coinvello-coinvello","title":"CoinVello","description":"Non-custodial crypto payments: checkout sessions, invoices, webhooks and test payments. No KYC.","version":"0.1.4","publisher":{"kind":"github","id":"CoinVello","label":"@CoinVello on GitHub","url":"https://github.com/CoinVello"},"website":"https://coinvello.com/ai","repository":"https://github.com/CoinVello/coinvello-ai","remotes":[{"type":"streamable-http","url":"https://mcp.coinvello.com/mcp","headers":[{"description":"Bearer followed by your CoinVello API key, e.g. Bearer cv_test_... (test keys only on the hosted server).","isRequired":true,"isSecret":true,"name":"Authorization"}]}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@coinvello/mcp","version":"0.1.4","transport":{"type":"stdio"},"environmentVariables":[{"description":"CoinVello API key. Use a cv_test_ key while developing; cv_live_ keys are refused unless COINVELLO_ALLOW_LIVE=1.","isRequired":true,"format":"string","isSecret":true,"name":"COINVELLO_API_KEY"},{"description":"API base URL. Default https://api.coinvello.com/v1; http://localhost:4242/v1 for the local reference server.","format":"string","name":"COINVELLO_API_BASE"},{"description":"Set to 1 to allow a live key.","format":"boolean","name":"COINVELLO_ALLOW_LIVE"}]}],"published":"2026-11-01","updated":"2026-11-01","status":"online","auth":"","latency_ms":900,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"create_checkout_session","title":"Create a hosted checkout session","description":"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.paid webhook, never from the redirect.","read_only":false},{"name":"get_invoice","title":"Get an invoice","description":"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.","read_only":false},{"name":"list_invoices","title":"List invoices","description":"List invoices, newest first, filterable by status, order_id or customer_email. Returns { object: 'list', data, has_more, next_cursor }.","read_only":false},{"name":"list_payments","title":"List payments","description":"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.","read_only":false},{"name":"create_wallet","title":"Register a merchant wallet","description":"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 or seed phrase. The wallet is usable at once in live and test mode; addresses are validated strictly (format, checksum, n","read_only":false},{"name":"list_wallets","title":"List wallets","description":"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.","read_only":false},{"name":"create_webhook","title":"Create a webhook endpoint","description":"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\"].","read_only":false},{"name":"verify_webhook_signature","title":"Verify a CoinVello-Signature header","description":"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 \"<t>.<raw body>\", 300 s tolerance, constant-time compare against any v1. Returns valid=true/false with the reason and the parsed event. Set ignore_timestamp=true when checking an old captured deliv","read_only":false},{"name":"get_credits_balance","title":"Get processing-credit balance","description":"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 live credits. 1 credit = $0.01 nominal; a confirmed payment consumes about 30 bps of its fiat value (floor 2, cap 2000).","read_only":false},{"name":"list_credit_bundles","title":"List credit bundles","description":"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%).","read_only":false},{"name":"create_credit_purchase","title":"Buy credits (creates a crypto invoice)","description":"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 dashboard, not through this tool. In test mode credits are free, so this is mainly for exercising the flow (pay it with si","read_only":false},{"name":"list_records","title":"List accounting records","description":"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 the reporting currency, rate and source included), `value_usd`, `contract_value` (what the customer owed at the invoice's","read_only":false},{"name":"get_records_summary","title":"Get totals for a period","description":"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 occurred_at in the given timezone and currency. period_start is inclusive and period_end exclusive (a date such as 2026-01-0","read_only":false},{"name":"create_export","title":"Export records as CSV, Excel or JSON","description":"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 signed `download_url` valid until `download_expires_at` (files are kept 7 days); while `queued` or `processing` call get_","read_only":false},{"name":"get_export","title":"Get an export","description":"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.","read_only":false},{"name":"get_rates","title":"Get indicative exchange rates","description":"Mid-market rates for supported assets against a fiat base (default USD). Indicative only; invoices lock their own rate at creation.","read_only":false},{"name":"list_assets","title":"List supported assets","description":"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 without a testnet contract (DAI, usdc:bnb, usdt on base/arbitrum/optimism/avalanche/solana, and the Bitcoin tokens wbtc/cb","read_only":false},{"name":"simulate_test_payment","title":"Simulate a payment (test mode)","description":"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/larger amount to simulate underpaid/overpaid. Reuse tx_hash to advance the same payment.","read_only":false}],"server_info":{"name":"coinvello","version":"0.1.4"},"category":"finance","tags":["automation","crypto"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-31","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-coinvello-coinvello/"}