gveshk/atlasyield-mcp

Read-only MCP server for the AtlasYield judgment layer. Seven tools, no key, no custody,
no execution: an agent asks for judgment and is told when a route is unsafe.
| Tool | Answers |
|---|---|
| find_vaults | No vault address yet? A short ranked list for an asset and chain (chain: "base"), routable vaults only, about 2 KB. A ranking, not a recommendation. |
| get_vault_score | Latest 16-factor Atlas Score for one vault (composite, label, 4 pillars, live APY/TVL). |
| get_coverage | What is scored right now: vault count, TVL, score spread, by protocol and chain. |
| check_route_survival | Can a deposit be exited at size, measured today? blocking:true means refuse. |
| list_open_alerts | Open blowup-monitor alerts from the published daily snapshot. |
| explain_vault_score | Why: all 16 factors by pillar (sub-score, weight, raw input, label) and the three weakest. |
| compare_vaults | 2-8 vaults side by side, ranked by composite; unscored ones stay visible as found:false. |
Data comes from the public API https://api.atlasyield.club/v1 and the published score
history https://github.com/gveshk/atlasyield-score-history. Scored every 4 hours, snapshot
published daily. Research and information, not investment advice.
Install
Claude Code:
Claude Desktop / Cursor / any stdio client (mcp.json or claude_desktop_config.json):
From a checkout: npm install && npm run build then use "command": "node", "args": [" /dist/index.js"].
Docker: docker build -t atlasyield-mcp . then "command": "docker", "args": ["run", "-i", "--rm", "atlasyield-mcp"].
Try it
> Is Morpho WETH on Base (0x09832347586e238841f49149c84d121bc2191c53) safe to enter at $10k?
The agent calls get_vault_score, then check_route_survival. A NO_ROUTE verdict comes
back as blocking: true and a plain-English refusal.
Without an MCP client: npm run build && node scripts/smoke.mjs check_route_survival '{"chainId":8453,"address":"0x..."}'
speaks raw JSON-RPC to the binary over stdio.
Environment
- ATLAS_API_BASE — override the API base (default https://api.atlasyield.club/v1)
- ATLAS_SNAPSHOT_BASE — override the score-history raw base