PZERO

Hosted Model Context Protocol at https://mcp.pzero.studio/mcp. Point Cursor, Claude, Claude Code, or any remote MCP client at that URL after you have topped up.

initialize, notifications/initialized, ping, tools/list, resources/list, resources/templates/list, and prompts/list do not require a key so directories can catalog the connector. tools/call and other spend or account methods still need Authorization: Bearer pzero_….

MCP spends prepaid USDC balance. It does not run x402 itself. Choose how you fund it:

• Top Up with x402 (agent HTTP signup / refill)
• Mint an API Key in Studio

Agent-facing copy of this guide is also on the API host: MCP.md.

Add it to your client

Pick your client, paste or follow the steps, reload MCP, then ask the agent to call agent_me.

Paste into Cursor MCP settings, reload MCP, then ask your agent to call agent_me.

{
  "mcpServers": {
    "pzero": {
      "url": "https://mcp.pzero.studio/mcp",
      "headers": {
        "Authorization": "Bearer ${env:PZERO_API_KEY}"
      }
    }
  }
}

Image and video use the same key and the same prepaid balance.

Call tools

Call agent_me first after connect; PZERO tools spend prepaid USDC.

Access

Tool	What it does
agent_me	Returns balances, key prefix, and max price; pending USDC is not spendable until confirmed.
list_keys	Lists active API key metadata, never plaintext.
create_key	Mints another key; does not add USDC; plaintext is shown once.
revoke_key	Irreversibly revokes a key by key UUID.
set_max_price	Raises or lowers the buyer ceiling, 30 to 80 cents per DIEM dollar.
get_request	Recovers cost and trace for a prior request by support_reference UUID.

Funding

Tool	What it does
funding_instructions	Explains how to fund and authenticate; MCP never accepts payment or wallet keys.

Inference

Tool	What it does
chat_completions	Runs buffered chat completions; pass a live model id from get_models.
generate_image	Generates images; returns images plus cost trace.
generate_video	Settles then enqueues video; returns queue_id plus cost; confirm before spend.
video_quote	Returns a quote only; no settle, no job.
video_queue	Runs paid settle and enqueue; prefer generate_video for agents.
get_generation_status / video_retrieve	Polls status or fetches the delivered MP4 once.
wait_for_video	Polls until delivered or failed.
video_complete	Optional cleanup after retrieve.

Catalog

Tool	What it does
get_models	Resolves a live model id before inference.
get_capacity	Shows routable DIEM and price bands before funding or spend.

FAQ

Do I need an API key?

Yes to spend. Put Authorization: Bearer pzero_… on the connection before agent_me, inference, or key tools. Directory scanners may initialize, notifications/initialized, ping, tools/list, resources/list, resources/templates/list, and prompts/list without a key; those methods do not read a wallet.

How do I install the Claude Code plugin?

Claude Code 2.1.224 or later can add the hosted marketplace, then install pzero@pzero. Set PZERO_API_KEY before enabling:

claude plugin marketplace add https://docs.pzero.studio/claude-plugin/marketplace.json
claude plugin install pzero@pzero

The claude mcp add command in the client card still works on older Claude Code.

LibreChat or Open WebUI?

Paste-ready librechat.yaml and Open WebUI admin steps live on MCP.md.

How long do videos take?

Async: generate_video / video_queue returns a queue_id; poll with get_generation_status or wait_for_video.

Where is the HTTP contract?

Agents overview and live SKILL.md.