MCP Code Mode

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

​

When to use it

• the task chains several calls — list, filter, then read or act on each item;
• you loop over many items (numbers, webhooks, messages, contacts);
• you want a report computed from many reads, returned as one result;
• your agent’s context is tight and the 139 tool definitions cost too much.

​

What it costs in context

​

Connect

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

​

describe

​

execute

• Top-level await works. Call the API with await ps.<tool>(args); the result is the API’s JSON response.
• Print with console.log (also info, warn, error, debug). Objects are printed as JSON.
• A return value is appended to the output as => <value>.
• Types are only stripped, not checked: a type error does not stop the script, a syntax error does.
• There is no network and nothing from the host: no fetch, no import, no require, no process, no setTimeout/setInterval. The only way out of the script is ps.

​

Example: list, then read each

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;

​

Example: handle an API refusal

try {
  await ps.numbers_list();
} catch (e: any) {
  if (e.name === "ApiError") {
    console.log("refused:", e.status, e.code); // e.g. a number-scoped key: refused: 403 NUMBER_SCOPE_NOT_ALLOWED
  } else {
    throw e;
  }
}

​

Example: send safely with 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: `Hi ${o.name}, your order ${o.id} has shipped.`,
    idempotencyKey: `order-shipped-${o.id}-${o.phone}`,
  })) as { id: string; status: string };
  console.log(o.id, sent.id, sent.status);
}

​

Writing scripts that run fast

• Reuse ids it already has. With a workspace-wide credential, pass whatsappNumberId to every number-scoped call, and reuse the id (and any other id) already obtained earlier in the conversation. Call ps.numbers_list({}) only when the id is not known yet.
• Run independent calls together with await Promise.all([...]), never await one by one in a loop — as in the first example.
• Ask only for what it needs: a small pageSize and filters such as status, startDate and search.
• Use a real URL for media: an http(s) URL it was given, never invented base64. For audio and voice this is enforced: a data URI is refused with 400 MCP_AUDIO_URL_REQUIRED and nothing is sent. MCP server

​

Limits per run

• Every call counts, refused ones included. A messages_send with invalid arguments still counts as a send.
• Only messages_send counts as a send. call_initiate and call_permission_request count only in the 50 calls.
• There is no hourly limit on runs: the rate limits of the /v1 API apply to each call, as they do on /mcp.

​

Failure and the report

{
  "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": "…what the script printed…",
  "outputTruncatedBytes": 0
}

​

Refused before running

​

What is recorded

​

Related

• MCP Server
• Idempotency in POST /v1/messages/send
• AI Agents guide