CoinVoyage AI PayKit – Gateway de Pagamentos Crypto para IA
TravisTheVoice/coinvoyage-mcp-gateway
Pagamentos crypto nativos para agentes IA autônomos via MCP
Ver no GitHubMCP Server que integra processamento de pagamentos em criptomoedas diretamente em aplicações IA autônomas (Claude, OpenAI agents). Oferece checkout universal multi-chain com suporte a Bitcoin, Solana, Ethereum e outros, permitindo que agentes IA orquestre transações nativas sem intervenção humana.
Instalação
npx convez-ai TravisTheVoice/coinvoyage-mcp-gateway1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Agentes IA que precisam aceitar pagamentos em criptomoedas autonomamente
- Checkout universal em aplicações conversacionais (Claude, OpenAI)
- Orquestração de transações blockchain a partir de lógica de IA
- Serviços e subscriptions com liquidação cripto descentralizada
Veredito

Solução sofisticada e específica para o nicho de aplicações IA autônomas que precisam de pagamentos cripto nativos. Bem arquitetada (arquitetura em 3 planos), multi-chain e MCP-ready, mas requer expertise tanto em IA quanto em blockchain para implementação efetiva.
README
A tradução para o português deste README ainda está na fila.
AI Crypto Pay Gateway – Universal Checkout for Autonomous Applications
Table of Contents
- The Genesis: Why This Exists
- Architecture Overview
- System Flow Diagram
- Core Capabilities
- Supported Blockchains
- Emoji OS Compatibility Matrix
- Example Profile Configuration
- Example Console Invocation
- Feature Inventory
- AI Integration: OpenAI & Claude API
- Installation & Setup
- Responsive UI Principles
- Multilingual Support Framework
- 24/7 Customer Support Automation
- Disclaimer
- License
The Genesis: Why This Exists
Imagine a world where your application possesses its own financial nervous system — where a checkout process doesn't require a human to click a button, because the AI itself orchestrates the payment. That is the reality AI Crypto Pay Gateway was built for.
In the late months of 2026, the barrier between autonomous code execution and financial settlement has finally collapsed. This repository provides the bridge. It is a composable, plugin-driven payment gateway designed specifically for AI-native applications built with tools like Claude Code, OpenAI agents, or custom LLM orchestrators.
Think of it less as a traditional payment SDK and more as a digital wallet with a voice — a payment agent that listens to your application's intent and responds with an on-chain transaction. Whether your app needs to accept Bitcoin for a digital download, Solana for a subscription, or ETH on Arbitrum for a service credit, this gateway handles the abstraction.
The 2026 landscape demands trustless, instant, and multi-chain payment rails. This repository is your key to unlocking that future without starting from zero.
Architecture Overview
The gateway follows a layered plugin architecture with three distinct planes:
- Integration Plane – A skill-based plugin that plugs directly into Claude Code (or any MCP-compatible client). This layer parses natural language payment requests from your AI agent and translates them into structured commands.
- MCP Server Plane – A dedicated server implementing the Model Context Protocol. It handles wallet generation, address derivation, transaction broadcasting, and confirmation polling. It is stateless but optionally persistable.
- Settlement Plane – The underlying blockchain interaction layer. This plane uses RPC endpoints to communicate with Bitcoin, Ethereum, Solana, Polygon, Arbitrum, Base, and Sui networks. It includes fee estimation, memo support for exchange compatibility, and transaction status callbacks.
The design philosophy is "speak in intent, settle in reality." Your AI never needs to know the intricacies of an ECDSA signature or a Solana SPL token transfer; it simply says "charge 0.1 ETH for the premium plan," and the rest is handled.
System Flow Diagram
graph TB
A[User Query / AI Prompt] --> B[AI Application]
B --> C[Claude Code / OpenAI Agent]
C --> D[Pay Gateway Skill Plugin]
D --> E[MCP Payment Server]
E --> F{Route Selection}
F -->|BTC| G[Bitcoin RPC]
F -->|ETH / ERC-20| H[Ethereum / Arbitrum / Base]
F -->|SOL| I[Solana RPC]
F -->|MATIC| J[Polygon RPC]
F -->|SUI| K[Sui RPC]
G --> L[Transaction Broadcast]
H --> L
I --> L
J --> L
K --> L
L --> M[Confirmation Polling]
M --> N[Webhook / Callback]
N --> O[AI Application UI Update]
style A fill:#f9f,stroke:#333,stroke-width:2px
style E fill:#bbf,stroke:#333,stroke-width:2px
style N fill:#bfb,stroke:#333,stroke-width:2px
Core Capabilities
- Natural Language Payment Orchestration: Your AI agent can instruct the gateway using plain sentences. "Generate a Bitcoin invoice for 0.001 BTC and email it to the user."
- Multi-Chain Address Derivation: Each supported network receives its own wallet derivation path. Hierarchical deterministic (HD) wallet support for BTC and EVM chains.
- Transaction Status Webhooks: Receive real-time callbacks for pending, confirmed, and failed transactions.
- Idempotency Guarantees: No double charges, even if the AI sends duplicate commands.
- Fee Bump Support: For Bitcoin transactions needing CPFP or RBF, the gateway can manage fee escalation.
- Memo Integration: Attach memos to transactions for exchange-level tracking.
Supported Blockchains
| Network | Type | Token Standard(s) | Native Fee Token |
|---|---|---|---|
| Bitcoin | UTXO | BTC | BTC |
| Ethereum | EVM | ETH, ERC-20, ERC-721 | ETH |
| Solana | SVM | SOL, SPL Token, NFT | SOL |
| Polygon | EVM | MATIC, ERC-20 | MATIC |
| Arbitrum | EVM (L2) | ETH, ERC-20 | ETH |
| Base | EVM (L2) | ETH, ERC-20 | ETH |
| Sui | Move-based | SUI, Coin<...> | SUI |
Emoji OS Compatibility Matrix
The following matrix indicates which operating systems and environments are tested for running the MCP server and plugin.
| Operating System | Tested 2026 | Notes |
|---|---|---|
| macOS Ventura+ | ✅ | Full support, native M1/M2/M3 |
| Windows 10/11 | ✅ | Requires WSL2 for best performance |
| Ubuntu 22.04 LTS | ✅ | Primary development environment |
| Fedora 38+ | ✅ | Works with Node 20 and Python 3.11 |
| Debian 12 | ✅ | Lightweight server deployment |
| Alpine 3.18+ | ⚠️ | Docker images only |
| ChromeOS | ❌ | Not natively supported |
| iOS / iPadOS | ❌ | Use via web interface only |
| Android (Termux) | ⚠️ | Experimental, no guarantees |
Example Profile Configuration
Below is an example configuration for a multi-currency AI ecommerce bot called "krypton-cart". This profile tells the gateway which chains are active, what the default settlement currency is, and how to handle webhooks.
profile.yaml
name: krypton-cart-v2
version: "2026.1.0"
active_chains:
- bitcoin
- ethereum
- solana
- polygon
- arbitrum
- base
- sui
default_chain: solana
default_token: SOL
fee_estimation: aggressive # options: conservative, medium, aggressive
webhook_url: "https://krypton-bot.example.com/payment-callback"
webhook_secret: "whsec_abc123xyz"
wallet:
type: hd
mnemonic: "twelve word mnemonic phrase here"
derivation_path: "m/44'/0'/0'/0/0"
retry_policy:
max_retries: 3
retry_delay_seconds: 30
notifications:
email: "admin@example.com"
telegram_bot_token: "123456:ABC-DEF"
This configuration is read by the MCP server at startup. It is intentionally human-readable so that AI agents can edit profiles autonomously — imagine an AI administrator rebalancing chains based on fee spikes in 2026.
Example Console Invocation
Once the MCP server is running, you can invoke it directly from the command line for testing or non-AI integration. The server listens on localhost:3007 by default.
# Invoice generation for Bitcoin
curl -X POST http://localhost:3007/api/v1/invoice \
-H "Content-Type: application/json" \
-d '{
"chain": "bitcoin",
"amount": "0.005",
"currency": "BTC",
"memo": "Premium subscription - user id 9842",
"callback_url": "https://myapp.com/webhook/bitcoin",
"expiry_minutes": 30
}'
# Check payment status
curl -X GET http://localhost:3007/api/v1/invoice/0xabc123def456?chain=solana
# Broadcast a signed transaction
curl -X POST http://localhost:3007/api/v1/broadcast \
-H "Content-Type: application/json" \
-d '{
"chain": "ethereum",
"signed_tx_hex": "0xf86c...",
"chain_id": 1
}'
The console invocation mimics REST API patterns familiar to developers. The AI plugin internally uses function calls that map to exactly these endpoints. This means you can test, debug, and validate payments without invoking an AI agent at all — a crucial capability for 2026 audit and compliance workflows.
Feature Inventory
The following is an exhaustive list of features included in the AI Crypto Pay Gateway repository as of 2026:
- Native chain support for Bitcoin, Ethereum, Solana, Polygon, Arbitrum, Base, Sui
- ERC-20 token detection with auto-import of token decimals and symbols via on-chain lookup
- SPL token support for Solana with Metaplex metadata resolution
- HD wallet generation from a single mnemonic
- Multi-currency invoice generation with QR code output (Base64 encoded SVG)
- Transaction status polling with exponential backoff
- Webhook retries with at-least-once delivery semantics
- Natural language invoice creation via Claude Code plugin
- MCP server health endpoint (
/healthz) - Docker image for easy deployment (
ghcr.io/yourorg/ai-crypto-pay-gateway:latest) - Prometheus metrics endpoint for observability
- Unit tests covering 85%+ of transaction logic
- Integration tests for each supported chain
- Error classification into retryable, fatal, and user-action-required categories
- Rate limiting per API key
- API key authentication with HMAC signing
- Embedded documentation served at
/docs - Graceful shutdown for Docker orchestration
AI Integration: OpenAI & Claude API
This repository is designed from the ground up to work with both major AI API ecosystems. The integration approach is modular:
Claude API (via Claude Code)
The gateway ships as a plugin skill for Claude Code. When installed, your AI assistant gains the ability to:
- Generate payment addresses on any supported chain with a single command.
- Create and track invoices.
- Broadcast signed transactions provided by external wallets.
- Retrieve balance information for any derived address.
- Configure payment profiles dynamically.
The plugin uses tool-use (function calling) in Claude, meaning the AI can call payment functions with structured parameters and receive structured responses.
OpenAI API
For developers using the OpenAI API (GPT-4, GPT-4-turbo, or future models), the MCP server is fully compatible with the OpenAI function calling specification. You can:
- Define functions that map directly to payment operations.
- Use the streaming mode to provide real-time payment status to your users.
- Integrate with Assistants API for persistent conversation threads containing payment context.
Both integrations support autonomous payment flows, where an AI agent can independently handle the entire lifecycle: prompting the user for approval, generating an invoice, monitoring payment, and confirming delivery.
Responsive UI Principles
While this repository is primarily an API-first tool, a lightweight management dashboard is included for human oversight. This dashboard follows these responsive design principles:
- Mobile-first CSS grid: The UI uses CSS Grid with breakpoints at 480px, 768px, and 1024px. On phones, the transaction table collapses into cards.
- Progressive enhancement: The dashboard works without JavaScript for viewing invoices, but requires JavaScript for real-time websocket updates.
- Dark mode support: CSS custom properties allow system-preference-based theming.
- Accessibility (a11y): All interactive elements have
aria-labelattributes. Contrast ratios meet WCAG 2.1 AA standards. - Lazy-loaded tables: Transaction lists use virtual scrolling for performance on large datasets.
The UI exists to serve the 2026 principle of "human-on-the-loop" — where AI handles the process, but humans can audit anytime, from any device.
Multilingual Support Framework
Payment systems are global. This repository includes a locale system that supports:
| Language | Code | Status 2026 |
|---|---|---|
| English | en | Full |
| Spanish | es | Full |
| French | fr | Full |
| German | de | Full |
| Japanese | ja | Full |
| Korean | ko | Full |
| Portuguese | pt | Full |
| Chinese (Simp) | zh-CN | Full |
| Hindi | hi | Partial |
| Arabic | ar | Partial |
| Russian | ru | Full |
| Vietnamese | vi | Partial |
Translations are stored as JSON locale files in a locales/ directory. The AI plugin automatically detects the user's language from the conversation context and sends invoice descriptions, error messages, and callback information in the appropriate locale.
The system also supports right-to-left (RTL) layout adaptation for Arabic and Hebrew locales. When the locale is set to ar, the dashboard UI flips its grid layout automatically.
24/7 Customer Support Automation
The 2026 economy never sleeps, and neither does this gateway. Built-in support automation includes:
- AI-powered refund agent: A Claude Code skill that processes refund requests. It verifies the original transaction, calculates the refund amount (minus fees), and generates a new transaction. Human approval can be required for amounts above a configurable threshold.
- Transaction dispute handler: When a user reports an issue, the gateway creates a structured ticket containing all relevant transaction IDs, timestamps, chain explorers URLs, and the webhook delivery log.
- Self-service portal endpoints: API endpoints at
/api/v1/support/ticketsallow your own support systems to query transaction details without needing blockchain explorers. - Automated notification rules: Configure rules such as "if a transaction on Arbitrum takes longer than 5 minutes, notify the user via Telegram."
These features ensure that even when your team is asleep, your payment infrastructure is awake and responsive.
Disclaimer
Important Legal and Financial Disclaimer
This software is provided for educational and experimental purposes as of 2026. Cryptocurrency transactions are irreversible. The developers of this repository assume no responsibility for:
- Financial losses resulting from improper configuration, incorrect addresses, or network congestion.
- Regulatory compliance issues in your jurisdiction. It is your responsibility to ensure that accepting cryptocurrency payments is legal where you operate.
- Smart contract vulnerabilities on third-party networks. This gateway does not deploy smart contracts; it interacts with existing RPC endpoints.
- Loss of private keys or mnemonic phrases. The gateway encrypts wallet data, but you are solely responsible for backup and security.
- Any AI agent behavior that results in unintended or erroneous transactions. Always test in a sandbox environment (e.g., Sepolia testnet for Ethereum) before moving to mainnet.
By using this repository, you acknowledge that you understand these risks and assume full responsibility for your deployment.
License
This project is licensed under the MIT License – a permissive open-source license that allows you to use, modify, and distribute the code freely, provided you include the original copyright notice.
See the LICENSE file for details.
Built for the autonomous economy of 2026.
AI Crypto Pay Gateway – Where code meets currency, autonomously.