PZERO is an MCP server published by studio.pzero, hosted at mcp.pzero.studio. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 18 tools, including agent_me, chat_completions, create_key, funding_instructions, generate_image.
Prepaid inference for agents over hosted MCP. Chat, image, and video.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
GET /v1/agent/me — balances, key prefix, max price. Pending USDC is not spendable until confirmed. If confirmed is low, call funding_instructions.
No parameters.
{
"name": "agent_me",
"description": "GET /v1/agent/me — balances, key prefix, max price. Pending USDC is not spendable until confirmed. If confirmed is low, call funding_instructions.",
"inputSchema": {
"type": "object",
"additionalProperties": false
}
}POST /v1/chat/completions (buffered). Pass a live model id from get_models. Returns completion plus cost trace headers.
| Parameter | Type | Description |
|---|---|---|
| model * | string | Live model id from get_models |
| messages * | ["null","array"] | OpenAI-style messages |
| max_tokens | ["null","integer"] | |
| temperature | ["null","number"] |
{
"name": "chat_completions",
"description": "POST /v1/chat/completions (buffered). Pass a live model id from get_models. Returns completion plus cost trace headers.",
"inputSchema": {
"type": "object",
"required": [
"model",
"messages"
],
"properties": {
"model": {
"type": "string",
"description": "Live model id from get_models"
},
"messages": {
"type": [
"null",
"array"
],
"items": {
"type": "object",
"additionalProperties": true
},
"description": "OpenAI-style messages"
},
"max_tokens": {
"type": [
"null",
"integer"
]
},
"temperature": {
"type": [
"null",
"number"
]
}
},
"additionalProperties": false
}
}POST /v1/agent/keys — mint another key. Does NOT add USDC credit. Plaintext shown once.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Label for the new API key |
{
"name": "create_key",
"description": "POST /v1/agent/keys — mint another key. Does NOT add USDC credit. Plaintext shown once.",
"inputSchema": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Label for the new API key"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}How to fund a PZERO account and authenticate MCP. MCP never accepts payment or wallet keys. Fund via Studio x402 top-up or agent HTTP signup/refill, then use Authorization Bearer pzero_…
No parameters.
{
"name": "funding_instructions",
"description": "How to fund a PZERO account and authenticate MCP. MCP never accepts payment or wallet keys. Fund via Studio x402 top-up or agent HTTP signup/refill, then use Authorization Bearer pzero_…",
"inputSchema": {
"type": "object",
"additionalProperties": false
}
}POST /v1/image/generate — intent tool for image generation. Rejects enable_web_search. Returns images plus cost trace.
| Parameter | Type | Description |
|---|---|---|
| n | ["null","integer"] | Variants 1-4 |
| model * | string | Live image model id from get_models |
| prompt * | string | |
| quality | string | |
| resolution | string | |
| aspect_ratio | string | |
| hide_watermark | ["null","boolean"] | |
| enable_web_search | ["null","boolean"] |
{
"name": "generate_image",
"description": "POST /v1/image/generate — intent tool for image generation. Rejects enable_web_search. Returns images plus cost trace.",
"inputSchema": {
"type": "object",
"required": [
"model",
"prompt"
],
"properties": {
"n": {
"type": [
"null",
"integer"
],
"description": "Variants 1-4"
},
"model": {
"type": "string",
"description": "Live image model id from get_models"
},
"prompt": {
"type": "string"
},
"quality": {
"type": "string"
},
"resolution": {
"type": "string"
},
"aspect_ratio": {
"type": "string"
},
"hide_watermark": {
"type": [
"null",
"boolean"
]
},
"enable_web_search": {
"type": [
"null",
"boolean"
]
}
},
"additionalProperties": false
}
}Intent tool: POST /v1/video/queue (settles then enqueues). Returns queue_id + cost. Confirm before calling — this spends prepaid USDC. Poll with get_generation_status or wait_for_video.
| Parameter | Type | Description |
|---|---|---|
| audio | ["null","boolean"] | |
| model * | string | Live video model id from get_models |
| prompt * | string | |
| duration | ["null","integer"] | |
| resolution | string | |
| aspect_ratio | string |
{
"name": "generate_video",
"description": "Intent tool: POST /v1/video/queue (settles then enqueues). Returns queue_id + cost. Confirm before calling — this spends prepaid USDC. Poll with get_generation_status or wait_for_video.",
"inputSchema": {
"type": "object",
"required": [
"model",
"prompt"
],
"properties": {
"audio": {
"type": [
"null",
"boolean"
]
},
"model": {
"type": "string",
"description": "Live video model id from get_models"
},
"prompt": {
"type": "string"
},
"duration": {
"type": [
"null",
"integer"
]
},
"resolution": {
"type": "string"
},
"aspect_ratio": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}GET /v1/capacity — routable DIEM and price bands before funding or spend decisions.
| Parameter | Type | Description |
|---|---|---|
| max_price_cents | ["null","integer"] | Optional buyer ceiling 30-80 |
{
"name": "get_capacity",
"description": "GET /v1/capacity — routable DIEM and price bands before funding or spend decisions.",
"inputSchema": {
"type": "object",
"properties": {
"max_price_cents": {
"type": [
"null",
"integer"
],
"description": "Optional buyer ceiling 30-80"
}
},
"additionalProperties": false
}
}POST /v1/video/retrieve once — JSON status or delivered MP4.
| Parameter | Type | Description |
|---|---|---|
| queue_id * | string | Queue id from video_queue / generate_video |
{
"name": "get_generation_status",
"description": "POST /v1/video/retrieve once — JSON status or delivered MP4.",
"inputSchema": {
"type": "object",
"required": [
"queue_id"
],
"properties": {
"queue_id": {
"type": "string",
"description": "Queue id from video_queue / generate_video"
}
},
"additionalProperties": false
}
}GET /v1/models — resolve a live model id before inference. Optional id retrieves one public row (same object as that id in the list). Do not hardcode model ids.
| Parameter | Type | Description |
|---|---|---|
| id | string | Optional venice model id (bare or pzero/). Omit for the full list. |
{
"name": "get_models",
"description": "GET /v1/models — resolve a live model id before inference. Optional id retrieves one public row (same object as that id in the list). Do not hardcode model ids.",
"inputSchema": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Optional venice model id (bare or pzero/). Omit for the full list."
}
},
"additionalProperties": false
}
}GET /v1/agent/requests/{support_reference} — recover cost/trace for a prior request.
| Parameter | Type | Description |
|---|---|---|
| support_reference * | string | UUID support reference from a prior call |
{
"name": "get_request",
"description": "GET /v1/agent/requests/{support_reference} — recover cost/trace for a prior request.",
"inputSchema": {
"type": "object",
"required": [
"support_reference"
],
"properties": {
"support_reference": {
"type": "string",
"description": "UUID support reference from a prior call"
}
},
"additionalProperties": false
}
}GET /v1/agent/keys — list active API key metadata (never plaintext).
No parameters.
{
"name": "list_keys",
"description": "GET /v1/agent/keys — list active API key metadata (never plaintext).",
"inputSchema": {
"type": "object",
"additionalProperties": false
}
}DELETE /v1/agent/keys/{id} — irreversible. Do not revoke the key used by this MCP session unless intentional.
| Parameter | Type | Description |
|---|---|---|
| id * | string | UUID of the key to revoke |
{
"name": "revoke_key",
"description": "DELETE /v1/agent/keys/{id} — irreversible. Do not revoke the key used by this MCP session unless intentional.",
"inputSchema": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "UUID of the key to revoke"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}PATCH /v1/agent/max-price — raise/lower ceiling (30-80). Use when tools return no_eligible_supply with cheapest_posted_cents. Does not auto-apply.
| Parameter | Type | Description |
|---|---|---|
| max_price_cents_per_dollar * | integer | Buyer ceiling in cents per DIEM dollar, 30-80 |
{
"name": "set_max_price",
"description": "PATCH /v1/agent/max-price — raise/lower ceiling (30-80). Use when tools return no_eligible_supply with cheapest_posted_cents. Does not auto-apply.",
"inputSchema": {
"type": "object",
"required": [
"max_price_cents_per_dollar"
],
"properties": {
"max_price_cents_per_dollar": {
"type": "integer",
"description": "Buyer ceiling in cents per DIEM dollar, 30-80"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}POST /v1/video/complete — optional cleanup after retrieve.
| Parameter | Type | Description |
|---|---|---|
| queue_id * | string | Queue id from video_queue / generate_video |
{
"name": "video_complete",
"description": "POST /v1/video/complete — optional cleanup after retrieve.",
"inputSchema": {
"type": "object",
"required": [
"queue_id"
],
"properties": {
"queue_id": {
"type": "string",
"description": "Queue id from video_queue / generate_video"
}
},
"additionalProperties": false
}
}POST /v1/video/queue — paid settle+enqueue. Prefer generate_video for agents.
| Parameter | Type | Description |
|---|---|---|
| audio | ["null","boolean"] | |
| model * | string | Live video model id from get_models |
| prompt * | string | |
| duration | ["null","integer"] | |
| resolution | string | |
| aspect_ratio | string |
{
"name": "video_queue",
"description": "POST /v1/video/queue — paid settle+enqueue. Prefer generate_video for agents.",
"inputSchema": {
"type": "object",
"required": [
"model",
"prompt"
],
"properties": {
"audio": {
"type": [
"null",
"boolean"
]
},
"model": {
"type": "string",
"description": "Live video model id from get_models"
},
"prompt": {
"type": "string"
},
"duration": {
"type": [
"null",
"integer"
]
},
"resolution": {
"type": "string"
},
"aspect_ratio": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"idempotentHint": false,
"destructiveHint": true
}
}POST /v1/video/quote — no settle, no job. Check clears_now vs price ceiling vs funding before queue.
| Parameter | Type | Description |
|---|---|---|
| audio | ["null","boolean"] | |
| model * | string | Live video model id from get_models |
| prompt * | string | |
| duration | ["null","integer"] | |
| resolution | string | |
| aspect_ratio | string |
{
"name": "video_quote",
"description": "POST /v1/video/quote — no settle, no job. Check clears_now vs price ceiling vs funding before queue.",
"inputSchema": {
"type": "object",
"required": [
"model",
"prompt"
],
"properties": {
"audio": {
"type": [
"null",
"boolean"
]
},
"model": {
"type": "string",
"description": "Live video model id from get_models"
},
"prompt": {
"type": "string"
},
"duration": {
"type": [
"null",
"integer"
]
},
"resolution": {
"type": "string"
},
"aspect_ratio": {
"type": "string"
}
},
"additionalProperties": false
}
}POST /v1/video/retrieve — power-user status/media poll.
| Parameter | Type | Description |
|---|---|---|
| queue_id * | string | Queue id from video_queue / generate_video |
{
"name": "video_retrieve",
"description": "POST /v1/video/retrieve — power-user status/media poll.",
"inputSchema": {
"type": "object",
"required": [
"queue_id"
],
"properties": {
"queue_id": {
"type": "string",
"description": "Queue id from video_queue / generate_video"
}
},
"additionalProperties": false
}
}Poll video retrieve until delivered or failed. Backs off on 502.
| Parameter | Type | Description |
|---|---|---|
| queue_id * | string | |
| max_polls | ["null","integer"] | Max polls, default 120 |
| interval_ms | ["null","integer"] | Poll interval ms, default 5000 |
{
"name": "wait_for_video",
"description": "Poll video retrieve until delivered or failed. Backs off on 502.",
"inputSchema": {
"type": "object",
"required": [
"queue_id"
],
"properties": {
"queue_id": {
"type": "string"
},
"max_polls": {
"type": [
"null",
"integer"
],
"description": "Max polls, default 120"
},
"interval_ms": {
"type": [
"null",
"integer"
],
"description": "Poll interval ms, default 5000"
}
},
"additionalProperties": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.