Tools
get_account_overview
Start here. One call returns the workspace (name, currency, available credits), every phone number with a usable_for_live_calls flag, the first 25 assistants, last-30-day metrics, a ready_to_call verdict and concrete suggestions. Read-only.
place_call
Dials a real number with an assistant. Flagged destructive: clients should confirm with you first.
Returns the
call_id immediately. If the caller ID is missing or is a Ringg test number, the error lists usable numbers to choose from.
get_call
Status of a call and, once it has ended, the transcript, recording link, summary and post-call analysis.
Final statuses:
completed, failed, error, cancelled, forwarded. retry means Ringg will redial per the assistant’s retry policy.
list_calls
Call history, newest first, with filters: status (one or more), agent_id, to_number, call_type (inbound, outbound, webcall, callback, voicemail), start_date, end_date, limit (≤ 100), offset. Returns compact rows without transcripts; use get_call for detail.
get_call_analytics
Aggregate metrics for a window (default: last 30 days), optionally for one assistant: calls attempted, completed, connection rate, average duration, minutes connected, unique callees.
list_agents · get_agent
list_agents returns id, name, type and published version (optional search). get_agent returns the full configuration: language, voice, custom variables the prompt expects, default caller IDs, intro line, prompt sections, tools per phase.
create_agent
Creates a ready-to-call assistant from a plain-language brief.
update_agent
Changes name, prompt, additional info, language, voice, intro line or variables of an existing assistant. Only the fields passed change; the response is the refreshed configuration.
list_voices
Voices with gender, supported languages and preview URLs; filter by language and gender.
Resources
Resources are read-only documents a client can attach as context without a tool call.Prompts
Prompts are playbooks the client can offer in its UI.Annotations
Each tool carries MCP annotations so clients can behave appropriately: read-only tools (get_*, list_*) are safe to auto-approve; create_agent is non-idempotent; update_agent is idempotent; place_call is destructive and should always be confirmed.