SnapEX Pay

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

SnapEX Pay MCP sunucusu

Kripto ödemeleri için MCP sunucusu: Bir yapay zekâ aracısı kendi satıcı hesabını açar, kripto kabul eder, gönderir ve takas eder.

SnapEX Pay MCP sunucusu, bir yapay zekâ aracısının arada bir kişi olmadan kripto ödemeleriyle çalışmasını sağlar. Aracı https://pay.snapex.pro/mcp, adresine bağlanır, kendi başına bir SnapEX Pay satıcı hesabı açar (captcha veya e-posta gerekmez) ve bir API anahtarı alır. Ardından barındırılan ödeme sayfalarıyla faturalar oluşturabilir, kalıcı para yatırma adreslerinden kripto alabilir, USDT bakiyesi tutabilir, birçok coin ve ağda ödeme gönderebilir ve webhook'ları yönetebilir. Test modu, tüm akışı gerçek para kullanmadan çalıştırır. Ödemeler her zaman ücretsiz bir önizlemeyle başlar ve bir idempotency anahtarı kullanır; böylece yeniden deneme hiçbir zaman iki kez ödeme yapmaz. Uzak sunucu (Streamable HTTP) veya yerel paket: npx -y snapex-pay-mcp.

• Uzak sunucu (önerilir, kurulum gerekmez): https://pay.snapex.pro/mcp — Streamable HTTP.
• Yerel stdio paketi: npx -y snapex-pay-mcp — aynı araçlar, aynı API'nin ince bir istemcisi.
• Docker: docker build -t snapex-pay-mcp . && docker run -i --rm snapex-pay-mcp.
• MCP Registry adı: pro.snapex/pay.
• İnsanlara yönelik belgeler: https://pay.snapex.pro/mcp · REST başvurusu: https://pay.snapex.pro/partner/merchant/docs · sunucu kartı: https://pay.snapex.pro/.well-known/mcp.json · https://pay.snapex.pro/llms.txt
• Gizlilik politikası: https://pay.snapex.pro/privacy · Koşullar: https://pay.snapex.pro/terms · Satıcı kuralları: https://pay.snapex.pro/rules · Destek: https://pay.snapex.pro/#chat

Bir aracı nasıl kullanır?

1. Anahtar olmadan bağlanın. Katalog araçları (list_assets, get_fiat_rates, get_fees, list_static_address_networks) hemen kullanılabilir.
2. create_account çağrısını yapın. Bu çağrı api_key (yalnızca bir kez gösterilir), bir kişi için hesap login/password ve mcp_personal_url döndürür. Yeni anahtar hemen kullanılır: uzak sunucuda MCP oturumunun geri kalanı boyunca, stdio paketinde ise süreç boyunca (ve sonraki çalıştırmalar için ~/.config/snapex-pay/credentials.json konumuna kaydedilir).
3. Ödeme alın: create_invoice → pay_url bilgisini ödeyene verin → paid olana kadar get_invoice. environment: "test", tüm akışı gerçek para kullanmadan çalıştırır (bir test faturası, coin seçildikten yaklaşık 10 saniye sonra ödenmiş durumuna gelir; bakiye değişmez).
4. Ödeme gönderin: preview_payout (ücretsiz fiyat teklifi) → preview_id ve kendi idempotency_key anahtarınızla create_payout (geri alınamaz; aynı anahtarla yeniden denemek hiçbir zaman iki kez ödeme yapmaz).
5. Bakiye USDT olarak tutulur: başka bir coin almak için o coinle ödeme gönderin. preview_conversion → create_conversion, eski bir hesabın hâlâ tuttuğu diğer varlıkları dönüştürür.

Her hata yanıtı, sonraki adımda ne yapılacağını belirtir (what_to_do); ör. unauthorized → create_account çağrısını yapın; rate_limited → retry_after_seconds kadar bekleyin.

Bağlanma

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

Oturumlar arasında tek bir hesabı kullanmak için "headers": { "Authorization": "Bearer smk_…" } ekleyin.

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

Yapay zekâ kurulum araçları için adım adım yönergeler: llms-install.md.

Gemini CLI

Bir uzantı olarak (bu depoda gemini-extension.json bulunur):

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

veya ~/.gemini/settings.json içinde:

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

Claude Desktop — claude_desktop_config.json

mcp-remote üzerinden uzak sunucu:

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

veya yerel paket:

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

(SNAPEX_API_KEY isteğe bağlıdır: bu olmadan aracı create_account çağrısını yapar ve anahtar sonraki çalıştırmalar için kaydedilir.)

claude.ai ve ChatGPT bağlayıcıları

