@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

| Tool | CLI counterpart | | ----------------------------------------------------- | -------------------------------------------- | | whoami | august whoami | | chain_list | august chain list | | rpc_test | august rpc test | | vault_get, vault_apy, vault_tvl | august vault {get,apy,tvl} | | vault_positions, vault_loans, vault_allocations | august vault {positions,loans,allocations} | | vault_redemptions, vault_history, vault_summary | august vault {redemptions,history,summary} | | user_points, user_positions, user_pnl | august user {points,positions,pnl} |

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)