Skip to main content
These are the instructions GreenTick sends with the MCP server. An assistant that ignores them will create drafts, send messages, or report a failure as a success.

​
Ask before a live action

The assistant does not send, publish, schedule, enroll, or enable anything until you ask for that action in the conversation. Reading tools (get_limits, list_contacts, get_template, and the other GET tools) do not need a separate yes.

​
Read limits before writing text

The assistant calls get_limits before it writes template, workflow, Flow, bot, catalog, or message text. It does not cut a field down to slip under a limit. If a field is too long, it tells you the limit and the field name. It calls validate_template, validate_workflow, or validate_flow before the matching create tool. Validation does not call Meta and does not save a draft.

​
Stop on an error

The assistant stops when a tool result is an error, or when blockedTools is not empty. It shows you the message, changes the field named in the result, and calls the same tool again. It does not switch to a later tool that the error blocked. A rejected upload stays blocked until a complete file is uploaded. A cut-off file is not a media id.

​
Idempotency

Write tools take idempotencyKey. GreenTick stores the response for that key, that API key, and that route.
  • After an error, the next attempt uses a new key. The same key returns the saved error.
  • A successful retry also uses a new key. Reusing the key does not run the action again.
  • GET tools do not use an idempotency key.

​
Rate limit

Each API key can make 60 write calls a minute. GET tools are not counted. Over the limit, the tool returns 429 with code RATE_LIMITED and a Retry-After header. The assistant waits that many seconds and calls the same tool again. It does not fan the work out across other write tools.

​
Auth and plan errors

The assistant does not retry PLAN_EXPIRED until you renew on Manage Plan.

​
Phone numbers and templates

list_phone_numbers returns the sending lines on the account. Message, conversation, broadcast, and Flow send tools take phoneNumberRef when the account has more than one number. If the account has a single number, the assistant can omit it. A template belongs to the WhatsApp Business account. The assistant does not say a template sends from one phone number.