vobiz-reports
Vobiz reports skill
Use this for any question that is answered by counting, rating or costing what happened on a Vobiz account: calls for a day, answer rate, which caller ID connects best, why calls fail, what was spent, how a campaign went, whether a number is flagged as spam. The skill turns the question into a defined report, pulls the data through whichever Vobiz route is available, computes the numbers the same way every time, and saves the result as a dated Markdown file so the next question, or the vobiz-campaign-planner skill, can build on it.
Base URL: https://api.vobiz.ai. Auth headers on every request: X-Auth-ID and X-Auth-Token. Every report in this skill is read-only; nothing here spends money or places a call.
Pick the data route
Use the first route that is available, in this order. They return the same fields.
| Route | How to tell it is available | Best for |
|---|---|---|
| Vobiz MCP Server | tools such as list_call_records, get_number_health, list_transactions, get_account_balance are present |
Headline numbers and reports up to a few thousand rows, inside Claude, ChatGPT, Cursor and other MCP clients |
vobiz CLI |
vobiz --version works and vobiz account show returns the account |
Bulk pulls: vobiz cdr export --all, vobiz account transactions list --all, CSV on disk |
| REST API with curl | $AUTH_ID and $AUTH_TOKEN are set |
Everything else, and the only route for the Campaign Manager and partner endpoints |
Credentials come from the MCP connection, the CLI profile, or environment variables. Never print, persist or commit a token, and never write one into a report file. The account ID (MA_XXXXXXXX or SA_XXXXXX) may appear in reports; the token may not.