Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
CoinVello
ภาพรวม
คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)
Non-custodial crypto payments: checkout sessions, invoices, webhooks and test payments. No KYC.
สามเสาของ PopNx MCP
สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน
- เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
- ผลตรวจเบื้องต้นของเราiผ่าน 3 จาก 3 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
- การใช้งานiยังไม่ได้วัด★ –
ใช้ทำอะไรได้
ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry
- การเชื่อมต่อ: บนเครื่องหรือคลาวด์
- ช่องทาง (transport): stdio, Streamable HTTP
- หมวด: ร้านค้าออนไลน์และรับเงิน
- ต้องใส่ค่าเหล่านี้: COINVELLO_API_KEY, Authorization
ติดตั้ง
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ก่อนติดตั้ง
- ผลตรวจเบื้องต้น: ผ่าน 3 จาก 3 ข้อ
- รันบนเครื่องของผู้ทำ สิ่งที่คุณถามจะผ่านเครื่องของเขา
- ทำได้ 18 อย่าง (เครื่องมือ) create_checkout_session, get_invoice, list_invoices, list_payments …
- ค่าที่คุณต้องใส่เอง:
COINVELLO_API_KEY,COINVELLO_API_BASE,COINVELLO_ALLOW_LIVE,Authorization
ค่าที่ติดป้ายความลับคือกุญแจของบัญชีคุณ อย่าส่งให้ใคร และอย่าวางในแชต
ต้องเตรียมก่อน
- รันบนคลาวด์ไม่ต้องลงโปรแกรมเพิ่ม ต่อผ่านอินเทอร์เน็ตได้เลย
- npmติดตั้ง Node.js (มีคำสั่ง npx) ในเครื่อง
คุณใช้แอปไหน
เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”
ที่อยู่นี้ต้องใส่ key ใน header ของคำขอ ซึ่งเมนูเพิ่ม connector ใส่ให้ไม่ได้ ใช้ 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": "ใส่ค่าของคุณ",
"COINVELLO_API_BASE": "ใส่ค่าของคุณ",
"COINVELLO_ALLOW_LIVE": "ใส่ค่าของคุณ"
}
}
}
}พิมพ์คำสั่งนี้ใน Terminal
claude mcp add --transport http coinvello https://mcp.coinvello.com/mcp --header 'Authorization: ใส่ค่าของคุณ'หรือรันในเครื่องคุณ
claude mcp add coinvello --env COINVELLO_API_KEY='ใส่ค่าของคุณ' --env COINVELLO_API_BASE='ใส่ค่าของคุณ' --env COINVELLO_ALLOW_LIVE='ใส่ค่าของคุณ' -- npx -y @coinvello/mcpเติมค่าที่เว้นว่างไว้ก่อนรัน
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"coinvello": {
"url": "https://mcp.coinvello.com/mcp",
"headers": {
"Authorization": "ใส่ค่าของคุณ"
}
}
}
}หรือรันในเครื่องคุณ
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json
{
"mcpServers": {
"coinvello": {
"command": "npx",
"args": [
"-y",
"@coinvello/mcp"
],
"env": {
"COINVELLO_API_KEY": "ใส่ค่าของคุณ",
"COINVELLO_API_BASE": "ใส่ค่าของคุณ",
"COINVELLO_ALLOW_LIVE": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"coinvello": {
"type": "http",
"url": "https://mcp.coinvello.com/mcp",
"headers": {
"Authorization": "ใส่ค่าของคุณ"
}
}
}
}หรือรันในเครื่องคุณ
หรือคัดลอกค่าตั้งเอง
วางในไฟล์ .vscode/mcp.json ของโปรเจกต์
{
"servers": {
"coinvello": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@coinvello/mcp"
],
"env": {
"COINVELLO_API_KEY": "ใส่ค่าของคุณ",
"COINVELLO_API_BASE": "ใส่ค่าของคุณ",
"COINVELLO_ALLOW_LIVE": "ใส่ค่าของคุณ"
}
}
}
}เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง
ที่อยู่นี้ต้องใส่ key ใน header ของคำขอ ซึ่งเมนูเพิ่ม connector ใส่ให้ไม่ได้ ใช้ Claude Code, Cursor หรือ VS Code แทน
ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี
ค่าที่ต้องใส่เอง
- CoinVello API key. Use a cv_test_ key while developing; cv_live_ keys are refused unless COINVELLO_ALLOW_LIVE=1.
COINVELLO_API_BASEenvAPI base URL. Default https://api.coinvello.com/v1; http://localhost:4242/v1 for the local reference server.COINVELLO_ALLOW_LIVEenvSet to 1 to allow a live key.Authorizationความลับ จำเป็น HTTP headerBearer followed by your CoinVello API key, e.g. Bearer cv_test_... (test keys only on the hosted server).
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
ทำอะไรได้บ้าง
ชื่อและคำอธิบายเครื่องมือตามที่ server ตอบมาเมื่อ 6 พ.ย. 2569 ผู้ทำเป็นคนเขียน ไม่ใช่เรา แสดงเป็นข้อความล้วน
create_checkout_sessionCreate 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_invoiceRetrieve 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_invoicesList invoices, newest first, filterable by status, order_id or customer_email. Returns { object: 'list', data, has_more, next_cursor }.
list_paymentsList 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_walletRegister 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_walletsList 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_webhookRegister 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_signatureVerify 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_balanceReturn 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_bundlesList 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_purchaseCreate 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_recordsList 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_summarySales (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_exportCreate 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_exportRetrieve 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_ratesMid-market rates for supported assets against a fiat base (default USD). Indicative only; invoices lock their own rate at creation.
list_assetsEvery 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_paymentCreate 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
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 6 พ.ย. 2569
- ✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub CoinVello ซึ่งเป็นเจ้าของ repo
- … ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- … ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
- ✓ ผ่าน
endpoint ตอบ
ตอบกลับใน 419 ms (HTTP 200)
- – ไม่เกี่ยว
ล็อกอินแบบ OAuth
ไม่ต้องล็อกอิน
- ✓ ผ่าน
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
อ่านคำอธิบายเครื่องมือ 18 ตัวแล้ว ไม่พบคำสั่งแอบแฝงถึง AI
เทียบกับตัวอื่นในหมวด ร้านค้าออนไลน์และรับเงินi
- ดาวมากกว่า 0% ของอีก 1745 ตัวในหมวดนี้
- ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 81% ของอีก 1745 ตัวในหมวดนี้
- ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 1745 ตัวในหมวดนี้
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
คำถามที่พบบ่อย
CoinVello ปลอดภัยไหม?
จากการตรวจเบื้องต้นของเรา ผ่าน 3 จาก 3 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใช้กุญแจหรือรหัสอะไรบ้าง?
ต้องใส่ค่าเหล่านี้: COINVELLO_API_KEY, Authorization
ตัวนี้รันบนเครื่องหรือบนคลาวด์?
ได้ทั้งสองแบบ จะลงในเครื่องหรือต่อผ่านคลาวด์ก็ได้
ยังมีคนดูแลอยู่ไหม?
repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.1.4) เข้า registry 5 วันที่ผ่านมา
ใช้กับโปรแกรมไหนได้บ้าง?
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT ที่เปิดโหมดนักพัฒนา
มีตัวไหนใช้แทนได้บ้าง?
ในหมวดเดียวกันมี Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
ตัวที่ใช้แทนได้
server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว
อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Stripe MCP
server ทางการของ Stripe ให้ AI ดูและจัดการลูกค้า สินค้า การชำระเงิน และใบแจ้งหนี้ ต่อผ่านคลาวด์ของ Stripe และล็อกอินแบบ OAuth
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
README จากผู้ทำ
เปิดอ่าน README
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ 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 assistants | https://coinvello.com/ai |
| Complete integration guide (one file, written 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 |
| MCP Registry | io.github.CoinVello/coinvello |
| Source | https://github.com/CoinVello/coinvello-ai (api/ai/mcp-server) |
| Support | support@coinvello.com |
Configuration
| Variable | Required | Meaning |
|---|---|---|
COINVELLO_API_KEY | yes | cv_test_... from https://coinvello.com/app/settings.php (Settings -> API keys). Any cv_test_ string works against the local mock. |
COINVELLO_API_BASE | no | Default https://api.coinvello.com/v1. Use http://localhost:4242/v1 for the reference mock server. |
COINVELLO_ALLOW_LIVE | no | The server refuses to start with a `cv_live_` key unless this is 1. Agents should develop against test mode. |
COINVELLO_API_VERSION | no | Pins 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
| Tool | Does |
|---|---|
create_checkout_session | POST /checkout-sessions: hosted payment page; returns url to redirect to and invoice_id |
get_invoice | GET /invoices/{id} (or GET /checkout-sessions/{cs_id}?expand=invoice) |
list_invoices | GET /invoices with status / order_id / email filters |
list_payments | GET /payments with invoice_id / status / chain / tx_hash filters |
create_wallet | POST /wallets (xpub for BTC, address for EVM/Solana/Tron). Refuses xprv locally. |
list_wallets | GET /wallets |
create_webhook | POST /webhooks; returns the whsec_ secret once |
verify_webhook_signature | Local HMAC check of a CoinVello-Signature header against a raw body (no API call) |
get_credits_balance | GET /credits/balance |
list_credit_bundles | GET /credits/bundles |
create_credit_purchase | POST /credits/purchases; returns payment options + checkout_url |
get_rates | GET /rates |
list_assets | GET /assets (optional chain filter) |
simulate_test_payment | POST /test/simulate_payment (test keys only) |
list_records | GET /records: the book of record (payments, fees, credit purchases) valued when they happened; filters type / asset / chain / invoice / order / tx / dates / currency |
get_records_summary | GET /records/summary: sales, market value received, refunds, fees, net received for a period, optionally grouped |
create_export | POST /exports: CSV, Excel or JSON file of records or any dataset (QuickBooks, Xero, Koinly, CoinTracker, CoinLedger presets); returns the export with download_url |
get_export | GET /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
| URI | Content |
|---|---|
coinvello://docs/llms-full.txt | Complete single-file integration guide (auth, checkout, redirect, webhook verification, polling, credits, errors, examples in curl/Node/Python/PHP) |
coinvello://docs/llms.txt | Short llms.txt index |
coinvello://openapi.yaml | OpenAPI 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
list_assets-> pick assets the merchant can accept.create_webhookwith the app's/webhooks/coinvelloURL -> store the secret in the env file.- Write the code (see the
integrate-coinvello-into-*prompt orapi/ai/cookbook). create_checkout_session->simulate_test_paymentoninvoice_idwith enough confirmations.get_invoiceshowspaid; the app's webhook handler was called with a real signed event.verify_webhook_signatureto debug a handler that rejects deliveries.- Bookkeeping:
list_records(withinclude_simulated: truein test mode) ->get_records_summaryfor a period ->create_export(format: "xlsx") ->get_exportuntilready-> download thedownload_urland checkfile.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=1is a deliberate opt-in. - The server never logs the API key or webhook secrets. Tool output does include
secretfromcreate_webhookbecause that is the only time the API returns it. create_walletrejects 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