Lumen Agent Utilities MCPサーバー
コミット 2026年10月11日AIエージェントによるEVMトランザクションのデコード、WebコンテンツのMarkdown取得、DNSルックアップ、学術・金融データベースの検索を可能にします。
別名 Dansgit2b/lumenworks-x402-api, lumenworks-decoder
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 1.4.0
- 最終コミット
- 2026年10月11日
- ライセンス
- MIT
Lumen Agent Utilities MCPとは
Lumen Agent UtilitiesはMCPサーバーです。 AIエージェントによるEVMトランザクションのデコード、WebコンテンツのMarkdown取得、DNSルックアップ、学術・金融データベースの検索を可能にします。.
プロジェクトのREADMEから生成された概要
Lumen Agent Utilities MCP server について
Lumen Agent Utilitiesは、AIエージェントがブロックチェーン、Web、学術データとやり取りするために設計された一連の特化型ツールを提供します。開発者は、HTTP経由でこのリモートMCP serverに接続することで、EVM calldataのデコード、DNSルックアップ、WebコンテンツのクリーンなMarkdown形式での取得などの機能を利用できます。このサーバーはx402プロトコルを使用した従量課金モデルを採用しており、コストは1リクエストあたり0.001から0.002 USDCですが、無料枠としてIPアドレスごとに1時間あたり20コールまで利用可能です。
ユーザーは、型付きデータの分析を行うeip712_decode、残高やENSレコードを確認するevm_address_lookup、学術研究のためのpubmed_searchやarxiv_searchなどの特定のツールを活用できます。システムはBase mainnetでの決済をサポートしており、特定のAPIキーが提供されればCeloとの統合も可能です。複雑なローカル環境を管理することなく、Webからの検証可能なデータ、SEC EDGAR経由の財務報告、または技術的なブロックチェーンの詳細を必要とする自律型エージェントを構築する開発者向けに設計されています。
できること
- 1Webページをテキストに変換開発者はAIに対してURLのスクレイピングを指示し、処理しやすい構造化されたMarkdown形式でコンテンツを受け取ることができます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
Lumen Agent Utilities MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにLumen Agent Utilities MCPをインストール
$ claude mcp add --transport http lumenworks-decoder https://lumenworks-x402-decoder.onrender.com/mcpCursorにLumen Agent Utilities MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"lumenworks-decoder": {
"url": "https://lumenworks-x402-decoder.onrender.com/mcp"
}
}
}VS CodeにLumen Agent Utilities MCPをインストール
.vscode/mcp.json
{
"servers": {
"lumenworks-decoder": {
"type": "http",
"url": "https://lumenworks-x402-decoder.onrender.com/mcp"
}
}
}VS Code CLIにLumen Agent Utilities MCPをインストール
$ code --add-mcp '{"name":"lumenworks-decoder","type":"http","url":"https://lumenworks-x402-decoder.onrender.com/mcp"}'CodexにLumen Agent Utilities MCPをインストール
$ codex mcp add lumenworks-decoder --url https://lumenworks-x402-decoder.onrender.com/mcpCodex config.tomlにLumen Agent Utilities MCPをインストール
~/.codex/config.toml
[mcp_servers.lumenworks-decoder] url = "https://lumenworks-x402-decoder.onrender.com/mcp"
Gemini CLIにLumen Agent Utilities MCPをインストール
$ gemini mcp add -s user --transport http lumenworks-decoder https://lumenworks-x402-decoder.onrender.com/mcpGemini settings.jsonにLumen Agent Utilities MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"lumenworks-decoder": {
"url": "https://lumenworks-x402-decoder.onrender.com/mcp",
"type": "http"
}
}
}自動チェック
実行日 2026年11月15日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能dansgit2b/lumenworks-x402-api is public and reachablegithub.com/dansgit2b/lumenworks-x402-api ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)MITspdx.org/licenses/MIT.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-11github.com/dansgit2b/lumenworks-x402-api ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答Endpoint did not answer initialize: HTTP 404検出事項
README
GitHubで見るLumen 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のよくある質問
Lumen Agent Utilities MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http lumenworks-decoder https://lumenworks-x402-decoder.onrender.com/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
Lumen Agent Utilities MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
EVMトランザクションに署名しても安全かどうかを確認するために使用できますか?
はい、Lumen Pre-Sign Checkを使用すると、トランザクションやEIP-712メッセージに署名すべきか判断するための要約と判定結果を取得できます。
有料ルートの支払いはどのように行われますか?
支払いはBase mainnet上のx402プロトコルを通じて行われ、1コールあたり0.001から0.002 USDCの費用がかかります。