MCP Server
Read-only Model Context Protocol server exposing Upshift data as tools, resources, and prompts for AI agents.
Quickstart (Claude Code)
claude mcp add upshift -- npx -y @augustdigital/mcpClaude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"august": { "command": "npx", "args": ["-y", "@augustdigital/mcp"] }
}
}Then ask the agent to start from discovery: vault_list / vault_search resolve vault addresses, after which the per-vault tools (vault_summary, vault_apy, vault_pending_redemptions, vault_pnl_history, …) apply.
Surface
- 70 read-only tools — vault metadata/APY/TVL/positions/loans/redemptions, discovery, points leaderboard, unrealized-PnL series, deposit/withdrawal activity, subaccount and risk reads, docs search, RPC diagnostics.
- Resources —
august://chains,august://errors,august://vaults/{chainId},august://docs. - Prompts —
analyze-vault-health,compare-vaults,explain-user-position.
Every tool returns the same JSON envelope as august … --json (schemaVersion: 1, typed error.code + remediation on failure).
Shared HTTP instance
AUGUST_MCP_TOKEN=<team-token> august-mcp --http --port 8787Connect with Authorization: Bearer <team-token>. The surface is identical to stdio; no keystore is read in HTTP mode (AUGUST_API_KEY via env when authenticated tools are needed).
Config
Shares ~/.augustdigital/ with the CLI (AUGUST_CONFIG_DIR to override). RPCs come from AUGUST_RPC_<chainId> env vars or the config file; set AUGUST_PASSPHRASE to auto-unlock the keystore on startup.