Modo de código do MCP

https://mcp.pilotstatus.com.br/code

​

Quando usar

• a tarefa encadeia várias chamadas — listar, filtrar e depois ler ou agir em cada item;
• você percorre muitos itens (números, webhooks, mensagens, contatos);
• você quer um relatório calculado a partir de muitas leituras, devolvido como um resultado só;
• o contexto do seu agente é apertado e as definições das 139 ferramentas custam caro demais.

​

Quanto custa em contexto

​

Conectar

{
  "mcpServers": {
    "pilot-status-code": {
      "type": "http",
      "url": "https://mcp.pilotstatus.com.br/code",
      "headers": { "x-api-key": "ps_your_key_here" }
    }
  }
}

​

describe

​

execute

• await funciona no nível de cima. Chame a API com await ps.<ferramenta>(args); o resultado é a resposta JSON da API.
• Imprima com console.log (também info, warn, error, debug). Objetos saem como JSON.
• Um valor de return é acrescentado à saída como => <valor>.
• Os tipos só são removidos, não conferidos: erro de tipo não para o script; erro de sintaxe para.
• Não há rede nem nada do servidor: sem fetch, sem import, sem require, sem process, sem setTimeout/setInterval. A única saída do script é o ps.

​

Exemplo: listar e ler cada um

type Webhook = { id: string; name: string; url: string; active: boolean };
type Delivery = { status: "SUCCESS" | "FAILED"; statusCode: number | null };

const webhooks = (await ps.webhooks_list()) as Webhook[];
const report = await Promise.all(
  webhooks.map(async (w) => {
    const { logs } = (await ps.webhook_events({ id: w.id, limit: 50 })) as { logs: Delivery[] };
    const failed = logs.filter((l) => l.status === "FAILED").length;
    return { name: w.name, active: w.active, failed, of: logs.length };
  }),
);
console.log(report);
return webhooks.length;

​

Exemplo: tratar uma recusa da API

try {
  await ps.numbers_list();
} catch (e: any) {
  if (e.name === "ApiError") {
    console.log("recusado:", e.status, e.code); // ex.: chave com escopo de número: recusado: 403 NUMBER_SCOPE_NOT_ALLOWED
  } else {
    throw e;
  }
}

​

Exemplo: enviar com segurança usando idempotencyKey

const orders = [
  { id: "A-1001", phone: "5511999990001", name: "Ana" },
  { id: "A-1002", phone: "5511999990002", name: "Bruno" },
];

for (const o of orders) {
  const sent = (await ps.messages_send({
    destinationNumber: o.phone,
    text: `Olá, ${o.name}! Seu pedido ${o.id} foi enviado.`,
    idempotencyKey: `pedido-enviado-${o.id}-${o.phone}`,
  })) as { id: string; status: string };
  console.log(o.id, sent.id, sent.status);
}

​

Scripts que rodam rápido

• Reusar os ids que já tem. Com uma credencial do workspace inteiro, passe whatsappNumberId em toda chamada com escopo de número, e reuse o id (e qualquer outro id) já obtido antes na conversa. Chame ps.numbers_list({}) só quando o id ainda não for conhecido.
• Rodar juntas as chamadas independentes com await Promise.all([...]), nunca com await uma a uma num loop — como no primeiro exemplo.
• Pedir só o necessário: um pageSize pequeno e filtros como status, startDate e search.
• Usar uma URL real em media: uma URL http(s) recebida, nunca base64 inventado. Para áudio e voz isso é obrigatório: um data URI é recusado com 400 MCP_AUDIO_URL_REQUIRED e nada é enviado. Servidor MCP

​

Limites por execução

• Toda chamada conta, inclusive as recusadas. Um messages_send com argumentos inválidos conta como envio.
• Só messages_send conta como envio. call_initiate e call_permission_request contam só nas 50 chamadas.
• Não há limite de execuções por hora: os limites de taxa da API /v1 valem para cada chamada, como no /mcp.

​

Falha e relatório

{
  "runId": "cmr_3f9a…",
  "status": "ERROR",
  "error": { "name": "ApiError", "message": "…", "status": 409, "code": "IDEMPOTENCY_KEY_REUSED", "tool": "messages_send" },
  "calls": [
    { "i": 1, "tool": "messages_send", "ok": true, "ms": 312, "ref": "msg_…" },
    { "i": 2, "tool": "messages_send", "ok": false, "ms": 95, "status": 409, "code": "IDEMPOTENCY_KEY_REUSED" }
  ],
  "output": "…o que o script imprimiu…",
  "outputTruncatedBytes": 0
}

​

Recusado antes de rodar

​

O que fica registrado

​

Relacionados

• Servidor MCP
• Idempotência no POST /v1/messages/send
• Guia de Agentes de IA