CoinVello

할 수 있는 일

이 서버는 아직 쉬운 말로 된 요약을 쓰지 못했어요. 아래는 레지스트리에서 읽어 온 사실이에요.

• 연결 방식: 컴퓨터 또는 클라우드
• 전송 방식: stdio, Streamable HTTP
• 카테고리: 온라인 쇼핑몰 및 결제
• 입력해야 할 값: COINVELLO_API_KEY, Authorization

설치

쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.

필요한 것

• 클라우드에서 실행설치할 것 없음. 인터넷으로 연결돼요
• npmNode.js 설치(npx 명령어용)

어떤 앱을 쓰세요?

{
  "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

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

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

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

{
  "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"
      }
    }
  }
}

선택한 앱은 이 기기의 쿠키에만 저장돼요. 계정은 필요 없어요.

직접 입력할 값

• 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월 7일 점검

• ✓ 통과

  제작자와 저장소 일치

  레지스트리 이름이 GitHub 계정 CoinVello 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요

• … 아직 점검 안 함

  계속 관리되고 있음

  아직 GitHub에서 이 저장소를 읽어 오지 않았어요

• … 아직 점검 안 함

  라이선스 있음

  아직 GitHub에서 이 저장소를 읽어 오지 않았어요

• ✓ 통과

  엔드포인트 응답

  419ms 만에 응답(HTTP 200)

• – 해당 없음

  OAuth로 로그인

  로그인 필요 없음

• ✓ 통과

  도구 설명에 숨겨진 지시 없음

  도구 설명 18개를 읽었고, AI에게 보내는 숨겨진 지시는 없었어요

온라인 쇼핑몰 및 결제 카테고리의 다른 서버와 비교i

• 이 카테고리의 다른 서버 1748개 중 0%보다 스타가 많아요
• 이 카테고리의 다른 서버 1748개 중 81%보다 최근에 레지스트리에 공개됐어요
• 기본 점검 결과가 이 카테고리의 다른 서버 1748개 중 100%와 같거나 더 좋아요

레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.

대안

같은 카테고리에서 다른 제작자가 만든 서버예요. 스타 순으로 정렬했어요.

카드 보는 법:★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i

제작자의 README

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

# from a checkout of this repo instead

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

{

claude mcp add coinvello -e COINVELLO_API_KEY=cv_test_... -- npx -y @coinvello/mcp

{

{

{

{

npm install