Lumen Agent Utilities MCP server
2026년 10월 11일 커밋AI 에이전트가 EVM 트랜잭션을 디코딩하고, 웹 콘텐츠를 Markdown으로 가져오며, DNS 조회를 수행하고, 학술 또는 금융 데이터베이스를 검색할 수 있도록 지원합니다.
다른 이름 Dansgit2b/lumenworks-x402-api, lumenworks-decoder
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.4.0
- 마지막 커밋
- 2026년 10월 11일
- 라이선스
- MIT
Lumen Agent Utilities MCP란?
Lumen Agent Utilities은(는) MCP server입니다. AI 에이전트가 EVM 트랜잭션을 디코딩하고, 웹 콘텐츠를 Markdown으로 가져오며, DNS 조회를 수행하고, 학술 또는 금융 데이터베이스를 검색할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
Lumen Agent Utilities MCP server 정보
Lumen Agent Utilities는 AI 에이전트가 블록체인, 웹, 학술 데이터와 상호작용할 수 있도록 설계된 전문 도구 모음을 제공합니다. 개발자는 HTTP를 통해 이 원격 MCP server에 연결하여 EVM calldata 디코딩, DNS 조회, 웹 콘텐츠를 깔끔한 Markdown 형식으로 가져오기 등의 기능을 사용할 수 있습니다. 이 서버는 x402 프로토콜을 사용하는 호출당 결제 모델로 운영되며, 요청당 비용은 0.001에서 0.002 USDC 사이입니다. 단, IP 주소당 시간당 20회의 무료 호출이 가능합니다.
사용자는 타입화된 데이터를 분석하는 eip712_decode, 잔액 및 ENS 레코드를 확인하는 evm_address_lookup, 학술 연구를 위한 pubmed_search 또는 arxiv_search와 같은 특정 도구를 활용할 수 있습니다. 시스템은 Base mainnet 결제를 지원하며, 특정 API key를 제공할 경우 Celo와 통합할 수 있습니다. 이 서비스는 복잡한 로컬 환경을 관리할 필요 없이 웹의 검증 가능한 데이터, SEC EDGAR를 통한 금융 공시 또는 기술적인 블록체인 세부 정보가 필요한 자율 에이전트를 구축하는 개발자를 위해 만들어졌습니다.
활용 사례
- 1웹 페이지를 텍스트로 변환개발자가 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를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
EVM 트랜잭션 서명 전 안전 여부를 확인하는 데 사용할 수 있나요?
네, Lumen Pre-Sign Check를 통해 요약 정보와 판정 결과를 제공하므로 트랜잭션이나 EIP-712 메시드 서명 여부를 결정하는 데 도움을 받을 수 있습니다.
유료 경로의 결제는 어떻게 처리되나요?
Base mainnet의 x402 프로토콜을 통해 결제가 처리되며, 호출당 비용은 0.001에서 0.002 USDC 사이입니다.