SnapEX Pay

resmi

Pembayaran kripto untuk agen AI: akun mandiri, faktur, penerimaan pembayaran, pencairan, penukaran.

Apa yang bisa Anda lakukan dengan SnapEX Pay MCP?

Buka akun merchant — Minta agen memanggil create_account untuk mendapatkan api_key, login/password kabinet, dan mcp_personal_url tanpa captcha atau email.
Buat dan lacak invoice — Gunakan create_invoice untuk mendapatkan pay_url bagi pembayar, lalu polling get_invoice hingga berstatus paid; mode pengujian berjalan tanpa uang sungguhan.
Kirim pembayaran kripto dengan aman — Dapatkan kuotasi dengan preview_payout, lalu panggil create_payout menggunakan preview_id dan idempotency_key agar percobaan ulang tidak pernah membayar dua kali.
Periksa katalog dan biaya — Panggil list_assets, get_fiat_rates, get_fees, dan list_static_address_networks sebelum kunci apa pun diperlukan.
Konversi aset yang dimiliki — Dapatkan kuotasi dengan preview_conversion dan eksekusi dengan create_conversion untuk menukar aset lain menjadi saldo USDT.

Server MCP Terhosting

npx add-mcp 'https://pay.snapex.pro/mcp'

Terpasang ke Claude Code, Codex, Cursor, dan lainnya

Dokumentasi

Server MCP SnapEX Pay

Server MCP untuk pembayaran kripto: agen AI membuka akun merchant sendiri dan menerima, mengirim, serta menukar kripto.

Server MCP SnapEX Pay memungkinkan agen AI menangani pembayaran kripto tanpa campur tangan manusia. Agen terhubung ke https://pay.snapex.pro/mcp,, membuka akun merchant SnapEX Pay sendiri (tanpa captcha, tanpa email), lalu mendapatkan kunci API. Setelah itu, agen dapat membuat invoice dengan halaman pembayaran yang dihosting, menerima kripto di alamat deposit permanen, menyimpan saldo USDT, mengirim pembayaran dalam berbagai koin dan jaringan, serta mengelola webhook. Mode pengujian menjalankan seluruh alur tanpa uang sungguhan. Pembayaran selalu diawali dengan pratinjau gratis dan menggunakan kunci idempotensi, sehingga percobaan ulang tidak akan membayar dua kali. Server jarak jauh (Streamable HTTP) atau paket lokal: npx -y snapex-pay-mcp.

Server jarak jauh (disarankan, tidak perlu instalasi): https://pay.snapex.pro/mcp — Streamable HTTP.
Paket stdio lokal: npx -y snapex-pay-mcp — alat yang sama, klien tipis untuk API yang sama.
Docker: docker build -t snapex-pay-mcp . && docker run -i --rm snapex-pay-mcp.
Nama MCP Registry: pro.snapex/pay.
Dokumentasi untuk pengguna: https://pay.snapex.pro/mcp · Referensi REST: https://pay.snapex.pro/partner/merchant/docs · kartu server: https://pay.snapex.pro/.well-known/mcp.json · https://pay.snapex.pro/llms.txt
Kebijakan privasi: https://pay.snapex.pro/privacy · Ketentuan: https://pay.snapex.pro/terms · Aturan untuk merchant: https://pay.snapex.pro/rules · Dukungan: https://pay.snapex.pro/#chat

Cara agen menggunakannya

Hubungkan tanpa kunci. Alat katalog (list_assets, get_fiat_rates, get_fees, list_static_address_networks) langsung dapat digunakan.
Panggil create_account. Alat ini mengembalikan api_key (ditampilkan sekali), login/password untuk seseorang, dan mcp_personal_url. Kunci baru langsung digunakan: di server jarak jauh untuk sisa sesi MCP, di paket stdio untuk proses tersebut (dan disimpan ke ~/.config/snapex-pay/credentials.json untuk penggunaan berikutnya).
Terima pembayaran: create_invoice → berikan pay_url kepada pembayar → get_invoice hingga paid. environment: "test" menjalankan seluruh alur tanpa uang sungguhan (invoice uji berubah menjadi berstatus lunas ~10 dtk setelah koin dipilih; saldo tidak berubah).
Kirim pembayaran: preview_payout (kuotasi gratis) → create_payout dengan preview_id dan idempotency_key milik Anda (tidak dapat dibatalkan; percobaan ulang dengan kunci yang sama tidak akan membayar dua kali).
Saldo disimpan dalam USDT: untuk mendapatkan koin lain, lakukan pembayaran dalam koin tersebut. preview_conversion → create_conversion mengonversi aset lain yang masih dimiliki akun lama.

