@augustdigital/mcp

Local stdio Model Context Protocol server exposing the August Digital SDK's read surface as MCP tools. Shares its config under ~/.augustdigital/ with @augustdigital/cli, and returns the same JSON envelope — tool results are diff-clean against the matching august … --json output.

Read-only. No signing or write tools.

Tools

| Group | Tools | | ----------- | -------------------------------------------------------------------------------------------------------------------------------- | | Meta | whoami, chain_list, rpc_test | | Discovery | vault_list, vault_search | | Vault | vault_get, vault_apy, vault_tvl, vault_positions, vault_loans, vault_allocations, vault_redemptions, vault_history, vault_summary | | User | user_points, user_positions, user_pnl | | Data | points_leaderboard, vault_pending_redemptions, vault_pnl_history, pnl_latest | | Activity | vault_activity, activity_ranking, user_activity, user_transfers | | Reads | total_deposited, token_price, vault_withdrawals, vault_pnl, vault_annualized_apy, withdrawal_requests_status | | Subaccounts | subaccount_list, subaccount_summary, subaccount_health_factor, subaccount_loans, subaccount_cefi_positions, subaccount_otc_positions, subaccount_transactions, subaccount_loan_by_address, subaccount_debank | | Risk | dashboard_loans, risk_discount_factors, risk_collateral_excess, risk_collateral_simulate | | Triage | tx_revert_reason | | OTC | otc_positions_list, otc_margin_requirements | | Curator | curator_vault_subaccounts, curator_vault_whitelist | | Governance | timelock_requests_list, vault_performance_fees, vault_oracle_classification | | Ops | ops_health, ops_redemptions | | LayerZero | layerzero_deposits, layerzero_redeems | | Docs | docs_search, docs_fetch, docs_list |

Activity answers flow questions — vault_activity returns a vault's deposit/withdrawal feed plus a computed summary (counts, volumes, net flow), and activity_ranking ranks vaults by activity over a window ("which vaults had the most deposits last week"). Most vault/user tools mirror an august … CLI command; subaccount_* and layerzero_* read the institutional and cross-chain surfaces respectively.

Every tool result:

{
  "schemaVersion": 1,
  "command": "vault.apy",
  "ok": true,
  "data": { "address": "0x…", "chainId": 8453, "currentApy": 0.1234 },
  "meta": { "chainId": 8453, "durationMs": 312, "generatedAt": "2026-05-17T…" }
}

Install

npm install -g @augustdigital/mcp

Or invoke without installing:

npx -y @augustdigital/mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "august": {
      "command": "npx",
      "args": ["-y", "@augustdigital/mcp"],
      "env": {
        "AUGUST_PASSPHRASE": "${env:AUGUST_PASSPHRASE}",
        "AUGUST_CONFIG_DIR": "${env:HOME}/.augustdigital"
      }
    }
  }
}

Claude Code

claude mcp add august npx -y @augustdigital/mcp

Auth

API key resolution (first hit wins):

1. AUGUST_API_KEY
2. Active session — created by august login or auto-unlocked from AUGUST_PASSPHRASE at server startup.

When neither is present, authenticated tools return code: "API_KEY_MISSING" with a remediation hint. Public read methods still work.

Programmatic use

import { buildServer, bootstrap } from '@augustdigital/mcp';

await bootstrap();
const server = buildServer();
// attach your own transport (e.g. an in-memory pair for testing)

Transports

Stdio is the default (shown in the quickstart). For a shared instance, run streamable HTTP:

AUGUST_MCP_TOKEN=<team-token> august-mcp --http --port 8787

• Endpoint: POST/GET http://<host>:8787/mcp
• Every request must send Authorization: Bearer <team-token>; anything else gets a 401.
• The server binds 127.0.0.1 unless AUGUST_MCP_HOST says otherwise.
• Stateless mode: no session affinity needed behind a load balancer.
• The surface is identical to stdio (same tools, resources, prompts, and JSON envelopes). No keystore is read in HTTP mode — provide AUGUST_API_KEY via the environment if authenticated tools are needed.

Claude Code connection:

claude mcp add --transport http august http://<host>:8787/mcp \
  --header "Authorization: Bearer <team-token>"

Resources & prompts

• Resources: august://chains, august://errors, august://vaults/{chainId} (use 0 for all chains).
• Prompts: analyze-vault-health, compare-vaults, explain-user-position.