Quick start
Connect a surface, create a voice agent, and hear it call your own phone — in a few minutes.
Quick start
Goal: a published voice agent that calls your own phone, in a few minutes.
1. Get access
Create an account and an API key with the agents:write scope (see
Authentication). Then pick a surface:
- MCP — add the Agoralia MCP server to your client (Claude Desktop, Claude Code, …) and authenticate. Your agent now sees Agoralia's tools.
- REST — send the key as
Authorization: Bearer <API_KEY>. - CLI —
agoralia auth login(or setAGORALIA_API_KEY).
2. Create an agent
create_agent(
name="Quickstart agent",
system_prompt="You are a friendly Agoralia demo agent. Greet the caller, ask one question, and keep replies short.",
language="en"
)agoralia agents create --name "Quickstart agent" --language en \
--system-prompt "You are a friendly Agoralia demo agent. Greet the caller, ask one question, and keep replies short."You get back an agent_id. See Configure AI agents for every field.
3. Hear it
test_agent(agent_id="<AGENT_ID>", phone_number="<YOUR_PHONE>", phone_number_id="<FROM_NUMBER_ID>")Pick up, talk to it, then refine the system_prompt and publish_agent when you're happy.
Placing live calls is a risk-tiered action. In test mode you dial your own verified number; for real campaigns the gate will require a human "go" and a compliance pass for the target countries.
Next
Introduction
Agoralia is AI voice infrastructure for B2B — MCP, API and CLI-first. Build compliant voice agents that an AI can drive end to end, in 200+ countries.
Configure AI agents
Create, test and publish a voice agent through MCP, the REST API, or the CLI. Agoralia has no config UI — you build agents programmatically, gated by one core.