Setiap jawaban kesalahan menjelaskan tindakan selanjutnya (what_to_do), misalnya unauthorized → panggil create_account; rate_limited → tunggu retry_after_seconds.

Hubungkan

Claude Code

claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp
# with an existing key:
claude mcp add --transport http snapex-pay https://pay.snapex.pro/mcp --header "Authorization: Bearer smk_…"

Cursor — `~/.cursor/mcp.json`

{
  "mcpServers": {
    "snapex-pay": { "url": "https://pay.snapex.pro/mcp" }
  }
}

Tambahkan "headers": { "Authorization": "Bearer smk_…" } agar satu akun tetap digunakan di berbagai sesi.

VS Code — `.vscode/mcp.json`

{
  "servers": {
    "snapex-pay": { "type": "http", "url": "https://pay.snapex.pro/mcp" }
  }
}

Windsurf — `~/.codeium/windsurf/mcp_config.json`

{
  "mcpServers": {
    "snapex-pay": { "serverUrl": "https://pay.snapex.pro/mcp" }
  }
}

Cline — `cline_mcp_settings.json`

{
  "mcpServers": {
    "snapex-pay": { "type": "streamableHttp", "url": "https://pay.snapex.pro/mcp" }
  }
}

Panduan langkah demi langkah untuk penginstal AI: llms-install.md.

Gemini CLI

Sebagai ekstensi (repositori ini memiliki gemini-extension.json):

gemini extensions install https://github.com/snapexpay/snapex-pay-mcp

atau di ~/.gemini/settings.json:

{
  "mcpServers": {
    "snapex-pay": { "httpUrl": "https://pay.snapex.pro/mcp" }
  }
}

Claude Desktop — `claude_desktop_config.json`

Server jarak jauh melalui mcp-remote:

{
  "mcpServers": {
    "snapex-pay": { "command": "npx", "args": ["-y", "mcp-remote", "https://pay.snapex.pro/mcp"] }
  }
}

atau paket lokal:

{
  "mcpServers": {
    "snapex-pay": {
      "command": "npx",
      "args": ["-y", "snapex-pay-mcp"],
      "env": { "SNAPEX_API_KEY": "smk_…" }
    }
  }
}

(SNAPEX_API_KEY bersifat opsional: tanpanya, agen akan memanggil create_account dan kunci disimpan untuk penggunaan berikutnya.)

Konektor claude.ai dan ChatGPT

Tambahkan konektor khusus dengan URL https://pay.snapex.pro/mcp tanpa autentikasi. Klien ini tidak dapat mengirim header, jadi setelah create_account, ambil mcp_personal_url dari jawabannya (juga dikembalikan oleh get_account) dan gunakan sebagai URL konektor — setiap obrolan baru kemudian menggunakan akun yang sama. URL tersebut berisi kredensial: perlakukan seperti kata sandi.

OpenAI Responses API

{
  "type": "mcp",
  "server_label": "snapex_pay",
  "server_url": "https://pay.snapex.pro/mcp",
  "headers": { "Authorization": "Bearer smk_…" },
  "require_approval": { "always": { "tool_names": ["create_payout", "create_conversion"] } }
}

Klien dan katalog lainnya

Repositori ini menyertakan manifes yang dibaca oleh katalog: server.json (MCP Registry resmi), glama.json (Glama), gemini-extension.json + GEMINI.md (Gemini CLI), lhm.plugin.json (LobeHub), .cursor-plugin/plugin.json + mcp.json (Cursor Marketplace), plugin.json (Agent Plugins / Kiro), llms-install.md (Cline).

Docker

docker build -t snapex-pay-mcp .
docker run -i --rm -e SNAPEX_API_KEY=smk_… snapex-pay-mcp

Alat

Akun

Alat	Fungsinya
`create_account`	Membuka akun SnapEX Pay (tanpa captcha)
`get_account`	Menampilkan akun dan kunci saat ini

Katalog (tidak perlu kunci)

