Payment layer for AI agents. One MCP, five protocols, thousands of paid APIs your agent can call.
The io.github.MPP32/mpp32-mcp-server is a payment layer for AI agents. It exposes one MCP server supporting five protocols, enabling an agent to call thousands of paid APIs through the described payment layer.
๐ ๏ธ Key Features
One MCP server
Five protocols
Payment layer for AI agents
Integrates access to thousands of paid APIs
๐ Use Cases
Enable AI agents to use paid APIs
Payment-oriented workflows that rely on multiple protocols
โก Developer Benefits
TypeScript-oriented ecosystem alignment (topics include TypeScript)
Compatibility focus indicated by related tooling topics (e.g., Bun, Hono, React)
Service scope is described only as a payment layer with five protocols and paid API access; specific APIs, tooling interfaces, and protocol behaviors are not provided in the available source excerpt.
One install. Pay any x402 endpoint on Solana from your agent. Browse a federated index of thousands of machine payable APIs without setting up a single provider account.
What works today
Rail
Status
Network
Asset
x402
Production
Solana (mainnet)
USDC
x402
Production
Base
USDC
Tempo
Production
Tempo (mainnet, chain 4217)
pathUSD
AP2 / AGTP
Production (authorization and identity layers)
Chain agnostic
per protocol
ACP
Envelope wired, gated off in production
Multi chain
checkout session
The MCP server ships signers for Solana, Base, and Tempo out of the box. When a paid call returns a 402, the server picks the rail that matches the key you configured and settles the payment in one round trip. MPP32_SOLANA_PRIVATE_KEY pays x402 on Solana; MPP32_PRIVATE_KEY (0x-prefixed EVM key) pays x402 on Base and Tempo pathUSD challenges.
Free Tier: 10 calls/day, no wallet required
Every agent session gets 10 free Intelligence Oracle calls per day โ no wallet, no USDC, no payment setup. Just set MPP32_AGENT_KEY (free, instant, no signup at mpp32.org/agent-console) and start calling get_solana_token_intelligence. Free tier resets at midnight UTC.
This lets you test your full MCP integration end-to-end before committing any crypto. Build working prototypes, evaluate the data quality, and ship to production โ the free tier covers typical development and light usage indefinitely.
After free tier: $0.008/query paid via x402 (USDC on Solana). M32 holders save up to 40%.
Quick anonymous test (no keys at all)
The try_solana_token_intelligence_free tool returns the same payload with zero configuration โ just install and call. Rate-limited to 10/minute per IP. Good for a quick taste, but the 10/day free tier with an agent key is better for real work.
Why this beats running your own integrations
Most agent stacks stop at "the model can call a function." That works until the function costs money. The moment your agent needs premium data, a paid model, a trading signal, or a token analytics call, you are back to building accounts, storing API keys, watching budgets, and writing custom 402 handlers for every provider.
MPP32 replaces all of that with one MCP server. Your agent asks for a service by name. The server finds it in a federated catalog of thousands of machine payable APIs, negotiates the cheapest protocol, signs payment from a key on your own machine, and returns the data. You write zero billing code. You manage zero provider accounts. Your agent gets faster, cheaper, and reaches services other agents cannot touch.
What your agent can do once this is installed
Browse a live catalog of over 4,500 paid and free APIs across categories like token intelligence, market data, web search, image generation, embeddings, DeFi analytics, wallet scoring, on chain queries, and trading signals.
Pay any provider in the catalog using whichever protocol fits, with settlement that lands in seconds.
Run real time Solana token intelligence with alpha scoring, rug risk, whale flow, and 24 hour pump probability.
Query live PIVX DAO governance data: active proposals, masternode voting tallies, budget allocation, and network deflation metrics โ all free, no payment key needed.
Track every call, every dollar settled, and every protocol used from a dashboard at mpp32.org.
Get an automatic 20 percent or 40 percent discount on native services for holding M32 once your wallet is verified.
Access M32-gated exclusive APIs: Whale Tracker (1M M32), Token Comparison (2.5M M32), and Portfolio Scanner (5M M32) โ free for holders, unavailable to non-holders.
Install
bash
npx -y mpp32-mcp-server@latest
Claude Desktop, Claude Code, Cursor, Windsurf
Drop this into the MCP servers section of your client config.
Claude Desktop (macOS):~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows):%APPDATA%\Claude\claude_desktop_config.json
Cursor:~/.cursor/mcp.json
Windsurf:~/.codeium/windsurf/mcp_config.json
Fully quit and reopen the client after editing. The MCP child process inherits env vars from this file at launch.
Get an MPP32_AGENT_KEY at mpp32.org/agent-console. No signup, no email, just click Create Agent Session and the form returns a key plus this exact config snippet ready to copy. With an agent key every call is attributed to your dashboard so you can see spend, success rate, and protocol breakdown. Without it the server still works but you only see native services and the calls stay anonymous.
MPP32_SOLANA_PRIVATE_KEY is only needed for paid services. Free services in the catalog work without any payment key.
What format does MPP32_SOLANA_PRIVATE_KEY take?
A base58 encoded 64 byte Solana secret key. The same string that Phantom shows under export private key (not the seed phrase). If you have a keypair.json (the 64 byte array Solana CLI uses), convert it once with:
Then paste the resulting string into the env block. Treat it like a password. It can spend any USDC and SOL in the wallet.
Fund the wallet with both USDC and SOL
x402 settles the payment in USDC, but Solana itself charges a tiny native SOL fee on every transaction. A USDC only wallet will fail with insufficient funds for rent even though the USDC balance is plentiful. About 0.001 SOL covers many calls.
Tip: call the get_mpp32_diagnostics tool from inside Claude. It probes the API, reports which env vars actually reached the MCP process, and prints Ready to pay: YES once everything is wired.
Configuration
Variable
When you need it
What it does
MPP32_AGENT_KEY
Recommended
Session key from mpp32.org/agent-console. Unlocks the full federated catalog and dashboard tracking. Also accepted as MPP32_API_KEY.
MPP32_SOLANA_PRIVATE_KEY
Paid x402 calls on Solana
Base58 encoded Solana secret key. Used to sign USDC payments locally. Never leaves your machine.
MPP32_PRIVATE_KEY
Paid x402 calls on Base
0x prefixed EVM private key. Used to sign USDC payments on Base when a provider only accepts EVM.
MPP32_PREFERRED_NETWORK
Optional override
When both keys are configured and the challenge advertises multiple networks, force one. Accepts solana, base, evm, or a full CAIP-2 string.
MPP32_SOLANA_RPC_URL
Optional
Override the Solana RPC endpoint used to fetch recent blockhashes when building x402 transactions. Defaults to https://api.mainnet-beta.solana.com. Set this if you hit public rate limits.
MPP32_TIMEOUT_MS
Optional
Request timeout in milliseconds for all outbound API calls. Range 1000 to 300000. Defaults to 30000 (30 seconds).
MPP32_API_URL
Custom deployments
Override the API base URL. Defaults to https://mpp32.org.
Private keys stay on your machine. They sign payments locally and never travel to MPP32 servers. Provide either or both for paid calls. If both are present and a challenge advertises both networks, EVM is preferred unless MPP32_PREFERRED_NETWORK is set; if only one key is configured, that network wins automatically.
Tools your agent will see
list_mpp32_services
Browse the federated catalog. Returns native, curated free, x402 bazaar, and MCP registry entries with pricing, supported protocols, and a clear flag on every row that tells the agent whether it can actually call the service through this MCP or whether the entry is for discovery only.
Call any HTTP callable service in the catalog. Free services return immediately. Paid services return a 402 challenge that this tool signs and retries automatically when a payment key is configured.
Return the data with the settled amount, the protocol used, and the on chain settlement signature.
No payment logic in your code. No per provider keys to juggle.
get_mpp32_diagnostics
Reports the MCP server version, which env vars actually reached the child process, the API URL it will hit, and a live API reachability probe. Prints Ready to pay: YES only when an agent key plus at least one signing key are detected and the API is reachable. Call this first if anything misbehaves. Also available as debug_mpp32.
get_solana_token_intelligence
Real time analysis of any Solana token. Pulls live data from DexScreener, Jupiter, and CoinGecko and merges it into one report. Returns an alpha score from 0 to 100, rug risk, whale activity, smart money signals, 24 hour pump probability, projected ROI ranges, and full market data. Costs $0.008 per call, paid automatically through x402 when a Solana key is set.
json
{"token":"BONK"}
M32 holders get tiered discounts (20 percent at 250k, 40 percent at 1M) once SIWS wallet signature verification ships. The discount path is gated off in production until then so it cannot be claimed by spoofing a wallet header. M32 holders also get exclusive access to three token-gated APIs: Whale Tracker (1M M32), Token Comparison (2.5M M32), and Portfolio Scanner (5M M32) โ these are live now and require passing your wallet address via the X-Wallet-Address header.
get_m32_whale_tracker
M32-gated whale analysis for any Solana token. Returns top 20 holders, concentration risk, holder distribution, and buy/sell pressure. Requires the caller to hold 1,000,000+ M32 tokens (balance verified on-chain). Free for qualifying holders.
M32-gated full wallet portfolio scan. Discovers all SPL tokens in a wallet, runs intelligence on top holdings, and returns per-token analysis with aggregate risk metrics. Requires 5,000,000+ M32 tokens.
Real-time PIVX DAO governance intelligence. Returns active budget proposals with masternode voting tallies, budget allocation status, network deflation metrics, and masternode network health. PIVX is a fully community-governed cryptocurrency where Masternode owners vote on budget proposals every ~30 days. Data sourced live from pivx.org/proposals and the PIVX blockchain. Free โ no payment key required.
json
{"filter":"all"}
json
{"filter":"passing","includeStats":true}
Two parameters:
filter (optional) โ all (default), passing, or failing. Filters proposals by voting status.
includeStats (optional, default true) โ include network overview and deflation metrics alongside proposals.
The response includes a network overview (masternode count, passing threshold, monthly budget in PIV and USD, budget allocation percentage, block height, supply stats), deflation metrics (unallocated treasury PIV that are never minted, effective inflation reduction, proposal fee burn), and all active proposals with vote counts, payment amounts, installments, and links.
get returns current budget status: remaining balance, hourly velocity, circuit breaker state, and per-service spending breakdown.
set configures budgetLimitUsd (max total session spend), velocityLimitUsd (max spend per hour), and alertThresholdPercent (warn at this percentage of budget used). All three are optional and can be set independently.
reset clears a tripped circuit breaker so the session can resume spending. Circuit breakers trip automatically when limits are exceeded and stay tripped until manually reset.
Budget limits can also be set at session creation time via the agent console at mpp32.org/agent-console or by passing budgetLimitUsd, velocityLimitUsd, and alertThresholdPercent to POST /api/agent/sessions.
How discovery works
MPP32 keeps a federated index of machine payable services so your agent can find what is out there without crawling every provider on its own. Four sources feed it.
Source
What it is
Callable through this MCP
MPP32 native
APIs registered through mpp32.org/build. Verified, payable end to end.
Yes
Curated free
Hand maintained list of DexScreener, Jupiter, CoinGecko, OpenAI, and similar public APIs.
Yes when MPP32_AGENT_KEY is set
x402 Bazaar
Resources discovered through the Coinbase x402 facilitator.
Listing only. Pay providers directly via x402.
MCP Registry
Servers from the official Model Context Protocol registry.
No. Install via npx and run them as a separate stdio server.
Every row in list_mpp32_services carries a callable flag so it stays obvious which slugs can be passed to call_mpp32_endpoint.
Sessions for autonomous agents
For longer running workflows, MPP32 issues server side session keys with a 30 day expiry and full per call accounting. Sessions let an agent run inside a budget instead of negotiating payment every single call.
Put it in MPP32_AGENT_KEY in your MCP config, or send it as X-Agent-Key on direct API calls.
Watch spend, latency, and protocol mix live in the dashboard.
Sessions are scoped, revocable, and rotate cleanly. The key is hashed at rest on the server, so a database leak does not surrender live credentials.
How payment verification actually works
x402 payments are verified on chain through the Solana facilitator (for SVM) or the Base facilitator (for EVM). MPP32 never holds custody of funds. Every paid call settles directly from the caller's wallet to the provider's wallet.
Tempo payments are verified on chain by the proxy's mppx integration: the client signs a TIP-20 pathUSD transfer against the live challenge and the server confirms the transfer on Tempo mainnet before releasing the response. AP2 and AGTP run as live authorization and identity layers on every paid route. The ACP envelope is implemented and tested against synthetic challenges but stays disabled in production until its checkout-session client flow is verified end to end.
For API providers
List your endpoint once and receive payment over x402. MPP32 handles the payment negotiation, the on chain verification, the discovery listings via OpenAPI and A2A and MCP standards, the periodic health re check, and the analytics dashboard. Settlement lands in USDC on Solana or Base straight to your wallet.
Session key from https://mpp32.org/agent-console. Unlocks the full federated catalog and attributes every call to your dashboard. Optional in legacy mode where only native services are reachable.
MPP32_SOLANA_PRIVATE_KEYsecret
Solana private key used to sign x402 USDC payments locally. Only needed when calling paid services that prefer x402. Stays on your machine, never sent to MPP32 servers.
MPP32_PRIVATE_KEYsecret
Ethereum L2 private key used to sign Tempo pathUSD payments locally. Optional fallback for paid services when x402 is not available. Stays on your machine, never sent to MPP32 servers.
MPP32_API_URLdefault https://mpp32.org
Override the API base URL for custom deployments. Defaults to https://mpp32.org.