Connect via MCP
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.
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 for v1. Put Authorization: Bearer pzero_… on the MCP connection.
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.