x402engine
offiziell50+ Pay-per-Call-APIs für KI-Agenten über HTTP-402-Krypto-Mikrozahlungen. $0,001–$0,12 pro Aufruf mit USDC und USDm.
Was kann man mit x402engine MCP machen?
- Bezahlte APIs entdecken — Bitten Sie Ihren Assistenten, verfügbare Pay-per-Request-Dienste über
discover_servicesaufzulisten und deren Status mitservice_healthzu prüfen. - Bilder generieren und Code ausführen — Fordern Sie Bilderstellung mit
generate_imageoder Codeausführung mitexecute_codean, mit automatischer USDC-Zahlung auf Base oder Solana. - Krypto- und Wallet-Daten abfragen — Erhalten Sie Preise, Markttrends, Wallet-Salden, Transaktionen und Token-Metadaten mithilfe von Tools wie
get_crypto_priceundget_wallet_balances. - Audio und IPFS verarbeiten — Transkribieren Sie Audiodateien mit
transcribe_audiooder pinnen und rufen Sie Inhalte von IPFS mitpin_to_ipfsundget_from_ipfsab. - Reiseoptionen suchen — Finden Sie Flüge, Hotels, Standorte und günstigste Reisedaten mit Tools wie
search_flightsundsearch_hotels.
Dokumentation
x402engine-mcp
Agent-freundlicher MCP-Server für x402engine. Er ermöglicht Agenten, Pay-per-Request-APIs über HTTP 402 zu entdecken und aufzurufen, mit automatischer USDC-Zahlung auf Base oder Solana.
Das Live-Gateway deckt LLMs, Bild- und Videoerzeugung, Websuche und -Scraping, Codeausführung, Krypto- und Wallet-Daten, Transaktionssimulation, Audio, Reisen und IPFS ab. Dieses MCP stellt eine kuratierte Tool-Auswahl und Live-Erkennung für den vollständigen Katalog bereit.
Schnellstart
Verwenden Sie ein dediziertes Payer-Wallet mit niedrigem Guthaben. Das MCP signiert x402-Zahlungen lokal und sendet den privaten Schlüssel niemals an x402engine.
Base
{
"mcpServers": {
"x402engine": {
"command": "npx",
"args": ["-y", "x402engine-mcp@1.1.1"],
"env": {
"X402_EVM_PRIVATE_KEY": "0xYOUR_DEDICATED_PAYER_KEY",
"X402_PAYMENT_NETWORK": "base",
"X402_MAX_PAYMENT_USD": "1.00"
}
}
}
}
Finanzieren Sie das Wallet mit USDC auf Base. Der x402-Facilitator übernimmt die Transaktionsgasgebühren; das Wallet signiert eine EIP-3009-USDC-Autorisierung.
Solana
{
"mcpServers": {
"x402engine": {
"command": "npx",
"args": ["-y", "x402engine-mcp@1.1.1"],
"env": {
"X402_SOLANA_PRIVATE_KEY": "YOUR_BASE58_OR_JSON_PRIVATE_KEY",
"X402_PAYMENT_NETWORK": "solana",
"X402_MAX_PAYMENT_USD": "1.00"
}
}
}
}
Finanzieren Sie das Wallet mit USDC auf Solana und genügend SOL für Transaktionsgebühren.
Erkennung ohne Wallet
Der Server startet ohne Wallet, und kostenlose Tools wie discover_services und service_health funktionieren weiterhin. Kostenpflichtige Tools geben ihre x402-Zahlungsanforderungen zurück, bis ein Wallet konfiguriert ist.
claude mcp add x402engine -- npx -y x402engine-mcp@1.1.1
Hermes-Agent
Installieren Sie die x402engine-Fähigkeit und fügen Sie diesen Server in das config.yaml des aktiven Hermes-Profils ein:
mcp_servers:
x402engine:
command: npx
args: ["-y", "x402engine-mcp@1.1.1"]
env:
X402_BASE_URL: "https://x402engine.app"
X402_PAYMENT_NETWORK: "auto"
X402_MAX_PAYMENT_USD: "0.10"
Starten Sie eine neue Sitzung und rufen Sie discover_services oder service_health auf; beide sind kostenlos. Belassen Sie das Netzwerk auf auto, bis ein Wallet konfiguriert ist. Für Base-Zahlungen speichern Sie X402_EVM_PRIVATE_KEY im lokalen .env des Profils, fügen Sie X402_EVM_PRIVATE_KEY: "${X402_EVM_PRIVATE_KEY}" zum env des Servers hinzu und ändern Sie das Netzwerk auf base. Geben Sie Wallet-Schlüssel niemals in den Chat ein. Das Limit gilt pro Anfrage; autorisieren Sie für jede Aufgabe ein separates Gesamtbudget.
Vollständiger Hermes-Einrichtungsleitfaden · Installierbare Fähigkeit
Zahlungssteuerung
| Variable | Standard | Beschreibung |
|---|---|---|
X402_EVM_PRIVATE_KEY | nicht gesetzt | Dedizierter Payer-Schlüssel für Base-USDC |
X402_SOLANA_PRIVATE_KEY | nicht gesetzt | Base58- oder JSON-Payer-Schlüssel für Solana-USDC |
X402_PAYMENT_NETWORK | auto | auto, base oder solana |
X402_MAX_PAYMENT_USD | 1.00 | Hartes Ausgabenlimit pro Anfrage |
X402_BASE_URL | Produktions-Gateway | Überschreibt die Gateway-URL |
X402_PAYMENT_HEADER | nicht gesetzt | Legacy-vorsignierter x402-Header |
X402_DEV_BYPASS | nicht gesetzt | Entwicklungsumgehungsgeheimnis |
Im auto-Modus wird Base bevorzugt, wenn beide Schlüssel konfiguriert sind. Automatische Zahlung akzeptiert nur die kanonischen USDC-Verträge auf Base und Solana. Sie lehnt unbekannte Vermögenswerte, nicht unterstützte Netzwerke und Beträge über dem konfigurierten Limit ab, bevor sie signiert.
MegaETH bleibt für Clients verfügbar, die ihren eigenen kompatiblen Zahlungsheader bereitstellen.
MCP-Tools
| Kategorie | Tools |
|---|---|
| Erkennung | discover_services, service_health |
| Bild und Code | generate_image, execute_code |
| Audio | transcribe_audio |
| Krypto | get_crypto_price, get_crypto_markets, get_crypto_history, get_trending_crypto, search_crypto, get_crypto_categories |
| Wallet und Token | get_wallet_balances, get_wallet_transactions, get_wallet_pnl, get_token_prices, get_token_metadata |
| IPFS | pin_to_ipfs, get_from_ipfs |
| Reisen | search_flights, search_locations, search_hotels, search_cheapest_dates |
Preise sind in jeder Tool-Beschreibung und in der Live-Erkennung enthalten. Der Gateway-Katalog kann sich unabhängig von diesem Paket ändern.
Erkennung
- Gateway-Erkennung: /.well-known/x402.json
- Agentenkarte: /.well-known/agent.json
- Endpunkt-Manifest: /.well-known/agent-manifest.v1.json
- Dienste-API: /api/services
- Paketmetadaten: server.json
Entwicklung
npm install
npm test
npm run build
Links
- Website: x402engine.app
- npm: x402engine-mcp
- GitHub: agentc22/x402engine-mcp
- Protokoll: x402.org