PZERO

Protocolo de Contexto de Modelo hospedado em https://mcp.pzero.studio/mcp. Aponte Cursor, Claude, Claude Code ou qualquer cliente MCP remoto para essa URL depois de adicionar créditos.

initialize, notifications/initialized, ping, tools/list, resources/list, resources/templates/list e prompts/list não exigem chave, para que diretórios possam catalogar o conector. tools/call e outros métodos de gasto ou conta ainda precisam de Authorization: Bearer pzero_….

O MCP gasta saldo USDC pré-pago. Ele não executa x402 por conta própria. Escolha como financiar:

• Recarregar com x402 (cadastro / recarga HTTP para agentes)
• Criar uma chave de API no Studio

Uma cópia deste guia voltada para agentes também está no host da API: MCP.md.

Adicione ao seu cliente

Escolha seu cliente, cole ou siga os passos, recarregue o MCP e peça ao agente para chamar agent_me.

Cole nas configurações de MCP do Cursor, recarregue o MCP e peça ao seu agente para chamar agent_me.

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

Imagem e vídeo usam a mesma chave e o mesmo saldo pré-pago.

Chamar ferramentas

Chame agent_me primeiro após conectar; as ferramentas PZERO gastam USDC pré-pago.

Acesso

Ferramenta	O que faz
agent_me	Retorna saldos, prefixo da chave e preço máximo; USDC pendente não é gastável até ser confirmado.
list_keys	Lista metadados de chaves de API ativas, nunca texto simples.
create_key	Cria outra chave; não adiciona USDC; texto simples é mostrado uma vez.
revoke_key	Revoga irreversivelmente uma chave pelo UUID da chave.
set_max_price	Aumenta ou diminui o teto do comprador, de 30 a 80 centavos por dólar DIEM.
get_request	Recupera custo e rastreio de uma solicitação anterior pelo UUID de support_reference.

Financiamento

Ferramenta	O que faz
funding_instructions	Explica como financiar e autenticar; o MCP nunca aceita pagamento ou chaves de carteira.

Inferência

Ferramenta	O que faz
chat_completions	Executa conclusões de chat em buffer; passe um ID de modelo ativo de get_models.
generate_image	Gera imagens; retorna imagens mais rastreio de custo.
generate_video	Liquida e depois enfileira vídeo; retorna queue_id mais custo; confirme antes de gastar.
video_quote	Retorna apenas uma cotação; sem liquidação, sem job.
video_queue	Executa liquidação e enfileiramento pagos; prefira generate_video para agentes.
get_generation_status / video_retrieve	Consulta status ou busca o MP4 entregue uma vez.
wait_for_video	Consulta até entregue ou falho.
video_complete	Limpeza opcional após recuperar.

Catálogo

Ferramenta	O que faz
get_models	Resolve um ID de modelo ativo antes da inferência.
get_capacity	Mostra DIEM roteável e faixas de preço antes de financiar ou gastar.

FAQ

Preciso de uma chave de API?

Sim, para gastar. Coloque Authorization: Bearer pzero_… na conexão antes de agent_me, inferência ou ferramentas de chave. Scanners de diretório podem initialize, notifications/initialized, ping, tools/list, resources/list, resources/templates/list e prompts/list sem chave; esses métodos não leem uma carteira.

Como instalo o plugin do Claude Code?

Claude Code 2.1.224 ou posterior pode adicionar o marketplace hospedado e depois instalar pzero@pzero. Defina PZERO_API_KEY antes de habilitar:

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

O comando claude mcp add no cartão do cliente ainda funciona em versões mais antigas do Claude Code.

LibreChat ou Open WebUI?

Passos prontos para colar de librechat.yaml e passos de administrador do Open WebUI estão em MCP.md.

Quanto tempo os vídeos levam?

Assíncrono: generate_video / video_queue retorna um queue_id; consulte com get_generation_status ou wait_for_video.

Onde está o contrato HTTP?

Visão geral de agentes e SKILL.md ao vivo.