Stexa Voice Mcp
About
# Stexa Voice MCP — Examples & Quickstart [](https://stexa.ru/mcp/v1/health) [](https://spec.modelcontextprotocol.io)…
Explore
- 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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Stexa Voice McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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
---
For production integrations where embedding a static API key is not acceptable:
| Endpoint | URL |
|----------|-----|
| Authorization server metadata | https://stexa.ru/.well-known/oauth-authorization-server |
| Protected resource metadata | https://stexa.ru/.well-known/oauth-protected-resource |
| Dynamic client registration | https://stexa.ru/mcp/v1/oauth/register |
Supported flows:
- Authorization Code + PKCE (RFC 7636) — for user-facing apps
- Dynamic Client Registration (RFC 7591) — for automated agent registration
Register a client:
curl -X POST https://stexa.ru/mcp/v1/oauth/register \
-H "Content-Type: application/json" \
-d '{
"client_name": "My AI Agent",
"redirect_uris": ["https://my-agent.example.com/callback"],
"scope": "call:write call:read transcript:read"
}'
Returns client_id and client_secret for the Authorization Code flow.
---
| Scope | Grants access to |
|-------|-----------------|
| call:write | stexa_call_outbound |
| call:read | stexa_get_call_status, stexa_list_recent_calls |
| transcript:read | stexa_get_transcript |
API keys created in the Cabinet include all three scopes by default.
---
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>"
}
}
}
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")
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
