Routescore

io.routescore由 routescore.io 发布官方发布者v0.3.5更新于 Oct 24, 2026

Read-only pre-sign evidence for onchain agents: route quality, MEV exposure, clear/caution verdict.

已验证Streamable HTTP可网页运行金融安全与监控

概览

AI 生成的概览

Routescore 为助手提供链上兑换签名前的只读证据：建模的路径质量、MEV 敞口以及 clear/caution 判定。

可以做什么
在签名前检查兑换：以 clear/caution/unsupported 判定给出建模的路径质量、价格冲击区间、MEV 敞口与代币识别结果，并持久化可哈希校验的记录，可按 record_id 取回；另可获取检测器清单并通过 whoami 确认密钥与套餐。记录并复核交易后的执行证据，支持幂等批量写入和按账户限定的已存记录复核。获取 MEV 三明治敞口、跨链桥执行失败和 LRT 罚没风险的建模保费估算。运行假设性蒙特卡洛情景，比较预期保费与预期损失或退款。仅在显式启用的非生产服务器上复核任意公开以太坊交易。
适用场景
适合在以太坊或 Robinhood Chain 上签名链上兑换前，让代理或开发者获得建模的时点性第二意见，或需要可离线复核的决策时点证据。也适合探索建模的风险保费与情景数值，但不用于执行或承保交易。
运行要求
需要 ROUTESCORE_API_KEY（或 Authorization bearer 头）中的 Routescore API 密钥，任何套餐均可免费生成，启动时会校验密钥格式。可作为本地 npm 包通过 npx 运行，或连接远程 streamable HTTP 端点。可选 ROUTESCORE_API_URL 覆盖 API 地址。需能访问 Routescore API 网络；每日配额取决于套餐。
安装前请注意
API 密钥属于机密且只显示一次，勿放入共享配置。所有输出均为建模的决策支持，不构成保险、承保、投资建议或执行保证。check_swap 为只读，不会签名或转移资金，但 record_execution 会向账户写入不可变记录且属 Pro 套餐。记录取回与报价工具属 Power 套餐，并按密钥限流。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Routescore，将其添加到工作区。
  2. 连接 Authorization token 凭据。它们会被私密存储，绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.routescore%2Fmcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "routescore": {
      "type": "http",
      "url": "https://www.routescore.io/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

@routescore/mcp

The read-only pre-sign evidence layer — a "pre-sign journal" — for onchain agents.

Before an agent (or you) signs a swap onchain, check_swap returns a modeled read of route quality, MEV/execution exposure, and token-registry recognition as a clear / caution / unsupported verdict with its caveats — and persists a hash-verifiable record of exactly what was known before signing, re-verifiable offline. That record is the pre-sign journal. It is read-only: it never signs, executes, routes funds, or custodies assets.

An MCP server (and a keyed REST API) for Claude, Codex, Cursor, and any MCP-capable agent — a thin, stateless wrapper around the Routescore public API, storing no request or response data locally.

check_swap is free. A free API key runs 100 pre-sign checks/day (Pro 1,000/day, Power 10,000/day); the modeled premium-estimate tools, simulate_scenario, and persisted-record retrieval are Power-tier. Generate a key at Account → Developer → API & MCP access (/account) — free to mint on any plan. Keys look like rs_live_… and are shown once.

See how these modeled reads have tracked measured on-chain outcomes on the public calibration surface — Routescore publishes its own accuracy (Brier score, ECE, coverage), re-derivable from a bound source manifest.

Setup

Add the server to your MCP client config and set your key in the env block.

Claude Desktop (claude_desktop_config.json) / Cursor (.cursor/mcp.json):

json
{  "mcpServers": {    "routescore": {      "command": "npx",      "args": ["-y", "@routescore/mcp"],      "env": {        "ROUTESCORE_API_KEY": "rs_live_your_key_here"      }    }  }}

Claude Code (CLI):

bash
claude mcp add routescore --env ROUTESCORE_API_KEY=rs_live_... -- npx -y @routescore/mcp

Optional env:

  • ROUTESCORE_API_URL — override the API base (default https://www.routescore.io). Useful for local development: http://localhost:3000.

The server checks the key at startup: if ROUTESCORE_API_KEY is missing or does not match the minted key shape (rs_live_ followed by 64 lowercase hex characters), it exits immediately with an actionable error instead of failing on the first tool call. The configured value is never echoed. This is a shape check only — real key verification stays server-side (run the whoami tool).

Tools

ToolWhat it does
quote_mev_coverModeled premium estimate for MEV-sandwich exposure on a swap (modeled premium, expected/CVaR loss).
quote_bridge_refundModeled premium estimate for cross-chain bridge execution failure vs a modeled SLA expectation.
quote_lrt_slashingModeled premium estimate for slashing risk on an LRT position given AVS exposure.
simulate_scenarioWhat-if Monte Carlo: modeled expected premium vs refund/loss over a horizon.
check_swapPre-trade check an agent runs before it signs: modeled route quality, price-impact / slippage band, modeled MEV/execution exposure where observable, and a token registry read (recognized vs unverified), as a clear / caution / unsupported verdict. Supports Ethereum (1) and Robinhood Chain (4663). Recognition is not safety, sellability, rights, redemption, liquidity, or investment-quality verification. Decision support, not execution. Every keyed call also attempts to persist a hash-verifiable evidence record and returns its record_id, evidence_bundle_id, and record_output_hash — null, with a record_persistence_failed caveat, if the record store is unavailable.
get_preflight_recordFetch one persisted preflight evidence record by record_id (owner-scoped to the configured key's account). The record embeds the original check response verbatim plus a canonical-JSON SHA-256 integrity hash so the evidence can be re-verified offline. Read-only evidence: record creation rejects known execution-material keys (calldata, transaction payloads, signing material) and drops identity-shaped labels from the actor context.
get_detector_manifestLatest public MEV-detector run manifest (version hash + universe).
whoamiConfirm the key works and report its plan tier.

All quote_* tool results are modeled, point-in-time premium estimates — decision support only, not a live cover, insurance, refund, or premium-acceptance offer. Routescore does not underwrite risk.

Output contract

Routescore MCP is decision support, not execution infrastructure. check_swap, quote, and scenario tool results preserve the same trust envelope as the REST API, and the wrapper marks output as degraded if the upstream API ever omits required trust fields.

check_swap answers verdict: unsupported as an HTTP 422 with a full evaluated body — an answer, not an error. The wrapper relays those evaluated 422 bodies as normal structured tool results (gap-state fields, caveats, and record linkage included) so agents receive "not evaluated" as first-class evidence; true errors (400/401/403/404/429/5xx and non-evaluated 422 error envelopes) still surface as tool errors.

Downstream agents and dashboards should render the trust-envelope fields by default (abbreviated example):

json
{  "score_state": "partial",  "source_freshness": {    "state": "partial",    "checked_at": "2026-06-21T00:00:00.000Z",    "sources": [      { "name": "routescore_backend", "freshness_state": "fresh" },      { "name": "bridge_risk_labels", "freshness_state": "unknown" }    ]  },  "methodology_version": "routescore.public_api.v1",  "confidence_band": { "low": null, "high": null, "unit": "bps" },  "caveats": [    "Modeled, point-in-time decision support. Not an execution guarantee.",    "Unsupported or stale inputs widen uncertainty instead of hiding risk."  ],  "commercial_disclosure": {    "paid_placement": false,    "score_influenced_by_partner": false  }}

Local development

bash
npm installnpm run buildROUTESCORE_API_KEY=rs_live_... ROUTESCORE_API_URL=http://localhost:3000 node dist/index.js

Then point MCP Inspector at the command, or wire it into a client config as above.

Public Reddit research utility

The retail-research workflow includes a standard-library parser for a saved, publicly rendered old Reddit thread. It extracts public handles, comment counts, IDs, and permalinks without logging in or attempting to recover deleted authors:

bash
python3 scripts/scrape_reddit_public_handles.py /path/to/thread.html \  --csv work/reddit-public-handles.csv \  --json work/reddit-public-handles.json

The input must be HTML already obtained from a public old.reddit.com thread. The parser does not fetch pages or bypass Reddit access controls.

Notes

  • Scenario and quote outputs are modeled decision-support, not investment advice.
  • MCP does not custody assets, execute transactions, route funds, or guarantee outcomes.
  • Rate limits apply per key; responses carry X-RateLimit-* headers.

来源：README.md，提交 e3d5bbf

工具

11

check_swap

Check swap before signing (pre-sign evidence)

CALL THIS BEFORE SIGNING AN ONCHAIN SWAP. Read-only pre-sign evidence check: given notional, chain, and an optional route and token, it returns a modeled route-quality grade, price-impact / slippage band, modeled MEV/execution exposure where observable, and a token registry read (recognized vs unverified), composed into a clear / caution / unsupported verdict with machine-readable reasons and caveats. Point-in-time decision support: it does not execute, route funds, sign, or promise an outcome — the agent still decides. Recognition is not safety, sellability, redemption, rights, liquidity, or investment-quality verification; unverified tokens, unknown order flow, and uncalibrated sequencer ordering downgrade the verdict rather than reading as safe. Relay the verdict, reasons, and caveats verbatim.

输入参数routechain_idtoken_intoken_outnotional_usd必填slippage_allowance_bps

get_preflight_record

Retrieve pre-sign evidence record

Retrieve the durable evidence record a prior check_swap call persisted — the "record" leg of plan → preflight → execute → record. Fetch one record by the record_id that check_swap returned. Owner-scoped: the configured key only ever sees records belonging to its own account. The record embeds the evaluated check_swap response payload (including its evidence_bundle_id, before the additive record_id / record_output_hash linkage fields) plus a canonical-JSON SHA-256 integrity hash (record_id and recorded_at excluded) so the evidence can be re-verified offline, and includes the stored evidence bundle. Read-only evidence: record creation rejects known execution-material keys (calldata, transaction payloads, signing material) and drops identity-shaped labels from the actor context.

输入参数record_id必填

record_execution

Record immutable execution evidence

Persist 1-100 already-built execution_record.v1 documents as immutable, personal-account post-trade evidence. Requires a stable idempotency_key; an exact replay returns the original result and reuse with different content fails closed. Pro tier, owner-scoped, and bounded by the MCP transport byte limit. This tool never accepts calldata, signing material, routes funds, executes a transaction, applies reviewer overrides, or exposes another tenant. Invalid rows are recorded only as redacted rejection reasons and are never echoed.

输入参数records必填idempotency_key必填

review_execution

Review stored execution evidence

Review one stored execution_record.v1 by record_id. Authenticated and personal-account owner-scoped: another account’s id is indistinguishable from a missing id. Returns the deterministic review_execution.v1 evidence coverage, exceptions, unavailable-evidence register, caveats, and canonical hash. Read-only retrospective decision support only: it does not query arbitrary public transactions, accept reviewer overrides, certify best execution or compliance, give advice, or expose admin actions.

输入参数record_id必填

review_public_transaction

Review public Ethereum transaction

DEV-ONLY CONTRACT DISCOVERY; DISABLED AGAINST PRODUCTION. On an explicitly enabled non-production server, review one arbitrary public Ethereum transaction by transaction hash. This is separate from review_execution: it does not read an owner-scoped stored execution_record.v1 and never exposes tenant, reviewer, override, or administrative fields. Returns the deterministic tenant-free public_transaction_review.v1 coverage register, conclusions, explicit gap register, source provenance, caveats, and canonical hash. Receipt, block, index, and gas facts are measured; gas cost and point-in-time confirmation depth are calculated. Venue is unavailable in this endpoint until a server-owned verified registry adapter exists. Route, amounts, protocol fee, arrival price, feasible-route benchmark, dropped status, and historical reorg remain unavailable unless the public contract can support them. Read-only retrospective decision support only; it does not certify best execution or compliance and does not give advice.

输入参数tx_hash必填chain_id必填

whoami

Verify API key & tier

Confirm the configured API key works and report which plan tier it carries. Returns the owning account email and tier.

无需输入参数。

get_detector_manifest

Get MEV-detector manifest

Fetch the latest public MEV-detector run manifest: the detector version hash and the eligible pool/token universe it was committed to. Use to verify what the detector covers.

无需输入参数。

quote_mev_cover

Quote: MEV-sandwich premium (modeled)

Modeled premium estimate for MEV-sandwich exposure on a swap. Returns a modeled premium (bps + USD), expected/CVaR loss, and conditions. Point-in-time decision support before routing a trade — not a live cover, insurance, or premium-acceptance offer.

输入参数routechain_idasset_pairnotional_usd必填refund_threshold_bpsslippage_allowance_bpshistorical_sandwich_freq

quote_bridge_refund

Quote: bridge-failure premium (modeled)

Modeled premium estimate for cross-chain bridge execution failure against a modeled SLA expectation. Returns a modeled premium and conditions — not a live cover, refund, or premium-acceptance offer.

输入参数bridgesla_secondsnotional_usd必填dest_chain_idsource_chain_idbridge_risk_score

quote_lrt_slashing

Quote: LRT-slashing premium (modeled)

Modeled premium estimate for slashing risk on a liquid-restaking-token (LRT) position given its AVS exposure. Returns a modeled premium and slashing bounds — not a live cover offer.

输入参数lrt_tokencovered_eth_amount必填cover_duration_weekscorrelation_max_overlapunderlying_avs_exposure

simulate_scenario

Simulate premium-vs-loss scenario (modeled)

Run a what-if Monte Carlo: model expected premium vs expected refund/loss over a horizon, given assumptions about sandwich frequency, average loss, and deductible. Returns a narrative + distribution.

输入参数avg_loss_bpshorizon_daysnotional_usd必填deductible_bpssandwich_freq_pct

版本历史

1
  1. v0.3.5最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分