io.github.kimbo128/drain-mcp
Pay for AI inference with USDC micropayments on Polygon. No API keys needed.
Ask AI about io.github.kimbo128/drain-mcp
Powered by Claude Β· Grounded in docs
I know everything about io.github.kimbo128/drain-mcp. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
DRAIN
Decentralized Runtime for AI Networks
An open protocol for trustless, streaming micropayments between AI consumers and providers.
β‘ Superior to Per-Request-Providers.
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β 1000 AI REQUESTS β
β βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ£
β β
β DRAIN β Per-Request Payments (x402, etc.) β
β βββββ β ββββββββββββββββββββββββββββββββ β
β 2 transactions β 1000 transactions β
β ~$0.04 gas β ~$20+ gas β
β 0ms latency β 2-5 sec per request β
β 1 wallet popup β 1000 wallet popups (or API key) β
β β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
| π¦ 2 On-Chain TXs | β‘ Zero Latency | πΈ ~$0.04 Total Gas | π No API Keys |
|---|---|---|---|
| Open + Close only | Off-chain vouchers | 500x cheaper at scale | Cryptographic auth |
Why DRAIN?
Existing decentralized AI protocols require holding volatile tokens, creating speculation dynamics that overwhelm utility. Meanwhile, 78% of the world lacks credit cards, and AI agents can't have bank accounts.
DRAIN fills this gap: stablecoin micropayments without tokens, complexity, or intermediaries.
| Problem | DRAIN Solution |
|---|---|
| Token volatility | USDC-only, predictable pricing |
| High fees | ~$0.02 per tx on Polygon (varies: $0.015-0.025) |
| AI agents can't pay | First-class programmatic support |
| Credit card barriers | Permissionless crypto access |
Overview
DRAIN enables permissionless, pay-per-token AI inference without intermediaries. Users open payment channels with USDC, stream requests to any compatible provider, and settle on-chain only when needed.
Core Principles:
- Minimal β The protocol defines only what's necessary
- Permissionless β Anyone can be a provider or consumer
- Trustless β Cryptography replaces trust
- Immutable β No admin keys, no upgrades, no fees
How It Works
DRAIN is like a prepaid card for AI: deposit USDC, use it across requests, withdraw the remainder.
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β Off-Chain (Fast & Free) β
β β
β Consumer Provider β
β β β β
β ββββββββββ Request + Voucher βββββββββββββββββΊβ β
β ββββββββββ AI Response ββββββββββββββββββββββββ β
β ββββββββββ Request + Voucher βββββββββββββββββΊβ β
β ββββββββββ AI Response ββββββββββββββββββββββββ β
β β ... β β
β β
ββββββββββΌββββββββββββββββββββββββββββββββββββββββββββββΌββββββββββββ
β β
β On-Chain (Rare) β
βΌ βΌ
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β DRAIN Contract β
β β
β open(provider, amount, duration) β Lock USDC β
β claim(channelId, amount, signature) β Pay provider β
β close(channelId) β Refund remainder β
ββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
The Two Roles
| Role | What They Do | On-Chain Actions |
|---|---|---|
| Consumer | Pays for AI services | open (deposit), close (refund) |
| Provider | Delivers AI responses | claim (withdraw earnings) |
Consumer Flow
- Open Channel: Deposit USDC for a specific provider and duration (~$0.02 gas, ~5 sec finality)
- Use Service: Send requests with signed vouchers (free, off-chain, $0.000005 per request)
- Close Channel: Withdraw unused USDC after expiry (~$0.02 gas, ~5 sec finality)
Provider Flow
- Receive Request: Validate voucher signature and amount
- Deliver Service: Return AI response
- Claim Payment: Submit highest voucher to get paid (~$0.02 gas, ~5 sec finality)
Channel Duration & Provider Protection
The consumer sets the channel duration when opening (e.g., 24h). But providers control their requirements:
| Provider Can... | How |
|---|---|
| Require minimum duration | Reject vouchers from channels < X hours |
| Recommend duration | Document in API: "We recommend 24h channels" |
| Claim anytime | No deadline until consumer calls close() |
Key insight: Even after channel expiry, the provider can claim as long as the consumer hasn't closed. The consumer must actively call close() β it's not automatic.
Vouchers Are Cumulative
Each voucher contains the total amount spent, not the increment:
Request 1: voucher.amount = $0.10 (total spent so far)
Request 2: voucher.amount = $0.25 (total, not $0.15 increment)
Request 3: voucher.amount = $0.40 (total, not $0.15 increment)
Provider only needs to claim the last voucher to receive full payment.
Payment Currency
| Asset | Network | Why |
|---|---|---|
| USDC | Polygon | Stable ($1), liquid ($500M+), low fees (~$0.02/tx, varies: $0.015-0.025) |
USDC on Polygon can be bridged from Ethereum, Base, Arbitrum via Circle CCTP.
Handshake58 Marketplace
The official DRAIN marketplace is Handshake58 - a provider directory where AI agents can discover and pay for AI inference.
| Link | Description |
|---|---|
| https://www.handshake58.com | Main marketplace |
| https://www.handshake58.com/for-agents | Quick start for AI agents |
| https://www.handshake58.com/api/mcp/providers | Provider discovery API |
For AI Agents
Install the MCP Server and start using AI with crypto payments:
npm install -g drain-mcp
Configure in Claude Desktop or Cursor:
{
"mcpServers": {
"drain": {
"command": "drain-mcp",
"env": {
"DRAIN_PRIVATE_KEY": "your-polygon-wallet-key"
}
}
}
}
That's it! The MCP server auto-discovers providers from Handshake58.
Agent-Oriented Endpoints
| URL | Purpose |
|---|---|
/for-agents | Static, crawlable agent page |
/api/agent | Quick discovery JSON |
/llms.txt | 25-line agent instruction |
/skill.md | Full documentation (MCP first) |
Protocol Specification
DRAIN defines three components:
| Component | Description |
|---|---|
| Smart Contract | Immutable escrow and settlement logic |
| Voucher Format | EIP-712 typed signatures for off-chain payments |
| API Standard | OpenAI-compatible interface with payment headers |
The protocol intentionally excludes provider discovery, reputation systems, dispute resolution, and governance. These layers can be built independently.
Full specification: See contracts/ for implementation details.
Security Model
| Party | Protected Against | How |
|---|---|---|
| Consumer | Overcharging | Only signs amounts they agree to |
| Consumer | Non-delivery | Stops signing, refunds after expiry |
| Provider | Overspending | amount β€ deposit enforced on-chain |
| Provider | Double-spend | USDC locked in contract, not wallet |
EIP-712 signatures with chainId and verifyingContract prevent replay attacks. OpenZeppelin ECDSA provides malleability protection.
Voucher Format
// EIP-712 typed data
struct Voucher {
bytes32 channelId;
uint256 amount; // Cumulative total spent
uint256 nonce; // Incrementing per voucher
}
Consumer signs vouchers off-chain. Provider submits latest voucher to claim payment.
Economics
| Role | Cost |
|---|---|
| Consumer | ~$0.02 open + provider rate + ~$0.02 close |
| Provider | ~$0.02 claim gas, keeps 100% of fees |
| Protocol | Zero fees |
Total overhead: <$0.05 per session regardless of usage.
Minimum Deposit Recommendations:
- $0.10: Testing (40% gas overhead, ~100 messages)
- $0.50: Recommended minimum (8% gas overhead, ~500 messages)
- $1.00: Optimal (4% gas overhead, ~1000 messages)
- $5.00: Best value (0.8% gas overhead, ~5000 messages)
See Test Results for verified cost data.
What DRAIN Is NOT
| β | Why |
|---|---|
| Token | No speculation, no governance drama |
| Marketplace | Discovery is separate, built on top |
| Reputation system | Out of scope, can be layered |
| Upgradeable | Immutable contracts, no admin keys |
Project Structure
drain/
βββ contracts/ # Solidity smart contracts
β βββ src/DrainChannel.sol # Core payment channel contract
β βββ test/ # 47 Foundry tests
β βββ script/ # Deploy scripts
βββ sdk/ # TypeScript SDK
β βββ src/consumer.ts # Consumer: open, sign, close
β βββ src/provider.ts # Provider: verify, claim
βββ provider/ # Reference AI Provider
β βββ src/index.ts # Express server (OpenAI-compatible)
β βββ src/drain.ts # Voucher validation
βββ mcp/ # MCP Server for AI Agents
β βββ src/index.ts # MCP server entry point
β βββ src/tools/ # drain_chat, drain_balance, etc.
βββ demo/ # AI-optimized examples
βββ README.md # Quick start for AI agents
βββ simple-demo.ts # Minimal code example
MCP Server (Agent-to-Agent) β VERIFIED
DRAIN includes an MCP (Model Context Protocol) server that enables AI agents to autonomously pay for AI services.
β Successfully tested with Claude Desktop - An AI agent autonomously opened a $0.10 channel and made AI inference requests, proving the agent-to-agent payment economy works without human intervention.
Test Results: $0.000005 per request, 20,000 requests possible with $0.10 channel. See Test Results and Comparison with Credit Cards for detailed metrics.
npm install -g drain-mcp
Configure in Cursor or Claude:
{
"mcpServers": {
"drain": {
"command": "npx",
"args": ["-y", "drain-mcp"],
"env": {
"DRAIN_PRIVATE_KEY": "0x..."
}
}
}
}
Available Tools:
| Tool | Description |
|---|---|
drain_providers | Discover AI providers |
drain_balance | Check wallet balance |
drain_open_channel | Open payment channel |
drain_chat | AI chat with payment |
drain_close_channel | Close channel, get refund |
See mcp/README.md for full documentation.
SDK Quick Start
npm install @drain-protocol/sdk viem
import { createDrainConsumer, CHAIN_IDS } from '@drain-protocol/sdk';
// Open channel, sign vouchers, close when done
const consumer = createDrainConsumer(walletClient, account, {
chainId: CHAIN_IDS.POLYGON_MAINNET,
});
await consumer.approveUsdc('10');
const { channelId } = await consumer.openChannel({
provider: '0x...',
amount: '10',
duration: '24h',
});
const voucher = await consumer.signVoucher(channelId, '0.50');
// Send voucher to provider...
See sdk/README.md for full documentation.
Reference Provider
OpenAI-compatible API server that accepts DRAIN payments.
π’ Live Provider: https://drain-production-a9d4.up.railway.app/v1/pricing
Available Models & Pricing
| Model | Input/1K Tokens | Output/1K Tokens | ~Cost/Message |
|---|---|---|---|
| gpt-4o-mini | $0.000225 | $0.0009 | ~$0.001 β¨ |
| gpt-4o | $0.00375 | $0.015 | ~$0.01 |
| gpt-4-turbo | $0.015 | $0.045 | ~$0.03 |
| gpt-3.5-turbo | $0.00075 | $0.00225 | ~$0.002 |
Prices include 50% margin over OpenAI base rates
Run your own:
cd provider
cp env.example .env # Configure OPENAI_API_KEY, PROVIDER_PRIVATE_KEY
npm install
npm run dev
Endpoints:
GET /v1/pricing β View pricing per model
GET /v1/models β List available models
POST /v1/chat/completions β Chat (with X-DRAIN-Voucher header)
DRAIN Headers:
# Request
X-DRAIN-Voucher: {"channelId":"0x...","amount":"1000000","nonce":"1","signature":"0x..."}
# Response
X-DRAIN-Cost: 8250
X-DRAIN-Total: 158250
X-DRAIN-Remaining: 9841750
See provider/README.md for full documentation.
Provider Discovery
DRAIN is a permissionless protocol - anyone can be a provider. Multiple discovery options:
| Method | Best For | Link |
|---|---|---|
| Handshake58 | Humans browsing providers | Launch App |
| MCP Server | AI agents (auto-discovery) | npm package |
| Direct Address | Known provider integration | Use provider wallet address |
The marketplace is optional - DRAIN protocol works standalone with any provider address.
Demo & Examples
Quick Start for AI Agents: See demo/README.md for machine-readable examples.
Live Demo: https://www.handshake58.com
Try DRAIN without writing code:
- Connect Wallet β MetaMask on Polygon Mainnet
- Choose Provider & Model β Select from available AI models
- Open Channel β Deposit USDC ($0.10 minimum recommended)
- Chat β Each message signs a voucher and calls the real AI ($0.000005 per request)
- Close Channel β Get unused USDC refunded
Development Status
| Component | Status | Link |
|---|---|---|
| Smart Contract | β Complete | polygonscan |
| Test Suite (47 tests) | β Complete | contracts/test/ |
| TypeScript SDK | β Available | sdk/ |
| Reference Provider | β Online | Railway |
| MCP Server | β Published | npm |
| Handshake58 | β LIVE | Launch App |
Deployed Contracts
| Network | Contract | Address |
|---|---|---|
| Polygon Mainnet | DrainChannel | 0x1C1918C99b6DcE977392E4131C91654d8aB71e64 |
| Polygon Amoy (Testnet) | DrainChannel | 0x61f1C1E04d6Da1C92D0aF1a3d7Dc0fEFc8794d7C |
Getting Started
git clone https://github.com/kimbo128/DRAIN.git
cd DRAIN/contracts
# Install Foundry if needed: https://book.getfoundry.sh
forge build
forge test -vvv
Test Coverage
forge test --gas-report # Gas optimization
forge coverage # Line coverage
Target Chain
| Chain | Tx Cost | Finality | USDC Liquidity |
|---|---|---|---|
| Polygon | ~$0.02 (varies: $0.015-0.025) | 5 sec | $500M+ native |
Why Polygon?
- Native USDC with Circle CCTP bridging
- 5-second finality enables 10-minute challenge periods (300 blocks)
- Proven infrastructure, no reorgs
- Low gas costs (~$0.02 per transaction)
Future chains via CREATE2 for identical addresses.
FAQ
What if the provider doesn't deliver?
Stop signing vouchers. Your USDC stays locked until expiry, then you can close the channel and get a full refund. The provider can only claim what you've signed.
What if the consumer stops paying?
Provider stops delivering service and claims the last valid voucher. The consumer's deposit covers all signed vouchers.
Can I use ETH/MATIC instead of USDC?
No. DRAIN v1 supports only USDC on Polygon. This keeps the protocol simple and prices predictable.
Can I close a channel early?
No. Channels have a fixed duration (e.g., 24h) to protect providers. After expiry, unused funds are refundable.
When should providers claim?
Recommended: when accumulated earnings exceed ~$10 (to amortize ~$0.02 gas). Providers can claim at any time β before, during, or after channel expiry.
What happens to unclaimed vouchers after expiry?
Providers are protected by the channel duration. Here's the timeline:
Channel Open β Provider can claim (anytime) β Channel Expiry β Consumer can close
β β β β
ββββββββββββββββββββββ΄βββββββββββββββββββββββββ΄βββββββββββββββββββ
Provider can claim throughout this entire period
- Provider can claim: From channel open until consumer calls
close() - Consumer can close: Only AFTER channel expiry
- The gap is your protection: Even after expiry, if the consumer doesn't immediately close, you can still claim
Example with 24h channel:
- Consumer opens channel at 10:00 AM
- Consumer uses service, signs vouchers worth $5
- Channel expires at 10:00 AM next day
- Consumer might close at 2:00 PM (4 hours later)
- Provider can claim anytime from 10:00 AM Day 1 until 2:00 PM Day 2 (28 hours!)
Best practice: Set up monitoring to claim before expiry, but know you have a buffer.
Can I top up a channel?
No. Open a new channel instead. This keeps the protocol simple and avoids edge cases.
Related Projects
| Project | Description | Link |
|---|---|---|
| Handshake58 Marketplace | Official provider directory | https://www.handshake58.com |
| For AI Agents | Agent quick start | https://www.handshake58.com/for-agents |
| Provider API | Discovery endpoint | https://www.handshake58.com/api/mcp/providers |
| MCP Server | AI agent integration (Claude, Cursor) | npm |
| Reference Provider | Live DRAIN-compatible AI provider | API |
Contributing
See CONTRIBUTING.md for guidelines.
License
MIT License β Attribution required.
Permissionless AI infrastructure for an open economy.
