MCP Server

The Sarj.ai MCP server lets AI agents (Claude Code, Cursor, any MCP-compatible client) call the API as native tools. Server URL: https://platform-api.sarj.ai/api/v1/mcp Use the server that matches the task:

Server	Purpose	Authentication
`https://platform-docs.sarj.ai/mcp`	Search and read documentation	Public, read-only
`https://platform-api.sarj.ai/api/v1/mcp`	Create, inspect, cancel, and reschedule calls	Your Sarj account

The documentation server cannot place calls. The published agent skill explains identifiers, result readiness, and retry constraints.

Authentication: On first connect, your browser opens a Sarj.ai sign-in page; the API key is created and cached automatically.

Prerequisites

A Sarj.ai account — sign in at platform.sarj.ai
An MCP-compatible client (Claude Code, Cursor, or any MCP SDK)

Connect your MCP client

Add the Sarj.ai MCP server to your client.

# Add the server (run once)
claude mcp add sarj-voice \
  --transport http \
  https://platform-api.sarj.ai/api/v1/mcp

# Verify it was added
claude mcp list

{
  "mcpServers": {
    "sarj-voice": {
      "type": "http",
      "url": "https://platform-api.sarj.ai/api/v1/mcp"
    }
  }
}

{
  "mcpServers": {
    "sarj-voice": {
      "type": "http",
      "url": "https://platform-api.sarj.ai/api/v1/mcp"
    }
  }
}

Authenticate

No manual API key needed — the MCP server issues one for you. When your client first connects, it will:

Open your browser to the Sarj.ai sign-in page
Sign in with your Sarj.ai account (skipped if already signed in)
An API key is created server-side and returned to your client

The API key is scoped to your account and organization, and cached locally by your MCP client for future sessions. If you also need direct API or SDK access, generate a separate key from the dashboard.

Prompt your agent

Example prompts:

Call +966512345678 using scenario 550e8400-e29b-41d4-a716-446655440000
with language set to Arabic.

Check the status of 8f9b2c1e-4a5d-4f6e-8b1a-2c3d4e5f6a7b.
Tell me if it completed and how long it lasted.

Trigger calls to all numbers in this list using scenario 550e8400-e29b-41d4-a716-446655440000:
+966512345678, +966598765432, +966501234567

Check each call for up to five minutes, then report its status and any available results.

Replace the illustrative UUID with an active scenario ID copied from your dashboard. Confirm the recipient numbers before asking the agent to place real calls.

Available tools

Tool	Description
`createCall`	Place an outbound voice call (see POST /calls)
`getCall`	Fetch call details by `call_id` (see GET /calls/)
`cancelScheduledCall`	Cancel a pending scheduled call or retry attempt
`rescheduleScheduledCall`	Move a pending scheduled call to another time

Schedule-config creation is currently a REST/SDK operation, not an action MCP tool. Reports are asynchronous and can remain null; do not poll indefinitely or infer webhook outcome types from call-status names.

Overview

Build

Operate

Prerequisites

Available tools

​Prerequisites

​Available tools

Prerequisites

Available tools