MCP server
AI tools such as Claude, ChatGPT and Cursor reach the Speakline data the connecting person can see through this server.
Server address
The person connecting signs in with their Speakline account and approves; the tool sees only what that person can see.
- Transport: Streamable HTTP (stateless POST requests).
- Protocol versions: 2026-07-28, 2025-11-25, 2025-06-18 and 2025-03-26.
- Available on plans that include API access.
https://api.speakline.io/mcpAuthentication
On first use a Speakline sign-in opens in the browser (OAuth 2.1, PKCE). The server publishes its protected resource metadata (RFC 9728); clients are recognised through a Client ID Metadata Document (CIMD) or dynamic registration (RFC 7591). Tools without OAuth can send an API key in the header.
Authorization: Bearer sk_live_…Setting up a client
Claude
Paste the server address in Settings › Connectors › Add custom connector, then connect with your Speakline account.
ChatGPT
In Settings › Apps & connectors (developer mode), create a connector with the server address and choose OAuth for authentication.
Cursor and others
Add the server to your configuration file; a Speakline sign-in opens in the browser on first use.
{
"mcpServers": {
"speakline": { "url": "https://api.speakline.io/mcp" }
}
}Tools
The server offers 25 tools: 17 read and 8 take actions. A client sees only the tools allowed by the connecting person's permissions and the granted scopes.
Read
| Tool | What it does |
|---|---|
search_calls | Searches calls with outcome and AI summary |
get_call | One call in full, with its transcript |
search_contacts | Searches contacts |
get_contact | One contact and its history |
list_conversations | Lists inbox conversations |
get_conversation | A conversation's messages |
list_channels | Connected messaging channels |
list_voicemails | Lists voicemails |
get_voicemail | One voicemail and its transcript |
get_call_center_live | Live state of queues and operators |
get_queue_report | Queue report |
get_operator_report | Operator report |
list_campaigns | Lists campaigns |
get_campaign_stats | Campaign statistics |
list_appointments | Lists appointments |
list_assistants | Lists voice agents |
list_phone_numbers | Lists phone numbers |
Actions
| Tool | What it does |
|---|---|
create_contact | Creates a contact |
update_contact | Updates a contact |
send_message | Sends a message |
add_internal_note | Adds an internal note to a conversation |
set_conversation_status | Changes a conversation's status |
book_appointment | Books an appointment |
start_ai_call | Has a voice agent place a call |
call_from_my_phone | Starts a call from the connected person's phone |
Permissions and limits
-
Action tools are off by default in every workspace; a member who manages integrations turns them on in the dashboard.
-
Clients that ask for no scopes get the read scopes only.
-
Results are capped at 50 rows and 30,000 characters.
-
Customer text such as transcripts and messages reaches the tool marked as untrusted data.
-
The tool that has a voice agent place a call follows the calling-hour and do-not-call rules.