Getting Started

Connecting takes three steps: create an API key, add the MCP server to your assistant, and start asking.

1. Create a Dialora API key

1. Sign in to your Dialora dashboard.
2. Go to Settings → API Keys.
3. Create a new key and select the scopes you want the assistant to have (for example calls:read and calls:write).
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 Settings → API Keys can only grant calls:read / calls:write; the users, plans, and subscriptions scopes are reserved for agency (tenant) keys. See Authentication & Scopes for the full list.

2. Connect your assistant

All clients point to the same endpoint — https://api.dialora.ai/mcp — with the header Authorization: Bearer dlr_live_…. 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 \
  --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.

3. 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