Tools Reference
The Dialora MCP server exposes the following tools. Inputs mirror the Public API request bodies exactly.
You only see the tools your key is allowed to use. The server registers a tool only when your API key has the required scope (and, for agency tools, is a tenant-level key). So a normal account key with just calls:read / calls:write sees only the three Calls tools — the users, plans, and subscriptions tools won’t appear in the tool list at all. Use an agency (tenant) key with the matching scopes to unlock them.
Tools marked side effect place real phone calls. Most MCP clients will ask you to confirm before running them.
Every tool below is throttled to one call per 15 seconds per API key — see Rate Limits.
Calls
create_call · scope calls:write · side effect
Place an outbound call with an agent.
| Field | Required | Description |
|---|---|---|
agent_id | yes | Agent that will handle the call. |
from_number | yes | Your provisioned Dialora number, E.164 (e.g. +15551230001). |
to_number | yes | Destination number, E.164, optional extension. |
variables | no | Dynamic values injected into the agent for this call. |
metadata | no | Opaque key/value pairs (≤50 keys), echoed back on the call and webhooks. |
webhook_url | no | HTTPS URL to receive signed call lifecycle events. |
idempotency_key | no | Client-supplied key that makes retries safe — see Idempotency. |
Returns the created call and, when webhook_url is set, a one-time webhook_secret.
list_calls · scope calls:read
List calls in the tenant/account. Supports pagination (page, limit) and filtering by agent_id.
get_call · scope calls:read
Fetch a single call by id, including transcript and metadata.
Users
list_users · scope users:read
List end-user profiles. Supports pagination, status filter, and sorting.
create_user · scope users:write
Create an end-user profile.
delete_user · scope users:write
Delete an end-user profile by id.
Plans
list_plans · scope plans:read
List available payment plans.
get_plan · scope plans:read
Fetch a single plan by id.
Subscriptions
list_subscriptions · scope subscriptions:read
List subscriptions in the tenant.
get_subscription · scope subscriptions:read
Fetch a single subscription by id.
create_subscription · scope subscriptions:write
Create a subscription for an end user on a plan.
update_subscription_plan · scope subscriptions:write
Upgrade or downgrade a subscription. Inputs: id (subscription) and plan_id.
Idempotency
create_call, create_user, create_subscription, and update_subscription_plan accept an optional idempotency_key input. When the assistant supplies one, a replay with the same key and the same request body returns the original result instead of creating a second record; reusing a key with a different body is rejected. Without a key the call is executed normally, so a retry can create a duplicate.
Resources
The server also exposes a read-only resource, dialora://scopes, listing the scope catalog and what each scope grants — useful for an assistant to check permissions before acting.