---
title: "Read the WhatsApp state of the connected account: whether the owner's phone is verified, which platform numbers they ..."
method: POST
path: "/api/mcp/tools/get_agent_whatsapp"
tags: ["tools"]
---

# Read the WhatsApp state of the connected account: whether the owner's phone is verified, which platform numbers they ...

`POST /api/mcp/tools/get_agent_whatsapp`

## Request

- Base URL: `https://finestructure.ai`
- URL: `https://finestructure.ai/api/mcp/tools/get_agent_whatsapp`
- Auth: HTTP bearer

Read the WhatsApp state of the connected account: whether the owner's phone is verified, which platform numbers they can connect, and which conversations already route to which agent. Call this first whenever the user asks to talk to an agent on WhatsApp, and repeat its next_step to them.

## Request body

- object
  - `agent_id` string: Optional: report only this agent's WhatsApp state.

## Response `200`

Tool executed successfully

- ToolResult
  - `ok` boolean, required
  - `tool` string, required
  - `result` object, required

## Other responses

- `400`: Invalid arguments for this tool
- `401`: Missing or invalid bearer token
- `402`: Not enough credits on the account
- `403`: Token scope does not permit this tool
- `404`: Unknown tool name
- `429`: Rate limit exceeded, retry after the indicated delay
- `500`: Internal error while executing the tool

---

[API](https://skmtc.dev/finestructure/apis/fine-structure-api.md) · [All operations](https://skmtc.dev/finestructure/apis/fine-structure-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finestructure/apis/fine-structure-api/revisions/02c50ed5fd70?raw)