> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atlasyield.club/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP server

> Four read-only tools an agent can call for judgment before it moves money. No key, no custody.

`@atlasyield/mcp` wraps the public `/v1` API and the published score history as a
[Model Context Protocol](https://modelcontextprotocol.io) server over stdio.

```bash theme={null}
claude mcp add atlasyield -- npx -y @atlasyield/mcp
```

```json theme={null}
{ "mcpServers": { "atlasyield": { "command": "npx", "args": ["-y", "@atlasyield/mcp"] } } }
```

| Tool                   | Input                                    | Gives you                                                                                                                                                                                                                                                                                                                                     |
| ---------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_vault_score`      | `chainId`, `address`                     | Latest composite, label, the four pillar scores, live APY/TVL, `found:false` if unscored.                                                                                                                                                                                                                                                     |
| `get_coverage`         | `chainId?`, `protocolId?`                | Vault count, TVL, composite min/median/max, counts by protocol and chain.                                                                                                                                                                                                                                                                     |
| `check_route_survival` | `chainId`, `address`                     | Today's same-chain round-trip route screen. `blocking:true` (NO\_ROUTE, DANGEROUS, UNPRICEABLE) means refuse the deposit; `reasonClass` says why (`protocol_refused` = the vault is dead, `no_aggregator_quote` = no priced same-chain route into the underlying). `screened:false` means unjudged, never cleared. Cross-chain is not probed. |
| `list_open_alerts`     | `chainId?`, `minSeverity?`               | Open monitor alerts from the daily snapshot with score before/after.                                                                                                                                                                                                                                                                          |
| `explain_vault_score`  | `chainId`, `address`                     | Why the score is what it is: all 16 factors grouped by pillar with sub-score, weight, raw input and label, plus the three weakest factors.                                                                                                                                                                                                    |
| `compare_vaults`       | `vaults[]` (2-8 of `chainId`, `address`) | Side-by-side scores, pillars, live APY/TVL, yieldQuality and exitSafety, ranked by composite. Unscored entries come back `found:false`.                                                                                                                                                                                                       |

Every result carries the disclaimer: research and information, not investment advice.

## What it refuses to do

There is no deposit, sign, or send tool, and none will be added. The point of the server is the
refusal: an agent asks whether a route survives a round trip and is told **no** before it moves a
user's money. Execution, where it exists, is a separate API with its own guards, not an MCP tool.

Source: `apps/mcp` in the AtlasYield repo. Data licence: [https://atlasyield.club/data-license](https://atlasyield.club/data-license)