Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.alterscope.org/llms.txt

Use this file to discover all available pages before exploring further.

The Alterscope MCP server exposes risk data to MCP-compatible AI clients (Claude Code, Claude Desktop, and other MCP hosts) as a set of tools and resources. It runs over the standard MCP stdio transport.

​
Connect (Claude Code)

Build the server, then register it: 
claude mcp add --transport stdio alterscope -- node /path/to/alterscope-mcp/dist/index.js
Set ALTERSCOPE_API_URL to the API base it should read through, and pass your API key via the server’s configured authorization.

​
Connect (Claude Desktop)

Add an entry to claude_desktop_config.json: 
{
  "mcpServers": {
    "alterscope": {
      "command": "node",
      "args": ["/path/to/alterscope-mcp/dist/index.js"]
    }
  }
}

​
Tools

The server registers these tools:
ToolWhat it does
alterscope_pingConnectivity smoke check.
query_risk_graphQuery the knowledge graph.
get_regimeRead the current market regime.
analyze_pool_riskRisk decomposition for a lending pool.
score_strategyScore a strategy.
backtest_strategyBacktest a strategy.
simulate_strategySimulate a strategy.
replay_cascade_eventReplay a cascade/contagion event.
list_yield_opportunitiesList yield opportunities.
audit_positionAudit a position.

​
Resources

Four Risk Graph resources are exposed under the alterscope://graph/ URI scheme:
ResourceURI
Graph nodealterscope://graph/node/{id}
Cascadealterscope://graph/cascade/{origin}
Dependenciesalterscope://graph/dependencies/{id}
Subgraphalterscope://graph/subgraph

​
Scopes

MCP tools are gated by mcp:* scopes on your API key (see Scopes): mcp:read for the read-only graph/regime/risk tools, mcp:backtest for backtest_strategy + replay_cascade_event, and mcp:simulate for simulate_strategy.