Skip to main content
The DialNexa MCP server lets an MCP-compatible AI client inspect and manage DialNexa resources through named tools. Connect to https://api.dialnexa.com/v1/mcp with OAuth 2.1 or a DialNexa API key, then let the client discover the available tools through the Model Context Protocol.

​
Who should use the DialNexa MCP server

Use the MCP server when an AI client should choose and call DialNexa operations during a conversation. Use the REST API when your application code needs deterministic request and response handling without an AI client deciding which operation to run. Both interfaces use many of the same resource IDs. MCP clients can use an interactive DialNexa sign-in or a workspace API key, while REST API integrations use API keys.

​
DialNexa MCP Server Endpoint And Authentication

The server implements MCP Streamable HTTP at:
OAuth 2.1 is the recommended connection method for interactive MCP clients. It uses authorization-code flow with PKCE and lets the user choose the workspace during consent. API key authentication remains available for clients that support custom request headers.

​
OAuth 2.1 Sign-In

Add the remote MCP URL without an Authorization header when your client supports MCP OAuth discovery. The connection follows this sequence:
  1. The client contacts the MCP endpoint and receives the protected-resource metadata location in the WWW-Authenticate header.
  2. The client discovers the DialNexa authorization server and opens a browser.
  3. Sign in to DialNexa if needed.
  4. Review the requested permissions. If your account has multiple workspaces, select the workspace this client should use.
  5. Click Allow to finish, or Deny to reject the connection.
The consent screen can request these scopes: DialNexa MCP OAuth consent screen showing Claude, read and write permissions, offline access, and Deny and Allow buttons. OAuth access is tied to the user who approved it and the workspace selected on the consent screen. Tool arguments cannot switch to another workspace.

​
API Key Authentication

Send a workspace API key as a Bearer token on every request:
The server resolves the workspace from the API key. Tool arguments cannot select a different workspace. A missing, revoked, or malformed key returns 401 Unauthorized before a tool runs. See API key authentication for key creation and storage guidance.

​
DialNexa MCP tool reference

Each tool has its own reference page with the exact server description, input schema, safety level, JSON-RPC request shape, retry guidance, and related tools.

Agents

Create, inspect, configure, and remove voice agents.

Calls

Find call records and place confirmed outbound calls.

Batch Calls

Inspect campaigns, review leads, and control batch calls.

Workflows

Build workflow graphs and manage workflow execution.

Knowledge Base

Inspect and manage knowledge base containers.

Phone Numbers

Search, purchase, inspect, and configure phone numbers.

Reference Data

Resolve language, voice, model, and transcriber IDs.

Templates

Find reusable agent templates and inspect their configuration.

Billing

Inspect billing plans, phone-number pricing, and SIP rates.

Webhooks

Inspect workspace webhook configuration without exposing secrets.

Organization

Inspect the current workspace and its agent folders.

Dashboard

Read call, agent, onboarding, and weekly dashboard metrics.

Integrations

Inspect, connect, validate, and disconnect integrations.

Prompt Suggestions

Read AI-generated prompt improvements for an agent.

​
Protocol behavior

  • Transport: The server uses stateless MCP Streamable HTTP. Each request is authenticated independently with OAuth or an API key.
  • Discovery: Use the standard MCP tools/list method after client initialization.
  • Invocation: Use tools/call with the exact snake_case tool name and an arguments object.
  • Results: A successful tool returns one text content block. The text contains the JSON-encoded result.
  • Tool failures: A tool-level failure sets isError: true and returns a readable explanation in the text block.
  • IDs: Pass prefixed IDs exactly as returned, such as agent_..., call_..., batch_..., and workflow_....

​
Safety and confirmation

Reference pages classify every tool as read only, state changing, destructive, or billable. Tools that place calls, spend money, or permanently delete selected resources require explicit user approval as described by that tool. Never add confirm: true before the user approves the exact action. After an uncertain timeout on a state-changing tool, read the affected resource before retrying. This prevents duplicate calls, purchases, or resources.

​
Next steps