Answers and exit codes
The Buzzmark CLI answers JSON on stdout. An error is JSON on stderr with a code and a message, and the exit code says what kind, so a script or an agent can branch on it.
Calls from the CLI count toward the same limits as your AI apps, and writing and pictures use your plan's monthly amounts.
Read the answer
A command that worked prints the tool's answer as JSON on stdout, the same answer an AI app gets. An error prints {"error": {"code": …, "message": …}} on stderr. The message gives the reason and what to do, such as a platform's limit or a quota that ran out.
Help is the one thing printed as plain text: buzzmark --help and buzzmark help <tool>.
Exit codes
| Exit code | What happened |
|---|---|
| 0 | Done. |
| 1 | The tool said no, with the reason: a platform would refuse the post, or a monthly amount ran out. |
| 2 | The command was wrong: an unknown tool, a bad flag or a missing input. |
| 3 | No key, or a key Buzzmark didn't accept. Make a new one in Settings, under Developers. |
| 4 | Too many calls for now. Wait, then try again. |
| 5 | Buzzmark couldn't be reached, or answered something unexpected. |
Retry on 4 after a wait, and on 5 once Buzzmark can be reached. On 1, read the message: the same command won't work until something changes.
Limits
Calls from the CLI count toward the same limits as your AI apps, across every app and key, and writing, pictures, Hive checks and Scout runs use your plan's monthly amounts, as in the app. Sign-in, keys and limits has the numbers.
BUZZMARK_MCP_URL points the CLI at another Buzzmark address, which you only need when we ask you to.
Where to next
- Commands and flags
Each Buzzmark tool is a command: `buzzmark schedule-post` runs the schedule_post tool, and `buzzmark tools` lists them all.
- Sign-in, keys and limits
An AI app signs in on a Buzzmark page in your browser, where you press Allow, and works as you until you disconnect it.
- Troubleshooting
When an AI app can't do something, Buzzmark tells it what happened and what to do next, and the app passes that on.
- Errors and limits
A Buzzmark API refusal is JSON with a code, a message, whether a retry may work, and a request id, and its HTTP status matches the code.