プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。レビューとアカウント機能は今後のステップで始まります。
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

CoinVello

作者:CoinVelloバージョン 0.1.4i★ –iパソコンでもクラウドでも
レジストリ名io.github.CoinVello/coinvello

インストール

概要

作者による説明(英語の原文)

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

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

  • 接続方法: パソコンでもクラウドでも
  • トランスポート: stdio, Streamable HTTP
  • カテゴリ: 暗号資産・ブロックチェーン
  • 入力が必要なもの:COINVELLO_API_KEY, Authorization

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

  • クラウドで動くインストール不要。インターネット経由でつながります
  • npmNode.jsのインストール(npxコマンドに必要)

どのアプリを使っていますか?

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

このアドレスはリクエストの header にキーが必要ですが、コネクタを追加するメニューでは設定できません。代わりにClaude Code、Cursor、VS Codeを使ってください。

または、パソコンで動かす

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

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

ターミナルでこれを実行します

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

または、パソコンで動かす

claude mcp add coinvello --env COINVELLO_API_KEY=your-value --env COINVELLO_API_BASE=your-value --env COINVELLO_ALLOW_LIVE=your-value -- npx -y @coinvello/mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

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

または、パソコンで動かす

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

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

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

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

または、パソコンで動かす

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

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

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

このアドレスはリクエストの header にキーが必要ですが、コネクタを追加するメニューでは設定できません。代わりにClaude Code、Cursor、VS Codeを使ってください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

  • COINVELLO_API_KEY 秘密 必須 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 秘密 必須 HTTP header
    Bearer followed by your CoinVello API key, e.g. Bearer cv_test_... (test keys only on the hosted server).

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

ツールの名前と説明は、サーバーが2026年11月6日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

  • 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

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月9日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント CoinVello で確認済みです

  • … 未チェック

    今もメンテナンスされている

    このリポジトリはまだGitHubから読み取っていません

  • … 未チェック

    ライセンスがある

    このリポジトリはまだGitHubから読み取っていません

  • ✓ 合格

    エンドポイントが応答する

    419ミリ秒で応答(HTTP 200)

  • – 対象外

    OAuthでサインイン

    サインイン不要

  • ✓ 合格

    ツールの説明に隠れた指示がない

    18件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

暗号資産・ブロックチェーンのほかのサーバーとの比較i

  • このカテゴリのほかの1624件のうち0%よりスターが多い
  • このカテゴリのほかの1624件のうち88%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1624件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

CoinVelloは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:COINVELLO_API_KEY, Authorization

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は–、最新バージョン(0.1.4)がレジストリに届いたのは8 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ(開発者モードのChatGPTなど)でも使えます。

代わりに使えるものは?

同じカテゴリには:make.fun, Highwire, Verdict: DeFi risk ratings

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

make.fun

Earn USDC on Solana by winning coding bounties: find a bounty, track entries, claim rewards.

作者:makedotfun初期今日更新

クラウドで動く✓ make.fun

Highwire

Trade, launch and research higher.fun coins on Solana, from any AI agent. Unsigned or policy-signed.

作者:HigherMaestro成長中↓ 1729/週今日更新

パソコンでもクラウドでも✓ highwire.fun

Verdict: DeFi risk ratings

Verdict, the security marketplace for DeFi: keyless ratings, methodology and a hack incident feed.

作者:Verdict-Capitalとても新しい↓ 71/週今日更新

パソコンで動く

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

@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

PopNxに聞く