Unofficial MCP server for the Akahu open-finance API (New Zealand). Personal Apps, read-by-default, write-with-consent.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"nz-akahu-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# nz-akahu-mcp Unofficial MCP server for the [Akahu](https://akahu.nz) open-finance API (New Zealand). Bring your own Akahu credentials; run locally over stdio; no hosted backend. - **14 tools.** Account & balance reads, settled & pending transaction reads, batch lookup by id, identity read, refresh writes, support-ticket writes, name verification. - **Read-only by default.** Every write tool refuses until `AKAHU_READ_ONLY=false`. - **Per-call consent for every write.** Each write calls `ctx.elicit()` for confirmation in the client. - **Personal Apps only.** App-scoped endpoints, payments, and webhooks are not exposed. ## Prerequisites 1. **Akahu Personal App + User token** - register at https://my.akahu.nz/developers 2. **[`uv`](https://docs.astral.sh/uv/)** for the `uvx` runner (or pip with a virtualenv) 3. **[Claude Code](https://docs.claude.com/en/docs/claude-code/overview)** or **[Claude Desktop](https://claude.ai/download)** The two recommended install paths below (marketplace plugin for Claude Code, `.mcpb` Desktop Extension for Claude Desktop) prompt for your tokens and store them in your OS keychain. Only the manual paths further down need shell env vars: ```bash export AKAHU_APP_TOKEN="app_token_..." export AKAHU_USER_TOKEN="user_token_..." # Optional - everything below is the default: export AKAHU_READ_ONLY=true export AKAHU_AUTOMATION_BYPASS=false ``` ## Install in Claude Code ### Marketplace plugin (recommended) Tokens prompt at install and are stored in your OS keychain (macOS Keychain on macOS, Windows Credential Manager on Windows). No shell env or `.env` file required; the package stays unchanged on PyPI. Claude Code v2.1.83 or later: ```text /plugin marketplace add severity1/severity1-marketplace /plugin install nz-akahu-mcp@severity1-marketplace ``` After install, `/mcp` should show `nz-akahu-mcp` connected. See [`plugin/README.md`](plugin/README.md) for the configure / reconfigure / uninstall flow and the full table of prompted value…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.