Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.withallo.com/llms.txt

Use this file to discover all available pages before exploring further.

Connect Allo to any AI assistant that supports the Model Context Protocol (MCP). Search calls, read transcripts, send SMS, manage tags, and analyze team performance — directly from your AI tool.

​
Prerequisites

1

Get an API key

Go to Settings > API and click Create API Key.Select the scopes your workflow needs. For full MCP access, enable all scopes. For read-only access, select only the READ scopes.Copy the key — it won’t be shown again.
2

Choose your AI client

Follow the setup instructions for your client below.
Only admins and owners can create API keys. Team members cannot generate keys.

​
Connect your AI client

​
Claude Code

Run this command in your terminal: 
claude mcp add Allo --transport http https://mcp.withallo.com/mcp \
  --header "Authorization: YOUR_API_KEY"
Replace YOUR_API_KEY with your Allo API key.

​
Claude Desktop

Open Settings > MCP in Claude Desktop and add a new server with this configuration: 
{
  "mcpServers": {
    "Allo": {
      "url": "https://mcp.withallo.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

​
Cursor

Open Settings > MCP in Cursor, click Add new MCP server, and select Type: HTTP. Alternatively, add this to your ~/.cursor/mcp.json: 
{
  "mcpServers": {
    "Allo": {
      "url": "https://mcp.withallo.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

​
VS Code

Add this to your .vscode/mcp.json file (create it if it doesn’t exist): 
{
  "servers": {
    "Allo": {
      "type": "http",
      "url": "https://mcp.withallo.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

​
Windsurf

Open Settings > MCP in Windsurf and add: 
{
  "mcpServers": {
    "Allo": {
      "serverUrl": "https://mcp.withallo.com/mcp",
      "headers": {
        "Authorization": "YOUR_API_KEY"
      }
    }
  }
}

​
Other clients

Any MCP-compatible client can connect to Allo using:
  • Server URL: https://mcp.withallo.com/mcp
  • Transport: HTTP
  • Authentication: Authorization header with your API key
Refer to your client’s documentation for how to configure remote MCP servers with custom headers.

​
Available tools

Once connected, your AI assistant can use these 14 tools:
ToolWhat it does
allo_get_meDiscover your API key’s scopes, available endpoints, and team info
allo_list_usersList team members with roles and status
allo_list_numbersList phone numbers with capabilities (voice, SMS)
allo_list_tagsList all tags configured on your team
allo_list_conversationsList conversations grouped by contact, sorted by recent activity
allo_search_conversation_itemsSearch calls and SMS with filters: keyword, type, direction, tags, date range
allo_get_conversation_itemGet full details of a call or SMS, including transcript
allo_batch_get_conversation_itemsFetch up to 100 items in a single request
allo_mark_conversationMark conversations as read, unread, archived, or unarchived
allo_add_call_tagsAdd tags to a call
allo_remove_call_tagRemove a tag from a call
allo_send_smsSend an SMS from one of your Allo numbers
allo_get_team_analyticsGet team KPIs: total calls, talk time, answer rate, per-user breakdown
allo_get_team_outbound_analyticsGet outbound metrics: dial funnel, time series, heatmap, leaderboard

​
Required scopes

Each tool requires specific API key scopes. Select the scopes matching the tools you need:
ScopeTools
CONVERSATIONS_READList conversations, search, get item, batch get, mark conversation
USERS_READList users, get me
PHONE_NUMBERS_READList numbers
TAGS_READList tags
TAGS_WRITEAdd tags, remove tag
SMS_SENDSend SMS
For full access to all 14 tools, select all scopes when creating your API key.

​
Example prompts

Once connected, try asking your AI assistant:
  • “Show me all missed calls from this week”
  • “What was my team’s answer rate last month compared to the month before?”
  • “Find all calls tagged ‘demo’ from the past 30 days and summarize the transcripts”
  • “Send an SMS to +33612345678 from my main number saying we’ll call back in 10 minutes”
  • “Who on my team made the most outbound calls this week?”
  • “List all unread conversations and mark them as read”
  • “Tag the last 5 inbound calls as ‘support‘“

​
Troubleshooting

Verify your API key is correct and has not been revoked. Go to Settings > API to check your active keys. If needed, create a new key.
Your API key is missing a required scope. Check the required scopes table above and create a new key with the needed scopes.
Make sure the MCP server is connected and active. Restart your AI client and verify the server URL is exactly https://mcp.withallo.com/mcp. Some clients require a restart after adding a new MCP server.

​
Need help?

API authentication

Full API key and scopes documentation

Contact support

Get help from the Allo team