Lumen Agent Utilities MCP server
Commit 11. Okt. 2026Ermöglicht es AI Agents, EVM-Transaktionen zu dekodieren, Web-Inhalte als Markdown abzurufen, DNS-Lookups durchzuführen und in akademischen oder Finanz-Datenbanken zu suchen.
Auch bekannt als Dansgit2b/lumenworks-x402-api, lumenworks-decoder
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- 1.4.0
- Letzter Commit
- 11. Okt. 2026
- Lizenz
- MIT
Was ist Lumen Agent Utilities MCP?
Lumen Agent Utilities ist ein MCP server. Ermöglicht es AI Agents, EVM-Transaktionen zu dekodieren, Web-Inhalte als Markdown abzurufen, DNS-Lookups durchzuführen und in akademischen oder Finanz-Datenbanken zu suchen.
Zusammenfassung generiert aus dem README des Projekts
Über Lumen Agent Utilities MCP server
Lumen Agent Utilities bietet eine Suite spezialisierter Tools, die darauf ausgelegt sind, dass AI Agents mit Blockchain-, Web- und akademischen Daten interagieren können. Entwickler können sich über HTTP mit diesem Remote MCP server verbinden, um Funktionen wie das Dekodieren von EVM calldata, DNS-Lookups und das Abrufen von Web-Inhalten als sauberes Markdown zu nutzen. Der Server arbeitet nach einem Pay-per-Call-Modell über das x402-Protokoll, wobei die Kosten zwischen 0.001 und 0.002 USDC pro Request liegen; ein Free Tier erlaubt jedoch 20 Calls pro Stunde pro IP-Adresse.
Nutzer können spezifische Tools wie eip712_decode zur Analyse von typisierten Daten, evm_address_lookup zur Überprüfung von Balances und ENS-Records sowie pubmed_search oder arxiv_search für die akademische Forschung verwenden. Das System unterstützt Settlements auf dem Base mainnet und kann mit Celo integriert werden, sofern ein spezifischer API key bereitgestellt wird. Es wurde für Entwickler gebaut, die autonome Agents erstellen, die verifizierbare Daten aus dem Web, Finanzberichte via SEC EDGAR oder technische Blockchain-Details benötigen, ohne komplexe lokale Umgebungen verwalten zu müssen.
Was du damit machen kannst
- 1Webseiten in Text umwandelnEin Entwickler kann eine KI anweisen, eine URL zu scrapen und den Inhalt in einem strukturierten Markdown-Format zu erhalten, um die Verarbeitung zu erleichtern.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Lumen Agent Utilities MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenLumen Agent Utilities MCP in Claude Code installieren
$ claude mcp add --transport http lumenworks-decoder https://lumenworks-x402-decoder.onrender.com/mcpLumen Agent Utilities MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"lumenworks-decoder": {
"url": "https://lumenworks-x402-decoder.onrender.com/mcp"
}
}
}Lumen Agent Utilities MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"lumenworks-decoder": {
"type": "http",
"url": "https://lumenworks-x402-decoder.onrender.com/mcp"
}
}
}Lumen Agent Utilities MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"lumenworks-decoder","type":"http","url":"https://lumenworks-x402-decoder.onrender.com/mcp"}'Lumen Agent Utilities MCP in Codex installieren
$ codex mcp add lumenworks-decoder --url https://lumenworks-x402-decoder.onrender.com/mcpLumen Agent Utilities MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.lumenworks-decoder] url = "https://lumenworks-x402-decoder.onrender.com/mcp"
Lumen Agent Utilities MCP in Gemini CLI installieren
$ gemini mcp add -s user --transport http lumenworks-decoder https://lumenworks-x402-decoder.onrender.com/mcpLumen Agent Utilities MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"lumenworks-decoder": {
"url": "https://lumenworks-x402-decoder.onrender.com/mcp",
"type": "http"
}
}
}Automatisierte Checks
Geluften am 15. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbardansgit2b/lumenworks-x402-api is public and reachablegithub.com/dansgit2b/lumenworks-x402-api ↗Bestanden
- Paket nennt dieses Repository als QuelleNicht geprüft
- Build-Provenienz (Sigstore-Attestierung)Nicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-10-11github.com/dansgit2b/lumenworks-x402-api ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNicht geprüft
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeEndpoint did not answer initialize: HTTP 404Befund
README
Auf GitHub ansehenLumen Works Agent API (x402)
Two listings on one origin:
- Lumen Pre-Sign Check:
POST /v1/tx/explain($0.002). Use before signing any EVM transaction or EIP-712 message; returns{summary[], flags[], verdict}withlooks_ok | review | do_not_sign_unless_intended. Agent policy: abort ondo_not_sign_unless_intended, escalatereview. Informational, not a security guarantee; looks_ok does not mean safe; no simulation. Accuracy set and known limits: ACCURACY.md. MCP:/mcp/presign. - Lumen Agent Utilities: every other route below. MCP:
/mcp.
Trust terms: no signup; free tier 20 calls/hour/IP under /v1/free/...; GET/HEAD on any paid path returns the 402 quote (it never settles); not charged when a call errors, because the x402 middleware settles only after the handler returns a status below 400. Input schemas and real example outputs (examples.json, captured live by test/capture-examples.mjs) are in each route's Bazaar extension and in /openapi.json, validated with node test/validate-bazaar.mjs <base>.
Stats: /v1/stats has anonymous aggregates only (UA family, daily unique counts from salted daily-rotating IP hashes, 30-day retention). They persist across deploys when STATS_GIST_ID + STATS_GIST_TOKEN (a gist-only token) are set; otherwise they are kept in memory.
Pay-per-call agent utilities, 0.001–0.002 USDC per call on Base mainnet via x402 (exact scheme, PayAI public facilitator). Author: Dan (Dansgit2b). Early-stage, unaudited.
| Endpoint (POST JSON) | What |
|---|---|
/v1/x402/lint {header} |
decode + lint x402 PAYMENT-REQUIRED/SIGNATURE/RESPONSE |
/v1/eip712/decode {typedData} |
domain separator, digest, risk notes |
/v1/calldata/decode {data, signature?} |
selector, openchain/4byte lookup, decoded args |
/v1/web/markdown {url, fullPage?, maxChars?} — $0.001 |
public page → clean Markdown (Readability) + metadata. No JS rendering. |
/v1/web/unfurl {url} — $0.001 |
final URL, status, title, description, OG image, canonical, favicon |
/v1/evm/address {address} (0x or ENS) — $0.002 |
Ethereum+Base: ENS + records, EOA/contract/7702, balances, USDC/USDT, ERC-20 info (public RPC) |
/v1/domain/lookup {domain} — $0.002 |
DNS (DoH) A/AAAA/MX/NS/TXT/CAA, SPF/DMARC, RDAP registrar/created/expiry, age |
Free tier: same paths under /v1/free/... (20/hour/IP). Discovery: /, /.well-known/x402, /openapi.json, /llms.txt.
payTo: 0xee9790cB3960952F585379F831a89b4e00B4029A.
End-to-end proof (local run, 2026-10-10): paid call settled on Base, tx 0xff4af45df7caeef958b77700e96ba94e5ed37d3bac6e8cf40d6528a9497d77d4.
Deploy: Render (render.yaml, free plan) or any Docker host (Dockerfile). Set PUBLIC_BASE to the public origin. No secrets needed (server only receives payments). License MIT.
MCP server
Remote MCP (streamable HTTP, stateless JSON): https://lumenworks-x402-decoder.onrender.com/mcp, with tools x402_lint, eip712_decode, calldata_decode, web_markdown, url_unfurl, evm_address_lookup and domain_lookup. Free tier: 20 tool calls/hour/IP. After that the tool returns the x402 payment requirements for the matching paid HTTP endpoint (0.001–0.002 USD).
Celo
When X402_CELO_API_KEY (from the x402.celo.org dashboard) is set, every paid route also accepts USA₮ and USDC on Celo (eip155:42220), settled through Celo's hosted facilitator at api.x402.celo.org.
Free x402 payment safety check
POST /v1/x402/safety-check (MCP tool x402_payment_safety_check) — deterministic pre-payment check. Body: {url?, method?, payment_required?, expected_pay_to?, expected_network?, max_price_usdc?, listed_price_usdc?, facilitator_url?, client_config?}. We fetch the unpaid 402 (SSRF-guarded) and return ok | review | do_not_pay with checks: HTTPS/health/latency, payTo validity/checksum/mismatch, unknown asset/network, price vs your cap and the listed price, timeout/replay window, multiple payTo, unknown facilitator, missing spend caps / idempotency in your client config. Nothing is stored; inputs that look like private keys are rejected. 30/hour/IP.
Planned (not built): continuous monitoring with alerts on price/payTo/asset changes. Free waitlist: POST /v1/monitoring/waitlist {endpoint_url, contact?} (5/hour/IP). No date promised; stored in memory/logs only on a free host, so it may be lost on restart.
Stats
GET /v1/stats — anonymous in-memory counters since last restart: calls per endpoint, unpaid 402s vs paid settlements (conversion), coarse user-agent buckets. No IPs or bodies stored.
v1.3: explain-before-you-sign + public-data tools
| Endpoint (POST) | Price | MCP tool | Upstream (free, no key) |
|---|---|---|---|
/v1/tx/explain |
0.002 | explain_before_sign |
calldata (openchain/4byte) + EIP-712, risk flags |
/v1/pubmed/search |
0.001 | pubmed_search |
NCBI E-utilities |
/v1/arxiv/search |
0.001 | arxiv_search |
arXiv API |
/v1/sec/filings |
0.001 | sec_filings |
SEC EDGAR (set SEC_USER_AGENT with a contact email per SEC policy) |
/v1/weather/forecast |
0.001 | weather_forecast |
Open-Meteo (CC BY 4.0) |
/v1/polymarket/markets |
0.001 | polymarket_markets |
Polymarket Gamma (read-only data) |
Free tier: /v1/free/<path> or MCP, 20 calls/hour/IP.
Facilitators
If CDP_API_KEY_ID and CDP_API_KEY_SECRET are set, Coinbase's CDP facilitator is used first. Settlements through it are what get the service indexed in the x402 Bazaar. The PayAI facilitator stays registered as the fallback. Without CDP keys, PayAI handles everything, as before.
Lumen Agent Utilities MCP Fragen
Wie füge ich Lumen Agent Utilities MCP zu Claude Code hinzu?
Führe claude mcp add --transport http lumenworks-decoder https://lumenworks-x402-decoder.onrender.com/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Lumen Agent Utilities MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Kann ich das nutzen, um zu prüfen, ob eine EVM-Transaktion sicher zu signieren ist?
Ja, der Lumen Pre-Sign Check liefert eine Zusammenfassung und ein Urteil, das dir bei der Entscheidung hilft, ob du eine Transaktion oder eine EIP-712 Nachricht signieren solltest.
Wie werden die Zahlungen für die kostenpflichtigen Routen abgewickelt?
Zahlungen werden über das x402-Protokoll auf dem Base mainnet abgewickelt, wobei die Kosten zwischen 0.001 und 0.002 USDC pro Aufruf liegen.