PZERO

Protocolo de Contexto de Modelo alojado en https://mcp.pzero.studio/mcp. Apunta Cursor, Claude, Claude Code o cualquier cliente MCP remoto a esa URL después de haber recargado saldo.

initialize, notifications/initialized, ping, tools/list, resources/list, resources/templates/list y prompts/list no requieren una clave, por lo que los directorios pueden catalogar el conector. tools/call y otros métodos de gasto o cuenta aún necesitan Authorization: Bearer pzero_….

MCP gasta el saldo prepagado de USDC. No ejecuta x402 por sí mismo. Elige cómo financiarlo:

• Recargar con x402 (registro / recarga HTTP para agentes)
• Crear una clave API en Studio

La copia de esta guía orientada a agentes también está en el host de la API: MCP.md.

Añádelo a tu cliente

Elige tu cliente, pega o sigue los pasos, recarga MCP y luego pide al agente que llame a agent_me.

Pégalo en la configuración de MCP de Cursor, recarga MCP y luego pide a tu agente que llame a agent_me.

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

Las imágenes y los videos usan la misma clave y el mismo saldo prepagado.

Llamar a las herramientas

Llama a agent_me primero después de conectar; las herramientas de PZERO gastan USDC prepagado.

Acceso

Herramienta	Qué hace
agent_me	Devuelve saldos, prefijo de clave y precio máximo; el USDC pendiente no se puede gastar hasta que se confirme.
list_keys	Lista los metadatos de las claves API activas, nunca en texto plano.
create_key	Crea otra clave; no añade USDC; el texto plano se muestra una sola vez.
revoke_key	Revoca irreversiblemente una clave por UUID de clave.
set_max_price	Sube o baja el límite del comprador, de 30 a 80 centavos por dólar DIEM.
get_request	Recupera el costo y el rastreo de una solicitud anterior por UUID de support_reference.

Financiación

Herramienta	Qué hace
funding_instructions	Explica cómo financiar y autenticar; MCP nunca acepta pagos ni claves de billetera.

Inferencia

Herramienta	Qué hace
chat_completions	Ejecuta completaciones de chat en búfer; pasa un ID de modelo en vivo desde get_models.
generate_image	Genera imágenes; devuelve imágenes más el rastreo de costo.
generate_video	Liquida y luego pone en cola el video; devuelve queue_id más el costo; confirma antes de gastar.
video_quote	Devuelve solo una cotización; sin liquidación, sin trabajo.
video_queue	Ejecuta liquidación y puesta en cola pagadas; prefiere generate_video para agentes.
get_generation_status / video_retrieve	Consulta el estado o recupera el MP4 entregado una vez.
wait_for_video	Consulta hasta que se entregue o falle.
video_complete	Limpieza opcional después de recuperar.

Catálogo

Herramienta	Qué hace
get_models	Resuelve un ID de modelo en vivo antes de la inferencia.
get_capacity	Muestra DIEM enrutable y bandas de precios antes de financiar o gastar.

Preguntas frecuentes

¿Necesito una clave API?

Sí para gastar. Pon Authorization: Bearer pzero_… en la conexión antes de agent_me, inferencia o herramientas de claves. Los escáneres de directorios pueden initialize, notifications/initialized, ping, tools/list, resources/list, resources/templates/list y prompts/list sin clave; esos métodos no leen una billetera.

¿Cómo instalo el plugin de Claude Code?

Claude Code 2.1.224 o posterior puede añadir el marketplace alojado y luego instalar pzero@pzero. Establece PZERO_API_KEY antes de habilitar:

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

El comando claude mcp add en la tarjeta del cliente aún funciona en Claude Code más antiguo.

¿LibreChat u Open WebUI?

Los pasos listos para pegar de librechat.yaml y los pasos de administración de Open WebUI están en MCP.md.

¿Cuánto tardan los videos?

Asíncrono: generate_video / video_queue devuelve un queue_id; consulta con get_generation_status o wait_for_video.

¿Dónde está el contrato HTTP?

Descripción general de agentes y SKILL.md en vivo.