Getting Started

There are two ways to connect, and most people should use the first.

Option A: Sign in (recommended)

Add https://api.dialora.ai/mcp as a remote MCP server in your assistant. The first time it connects, your browser opens a Dialora sign-in page, then a consent screen.

On the consent screen you:

1. See which app is asking (its name and the host it will return you to)
2. Pick which account it may act on, if you have more than one
3. Choose the permissions to grant, grouped by resource — Calls, Users, Plans, Subscriptions — each with a read level and a write level

Read permissions are ticked by default; write permissions are not. There are Read and Write shortcuts if you’d rather grant a whole tier at once.

Approve, and the assistant is connected. You never copy a secret, and you can deny at any point to cancel.

Option B: Use an API key

Use this for clients that don’t support OAuth, or for headless setups.

1. Sign in to your Dialora dashboard.
2. Open the profile avatar in the top right → API Keys.
3. Create a new key and select the scopes you want the assistant to have.
4. Copy the key — it looks like dlr_live_xxxxxxxxxxxxxxxx. You will only see it once.

Which scopes do I need?

A scope decides what a tool can do, and your key only exposes the tools its scopes allow. Grant the minimum the assistant needs:

Regular keys created from the profile avatar → API Keys can only grant calls:read and calls:write; the users, plans, and subscriptions scopes are reserved for agency (tenant) keys. See Authentication & Scopes for the full list.

Connect your assistant

All clients point to the same endpoint — https://api.dialora.ai/mcp. With an API key, add the header Authorization: Bearer dlr_live_…; with sign-in, your client handles the token for you. Pick your client below:

{
  "mcpServers": {
    "dialora": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.dialora.ai/mcp",
        "--transport", "http-only",
        "--header", "Authorization:${DIALORA_AUTH}"
      ],
      "env": {
        "DIALORA_AUTH": "Bearer dlr_live_xxxxxxxxxxxxxxxx",
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

{
  "mcpServers": {
    "dialora": {
      "command": "cmd",
      "args": [
        "/c", "npx",
        "-y",
        "mcp-remote",
        "https://api.dialora.ai/mcp",
        "--transport", "http-only",
        "--header", "Authorization:${DIALORA_AUTH}"
      ],
      "env": {
        "DIALORA_AUTH": "Bearer dlr_live_xxxxxxxxxxxxxxxx",
        "APPDATA": "C:\\Users\\<you>\\AppData\\Roaming"
      }
    }
  }
}

{
  "mcpServers": {
    "dialora": {
      "command": "/usr/bin/npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.dialora.ai/mcp",
        "--transport", "http-only",
        "--header", "Authorization:${DIALORA_AUTH}"
      ],
      "env": {
        "DIALORA_AUTH": "Bearer dlr_live_xxxxxxxxxxxxxxxx",
        "PATH": "/usr/local/bin:/usr/bin:/bin",
        "HOME": "/home/<you>"
      }
    }
  }
}

claude mcp add --transport http dialora https://api.dialora.ai/mcp

claude mcp add --transport http dialora https://api.dialora.ai/mcp \
  --header "Authorization: Bearer dlr_live_xxxxxxxxxxxxxxxx"

{
  "mcpServers": {
    "dialora": {
      "url": "https://api.dialora.ai/mcp",
      "headers": {
        "Authorization": "Bearer dlr_live_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

For step-by-step details per client, see Connect Claude, Connect ChatGPT, or Connect Cursor. Using VS Code, Windsurf, Cline, Zed, LM Studio or anything else? See Connect Other Clients.

Try it

Ask your assistant something like:

“List my last 10 Dialora calls.”

or

“Place a call from +15551230001 to +15559876543 using agent agent_ck9z3.”

The assistant will call the matching Dialora tool and return the result. Actions that place real phone calls (create_call) are marked as side-effecting, so most clients will ask you to confirm first.

Endpoint summary