Alat	Fungsinya
`list_assets`	Menampilkan daftar koin dan jaringan
`get_fiat_rates`	Kurs mata uang fiat
`get_fees`	Kuotasi biaya rute saat ini
`list_static_address_networks`	Jaringan untuk alamat permanen

Saldo

Alat	Fungsinya
`get_balances`	Saldo akun
`list_transactions`	Riwayat saldo

Terima pembayaran

Alat	Fungsinya
`create_invoice`	Membuat invoice (menerima kripto)
`get_invoice`	Status invoice
`list_invoices`	Menampilkan daftar invoice
`get_invoice_payment_methods`	Koin yang dapat digunakan untuk membayar invoice
`select_invoice_payment_method`	Memilih koin untuk invoice
`preview_payment`	Menghitung kuotasi pembayaran langsung
`create_payment`	Membuat pembayaran langsung
`get_payment`	Status pembayaran
`list_payments`	Menampilkan daftar pembayaran
`create_static_address`	Alamat deposit permanen
`list_static_addresses`	Menampilkan daftar alamat permanen
`list_static_address_deposits`	Deposit ke alamat permanen

Kirim (pembayaran)

Alat	Fungsinya
`preview_payout`	Menghitung kuotasi pembayaran (mengirim kripto)
`create_payout`	Mengirim pembayaran (tidak dapat dibatalkan) ⚠️ tidak dapat dibatalkan
`get_payout`	Status pembayaran
`list_payouts`	Menampilkan daftar pembayaran

Penukaran

Alat	Fungsinya
`preview_conversion`	Menghitung kuotasi konversi (penukaran)
`create_conversion`	Menjalankan konversi ⚠️ tidak dapat dibatalkan
`get_conversion`	Status konversi
`list_conversions`	Menampilkan daftar konversi

Webhook

Alat	Fungsinya
`list_webhooks`	Menampilkan daftar endpoint webhook
`create_webhook`	Menambahkan endpoint webhook
`update_webhook`	Mengubah endpoint webhook
`rotate_webhook_secret`	Membuat rahasia webhook baru ⚠️ tidak dapat dibatalkan

Sumber daya: snapex://docs/quickstart, snapex://docs/webhooks. Prompt: accept_crypto_payment, send_crypto_payout.

Lingkungan (paket stdio)

Variabel	Default	Arti
`SNAPEX_API_KEY`	—	Kunci API merchant `smk_…`. Opsional: `create_account` akan membuatnya.
`SNAPEX_BASE_URL`	`https://pay.snapex.pro`	URL dasar API.
`SNAPEX_CREDENTIALS_FILE`	`~/.config/snapex-pay/credentials.json`	Lokasi penyimpanan kunci dari `create_account` (mode 600).
`SNAPEX_NO_SAVE`	—	`1` — jangan simpan kredensial ke disk.

Keamanan

Agen hanya memindahkan uang dari akunnya sendiri; akun baru dimulai dengan saldo nol.
Kunci dan kata sandi yang dibuat hanya ditampilkan sekali. Seseorang dapat membuka panel dengan nama pengguna dan kata sandi, lalu mencabut atau mengganti kunci di sana.
Pembayaran dilakukan dalam dua langkah (kuotasi, lalu kirim) dan memerlukan idempotency_key; create_payout, create_conversion, dan rotate_webhook_secret ditandai sebagai destructiveHint, sehingga klien dapat meminta konfirmasi sebelum menjalankannya.
Batas: beberapa akun baru per IP per jam; sekitar 120 panggilan API per menit untuk setiap kunci; pembayaran 5 per menit dan 30 per jam.
Aturan tentang hal yang boleh dijual: https://pay.snapex.pro/rules.

Pengembangan

Daftar alat dibuat dari server SnapEX Pay (app/Mcp/McpToolCatalog.php):

php artisan mcp:export-tools      # writes src/tools.json, syncs the version of the manifests and LobeHub's tools
npm ci && npm test                # build + offline smoke test with the official MCP SDK client
SNAPEX_E2E_BASE_URL=http://127.0.0.1:8765 node test/smoke.mjs   # full flow against a local (never production) server

Dukungan

Obrolan: https://pay.snapex.pro/#chat · Privasi: https://pay.snapex.pro/privacy · Ketentuan: https://pay.snapex.pro/terms

Lisensi

MIT