@augustdigital/mcp

Local stdio Model Context Protocol server exposing the August Digital SDK's read surface as MCP tools, plus documentation, GitHub, and Jira helpers for triage. 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.

No chain writes: nothing here signs or broadcasts a transaction. The one tool that creates anything is jira_create_ticket, which opens a Jira issue when Jira credentials are configured (see Integrations).

Tools

70 tools in 19 groups.

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.

Triage / Decode work from an error rather than an address — tx_revert_reason traces a mined transaction hash; decode_revert_data decodes a raw revert blob or a whole ethers error string when no hash exists (estimateGas / eth_call failures); simulate_call replays a call to recover truncated revert data; read_token_state reads an ERC-20 holder's balance, allowance, and issuer compliance flags to separate user error from a freeze.

Docs / GitHub / Jira support the same triage loop: search and fetch the August and Upshift documentation, read source and pull requests from the August GitHub organizations, and file the result as a Jira issue.

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 — or the backend rejects the key — authenticated tools return code: "API_KEY_MISSING" with a remediation hint. Public read methods still work.

Integrations

The GitHub and Jira groups talk to external services and are inert until their credentials are present in the environment:

Telemetry

The server reuses the SDK's Sentry telemetry and follows the shared telemetry setting in ~/.augustdigital/config.json — off by default, on after august init (when you accept the prompt) or august config set telemetry true. When on, SDK errors and tool failures other than configuration problems are reported tagged sdk.surface: mcp and app.name: august-mcp, and every backend request carries x-august-app: august-mcp. AUGUST_SDK_DISABLE_ANALYTICS=1 forces it off regardless of config.

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.