{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_pnqx9bq2s5jt","handle":"zado-mcp","url":"https://wellknown.network/agents/zado-mcp","links":{"self":"https://wellknown.network/agents/zado-mcp/record.json","html":"https://wellknown.network/agents/zado-mcp","markdown":"https://wellknown.network/agents/zado-mcp/record.md","api":"https://wellknown.network/api/v1/agents/zado-mcp","status":"https://wellknown.network/api/v1/agents/zado-mcp/status","claim":"https://wellknown.network/agents/zado-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/zado-mcp/claim.json","badge":"https://wellknown.network/agents/zado-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:zado-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"zado-mcp","summary":"Zado MCP server — AI agent access to envelope budgets via the Model Context Protocol","description":"# zado-mcp\n\n> **One-line install for AI agent access to your Zado envelope budgets.**\n\nYou review the budget on the weekends; your agents shop all week. `zado-mcp` is the [Model Context Protocol](https://modelcontextprotocol.io) server that connects any MCP-capable AI agent (Claude Code, Claude Desktop, OpenAI Assistants, custom) to your [Zado](https://zadofi.ai) instance. The server runs locally over stdio, but every authorization, spending guard, and audit entry is enforced server-side — `zado-mcp` is a pure transport bridge, not a trust boundary.\n\n```\nAI Agent → zado-mcp (local stdio) → HTTPS → zadofi.ai → real envelopes\n```\n\nThe canonical, citable spec for the surface this server implements is the [Zado Agent Trust Protocol v0.1](https://zadofi.ai/protocol/zado-agent-trust-protocol-v0.1).\n\n## Install\n\n```bash\npip install zado-mcp\n```\n\nRequires Python ≥ 3.10. Two dependencies: [`mcp`](https://pypi.org/project/mcp/), [`httpx`](https://pypi.org/project/httpx/).\n\n## Get an agent token\n\nIn the Zado app: **Settings → [Agent Access](https://zadofi.ai/settings/agent-access) → Create Agent**. Choose:\n\n- **Name** — e.g. \"Claude Code\", \"OpenClaw\", \"Walmart shopper\"\n- **Scope** — `read` (view only) or `spend` (view + authorize purchases)\n- **Envelopes** — optional: bind the agent to specific categories (e.g. groceries only)\n- **TTL** — token lifetime (default 90 days)\n\nCopy the token when shown — it's displayed **once**.\n\n## Quick Start\n\n```bash\nzado-mcp init\n```\n\nThe interactive flow prompts for your Zado instance URL (default `https://zadofi.ai`) and the agent token (input is hidden), then writes `~/.config/zado-mcp/config.json` (mode `0600`). The server reads URL + token from that file at startup — **no env vars required** in most setups.\n\nAfter `init`, paste this short snippet into your agent's MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"zado\": {\n      \"command\": \"zado-mcp\",\n      \"args\": [\"serve\"]\n    }\n  }\n}\n```\n\nResolution order: explicit kwargs → `ZADO_API_URL` /…","publisher":null,"homepage":"https://zadofi.ai/protocol/zado-agent-trust-protocol-v0.1","repository":"https://github.com/evo-hydra/zado/issues","version":"0.2.0","license":null,"protocols":["mcp"],"tags":["mcp","model-context-protocol","ai","agent","budget","finance","zado"],"pricing":null,"endpoints":[{"url":"pypi:zado-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.825,"provenance":"derived"},{"slug":"ai.prompting","name":"Prompt Management","confidence":0.791,"provenance":"derived"}],"categories":["ai","dev"],"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":"zado-mcp","registry":"pypi","observedAt":"2026-09-10T16:24:32.921Z","publishedAt":"2026-05-03T12:01:25.983848Z","latestVersion":"0.2.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"zado-mcp","url":"https://pypi.org/project/zado-mcp/","firstSeenAt":"2026-09-10T16:23:44.684Z","fetchedAt":"2026-09-10T16:23:44.684Z","normalizedAt":"2026-09-10T16:23:44.684Z"}]},"firstSeenAt":"2026-09-10T16:23:44.684Z","updatedAt":"2026-09-10T16:24:32.921Z"}