Zado MCP server — AI agent access to envelope budgets via the Model Context Protocol
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":"zado-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.
# zado-mcp > **One-line install for AI agent access to your Zado envelope budgets.** You 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. ``` AI Agent → zado-mcp (local stdio) → HTTPS → zadofi.ai → real envelopes ``` The 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). ## Install ```bash pip install zado-mcp ``` Requires Python ≥ 3.10. Two dependencies: [`mcp`](https://pypi.org/project/mcp/), [`httpx`](https://pypi.org/project/httpx/). ## Get an agent token In the Zado app: **Settings → [Agent Access](https://zadofi.ai/settings/agent-access) → Create Agent**. Choose: - **Name** — e.g. "Claude Code", "OpenClaw", "Walmart shopper" - **Scope** — `read` (view only) or `spend` (view + authorize purchases) - **Envelopes** — optional: bind the agent to specific categories (e.g. groceries only) - **TTL** — token lifetime (default 90 days) Copy the token when shown — it's displayed **once**. ## Quick Start ```bash zado-mcp init ``` The 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. After `init`, paste this short snippet into your agent's MCP config: ```json { "mcpServers": { "zado": { "command": "zado-mcp", "args": ["serve"] } } } ``` Resolution order: explicit kwargs → `ZADO_API_URL` /…
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.