{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_7h884x6hzqa8","handle":"nz-akahu-mcp","url":"https://wellknown.network/agents/nz-akahu-mcp","links":{"self":"https://wellknown.network/agents/nz-akahu-mcp/record.json","html":"https://wellknown.network/agents/nz-akahu-mcp","markdown":"https://wellknown.network/agents/nz-akahu-mcp/record.md","api":"https://wellknown.network/api/v1/agents/nz-akahu-mcp","status":"https://wellknown.network/api/v1/agents/nz-akahu-mcp/status","claim":"https://wellknown.network/agents/nz-akahu-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/nz-akahu-mcp/claim.json","badge":"https://wellknown.network/agents/nz-akahu-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/nz-akahu-mcp/history","tools":"https://wellknown.network/api/v1/agents/nz-akahu-mcp/tools"},"ard":{"identifier":"urn:air::server:nz-akahu-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"nz-akahu-mcp","summary":"Unofficial MCP server for the Akahu open-finance API (New Zealand). Personal Apps, read-by-default, write-with-consent.","description":"# nz-akahu-mcp\n\nUnofficial MCP server for the [Akahu](https://akahu.nz) open-finance API\n(New Zealand). Bring your own Akahu credentials; run locally over stdio; no\nhosted backend.\n\n- **14 tools.** Account & balance reads, settled & pending transaction reads, batch lookup by id, identity read, refresh writes, support-ticket writes, name verification.\n- **Read-only by default.** Every write tool refuses until `AKAHU_READ_ONLY=false`.\n- **Per-call consent for every write.** Each write calls `ctx.elicit()` for confirmation in the client.\n- **Personal Apps only.** App-scoped endpoints, payments, and webhooks are not exposed.\n\n## Prerequisites\n\n1. **Akahu Personal App + User token** - register at https://my.akahu.nz/developers\n2. **[`uv`](https://docs.astral.sh/uv/)** for the `uvx` runner (or pip with a virtualenv)\n3. **[Claude Code](https://docs.claude.com/en/docs/claude-code/overview)** or **[Claude Desktop](https://claude.ai/download)**\n\nThe 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:\n\n```bash\nexport AKAHU_APP_TOKEN=\"app_token_...\"\nexport AKAHU_USER_TOKEN=\"user_token_...\"\n# Optional - everything below is the default:\nexport AKAHU_READ_ONLY=true\nexport AKAHU_AUTOMATION_BYPASS=false\n```\n\n## Install in Claude Code\n\n### Marketplace plugin (recommended)\n\nTokens 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.\n\nClaude Code v2.1.83 or later:\n\n```text\n/plugin marketplace add severity1/severity1-marketplace\n/plugin install nz-akahu-mcp@severity1-marketplace\n```\n\nAfter 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…","publisher":{"name":"nz-akahu-mcp contributors","url":null},"homepage":"https://github.com/severity1/nz-akahu-mcp","repository":"https://github.com/severity1/nz-akahu-mcp/releases","version":"0.1.5","license":"Apache-2.0","protocols":["mcp"],"tags":["akahu","banking","mcp","new-zealand","open-finance"],"pricing":null,"endpoints":[{"url":"pypi:nz-akahu-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"finance.banking","name":"Banking","confidence":1,"provenance":"declared"},{"slug":"security.secrets","name":"Secrets Management","confidence":0.859,"provenance":"derived"},{"slug":"commerce.payments","name":"Payments","confidence":0.814,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.745,"provenance":"derived"}],"categories":["commerce","dev","finance","security"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"nz-akahu-mcp","registry":"pypi","observedAt":"2026-11-03T20:29:34.724Z","publishedAt":"2026-07-24T22:48:57.071263Z","latestVersion":"0.1.5"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"nz-akahu-mcp","url":"https://pypi.org/project/nz-akahu-mcp/","firstSeenAt":"2026-09-10T08:25:50.156Z","fetchedAt":"2026-11-03T20:28:05.163Z","normalizedAt":"2026-11-03T20:28:05.163Z"}]},"firstSeenAt":"2026-09-10T08:25:50.156Z","updatedAt":"2026-11-03T20:29:34.724Z"}