About AtlasYield
AtlasYield is a read-only MCP server for agents assessing DeFi vaults. It provides 16-factor scores, route-survival checks, and alerts without deposit or transaction tools.
Key features
- 01Rank routable vaults by asset and chain
- 02View 16-factor scores and score explanations
- 03Check whether routes can exit at a given size
- 04Review open blowup-monitor alerts
- 05Compare vaults and inspect coverage
Use cases
- 01Screen vaults before considering a deposit
- 02Check exit feasibility for a planned position size
- 03Investigate weak factors behind a vault score
- 04Review alerts across supported protocols and chains
MCP support
The MCP server provides seven read-only tools for finding, scoring, comparing, and checking DeFi vaults and routes.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://atlasyield.club/mcpclaude mcp add --transport http club-atlasyield https://atlasyield.club/mcp{"mcpServers":{"club-atlasyield":{"type":"http","url":"https://atlasyield.club/mcp"}}}Open in Cursor{"servers":{"club-atlasyield":{"type":"http","url":"https://atlasyield.club/mcp"}}}Open in VS Code{"mcpServers":{"club-atlasyield":{"type":"http","url":"https://atlasyield.club/mcp"}}}{"mcpServers":{"club-atlasyield":{"serverUrl":"https://atlasyield.club/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
7| Parameter | Type | Required | Description |
|---|---|---|---|
| asset | any | No | Underlying asset symbol, or a list of up to 10, e.g. USDC or ["USDC","USDT0"]. Exact match: USDC does not include syrupUSDC (similarAssets lists near misses) |
| chain | any | No | Chain name (base, ethereum, arbitrum, optimism, bnb, solana) or EVM chain id |
| limit | integer | No | Rows to return, default 5, max 10 |
| minApy | number | No | Minimum live APY in percentage points, e.g. 10 for 10% |
| sortBy | enum | No | Rank by this, descending. Default compositecomposite | apy | tvl |
| minScore | number | No | Minimum Atlas composite (0-100) |
| minTvlUsd | number | No | Minimum live TVL in USD |
| protocolId | string | No | Protocol slug, e.g. morpho, aave-v3, pendle |
Details
From the project README@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 mcp add atlasyield -- npx -y @atlasyield/mcp
Claude Desktop / Cursor / any stdio client (mcp.json or claude_desktop_config.json):
{
"mcpServers": {
"atlasyield": { "command": "npx", "args": ["-y", "@atlasyield/mcp"] }
}
}
From a checkout: npm install && npm run build then use "command": "node", "args": ["<checkout>/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 (defaulthttps://api.atlasyield.club/v1)ATLAS_SNAPSHOT_BASE— override the score-history raw base
What this is not
No deposit, sign, or send tool exists here and none will be added. Execution, if offered, is a
separate API with its own guards (recipient-safety, assertRouteValue) — never an MCP tool.
Docs: https://docs.atlasyield.club/api-reference/mcp · Licence: MIT · Data licence: https://atlasyield.club/data-license
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.