https://pay.snapex.pro/mcp URL'sini kullanarak ve kimlik doğrulaması olmadan özel bir bağlayıcı ekleyin. Bu istemciler başlık gönderemez; bu nedenle create_account işleminden sonra yanıtındaki mcp_personal_url değerini alın (get_account tarafından da döndürülür) ve bunu bağlayıcı URL'si olarak kullanın — böylece her yeni sohbet aynı hesapla çalışır. Bu URL bir kimlik bilgisi içerir: parola gibi koruyun.

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

Diğer istemciler ve kataloglar

Depoda, katalogların okuduğu manifestler bulunur: server.json (resmî MCP Registry), 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

Araçlar

Hesap

Araç	Ne işe yarar
create_account	SnapEX Pay hesabı açar (captcha gerekmez)
get_account	Mevcut hesabı ve anahtarı gösterir

Katalog (anahtar gerekmez)

Araç	Ne işe yarar
list_assets	Coinleri ve ağları listeler
get_fiat_rates	Fiat döviz kurları
get_fees	Güncel rota ücret teklifleri
list_static_address_networks	Kalıcı adresler için ağlar

Bakiye

Araç	Ne işe yarar
get_balances	Hesap bakiyesi
list_transactions	Bakiye geçmişi

Ödeme alma

Araç	Ne işe yarar
create_invoice	Fatura oluşturur (kripto alır)
get_invoice	Fatura durumu
list_invoices	Faturaları listeler
get_invoice_payment_methods	Faturanın ödenebileceği coinler
select_invoice_payment_method	Fatura için coin seçer
preview_payment	Doğrudan ödeme için fiyat teklifi alır
create_payment	Doğrudan ödeme oluşturur
get_payment	Ödeme durumu
list_payments	Ödemeleri listeler
create_static_address	Kalıcı para yatırma adresi
list_static_addresses	Kalıcı adresleri listeler
list_static_address_deposits	Kalıcı adrese yapılan para yatırma işlemleri

Ödeme gönderme (ödemeler)

Araç	Ne işe yarar
preview_payout	Ödeme için fiyat teklifi alır (kripto gönderir)
create_payout	Ödeme gönderir (geri alınamaz) ⚠️ geri alınamaz
get_payout	Ödeme durumu
list_payouts	Ödemeleri listeler

Takas

Araç	Ne işe yarar
preview_conversion	Dönüştürme için fiyat teklifi alır (takas)
create_conversion	Dönüştürme işlemini gerçekleştirir ⚠️ geri alınamaz
get_conversion	Dönüştürme durumu
list_conversions	Dönüştürmeleri listeler

Webhook'lar

Araç	Ne işe yarar
list_webhooks	Webhook uç noktalarını listeler
create_webhook	Webhook uç noktası ekler
update_webhook	Webhook uç noktasını değiştirir
rotate_webhook_secret	Yeni webhook gizli anahtarı ⚠️ geri alınamaz

Kaynaklar: snapex://docs/quickstart, snapex://docs/webhooks. İstemler: accept_crypto_payment, send_crypto_payout.

Ortam (stdio paketi)

Değişken	Varsayılan	Anlamı
SNAPEX_API_KEY	—	Satıcı API anahtarı smk_…. İsteğe bağlı: create_account bir tane oluşturur.
SNAPEX_BASE_URL	https://pay.snapex.pro	API temel URL'si.
SNAPEX_CREDENTIALS_FILE	~/.config/snapex-pay/credentials.json	create_account üzerinden alınan anahtarın kaydedildiği konum (mode 600).
SNAPEX_NO_SAVE	—	1 — kimlik bilgilerini diske kaydetme.

Güvenlik

• Bir aracı yalnızca kendi hesabındaki parayı hareket ettirir; yeni bir hesap sıfır bakiyeyle başlar.
• Anahtar ve oluşturulan parola yalnızca bir kez gösterilir. Bir kişi, kullanıcı adı ve parolayla hesaba girip anahtarları iptal edebilir veya yenileyebilir.
• Ödemeler iki adımlıdır (fiyat teklifi, ardından gönderim) ve bir idempotency_key gerektirir; create_payout, create_conversion ve rotate_webhook_secret, destructiveHint olarak işaretlenmiştir; böylece istemciler çalıştırmadan önce onay isteyebilir.
• Sınırlar: IP başına saatte birkaç yeni hesap; anahtar başına dakikada yaklaşık 120 API çağrısı; dakikada 5, saatte 30 ödeme.
• Satılabilecek ürünlere ilişkin kurallar: https://pay.snapex.pro/rules.

Geliştirme

Araç listesi SnapEX Pay sunucusundan oluşturulur (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

Destek

Sohbet: https://pay.snapex.pro/#chat · Gizlilik: https://pay.snapex.pro/privacy · Koşullar: https://pay.snapex.pro/terms

Lisans

MIT