Stexa Voice Mcp

by stexaai

306 downloads
Not rated
GitHub

About

# Stexa Voice MCP — Examples & Quickstart [![Status](https://img.shields.io/badge/Status-Stable-green)](https://stexa.ru/mcp/v1/health) [![Protocol](https://img.shields.io/badge/MCP-2024--11--05-blue)](https://spec.modelcontextprotocol.io)…

Details

Author
stexaai
Downloads
306
Categories
Other

- Make outbound voice calls with the AI bot Alina (stexa_call_outbound)
- Check call status and get live updates (stexa_get_call_status)
- Retrieve full or partial transcripts (stexa_get_transcript)
- List recent calls with filters (stexa_list_recent_calls)
- OAuth 2.1 (Authorization Code + PKCE) support
- HTTP JSON-RPC 2.0 transport with rate limits

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Stexa Voice Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Register at stexa.ru, create an API key (format stx_live_…) in the Cabinet’s MCP Server section, then configure your MCP client (Claude Desktop, Cursor, Python, n8n) with the endpoint https://stexa.ru/mcp/v1/jsonrpc and a Bearer token in the Authorization header. OAuth 2.1 is recommended for production – set "auth": "oauth2" in the client configuration.

stexa_call_outbound

Сделать исходящий голосовой звонок клиенту. AI-бот Алина дозванивается по указанному номеру и ведёт диалог. Возвращает call_id для последующего получения статуса и transcript через get_call_status / get_transcript.

stexa_get_call_status

Получить текущий статус MCP-инициированного звонка. Используется для polling после stexa_call_outbound: status переходит queued → ringing → talking → completed/failed. Возвращает duration_s и ended_reason для финальных статусов.

stexa_get_transcript

Получить transcript MCP-инициированного звонка. Если звонок завершён — полный transcript + summary. Если ещё идёт — partial_transcript + status='in_progress' (агент может попробовать ещё раз через несколько секунд или дождаться completed через get_call_status).

stexa_list_recent_calls

Список последних звонков тенанта с фильтрами по phone/origin/since. Используется агентом для контекста перед новым звонком ('что было с этим клиентом') или аналитики. Phone маскируется в response.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "stexa voice mcp": {
            "stexa-voice-mcp": {
                "url": "https://stexa.ru/mcp/v1/jsonrpc",
                "headers": {
                    "Authorization": "Bearer <YOUR_API_KEY>"
                }
            }
        }
    }
}

McpServers

{
    "stexa-voice-mcp": {
        "url": "https://stexa.ru/mcp/v1/jsonrpc",
        "headers": {
            "Authorization": "Bearer <YOUR_API_KEY>"
        }
    }
}

Stexa Voice MCP — Examples & Quickstart

Status
Protocol
Auth

Voice telephony as an MCP tool. Give your AI agent the ability to make real outbound phone calls, get transcripts, and check call status — all via the Model Context Protocol.

stexa_call_outbound("+79991234567")  →  AI bot dials, speaks, records
stexa_get_transcript("oc:42")        →  [{"role": "bot", "text": "..."}, ...]

EN Docs · Get API Key · Live demo

---

What's in this repo

| Path | Description |
|------|-------------|
| examples/claude-desktop/ | Config snippet for Claude Desktop |
| examples/cursor/ | Cursor .cursor/mcp.json settings |
| examples/python/ | Direct HTTP calls via Python + httpx |
| examples/n8n/ | Ready-to-import n8n workflow |

---

Quick start (5 minutes)

Step 1 — Get an API key

1. Register at stexa.ru
2. Open Cabinet → MCP Server → + Create key
3. Copy the key (format: stx_live_...)

> OAuth 2.1 is also supported and recommended for production. See OAuth setup below.

---

Step 2 — Connect your MCP client

Claude Desktop

Add to your config file:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "stexa-voice": {
      "url": "https://stexa.ru/mcp/v1/jsonrpc",
      "headers": {
        "Authorization": "Bearer stx_live_YOUR_KEY"
      }
    }
  }
}

Restart Claude Desktop — Stexa tools appear in the tool picker automatically.

For OAuth (no static key needed):

{
"mcpServers": {
"stexa-voice": {
"url": "https://stexa.ru/mcp/v1/jsonrpc",
"auth": "oauth2"
}
}
}

Claude Desktop opens a browser window for the OAuth consent flow on first use.

---

Cursor

Create or edit .cursor/mcp.json in your project root (or ~/.cursor/mcp.json globally):

{
  "mcpServers": {
    "stexa-voice": {
      "url": "https://stexa.ru/mcp/v1/jsonrpc",
      "headers": {
        "Authorization": "Bearer stx_live_YOUR_KEY"
      }
    }
  }
}

---

Python

pip install httpx

```python
from examples.python.connect_and_call import StexaMCPClient

client = StexaMCPClient(api_key="stx_live_YOUR_KEY")

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.