AI Access
Connect an AI assistant to this account and ask about your leads, traffic and calls.
Local Wrangler runs an MCP server, so an AI assistant such as Claude, Cursor or Windsurf can query this account directly in conversation. You ask in plain language, the assistant picks the right tool, and the answer comes from your real data rather than from a guess.
It is read only. A connected assistant can look at 8 tools covering leads, traffic, attribution and calls. It cannot change a lead, delete anything, send a message, or reach another account.
Endpoint
https://app.localwrangler.com/api/mcpAuthentication
Every request carries the token you created in Settings, AI Access. A header is the better way, because a query string is written to the logs of every proxy it passes through. Both work, for clients that cannot set headers.
Authorization: Bearer YOUR_TOKENhttps://app.localwrangler.com/api/mcp?token=YOUR_TOKENGetting a token
- 1Open Settings, AI Access and find Need a token.
- 2Give the connection a name you will recognise later, such as the device it runs on.
- 3Decide whether it may read call and chat transcripts. This is off unless you turn it on.
- 4Click Create connection, then copy the token straight into your AI client.
The token is shown once
Only a one way hash of it is stored, so nobody can look it up again, us included. If you lose it, disconnect that connection and create another. That is safer than a token you can retrieve, because it means a usable copy of your key is not sitting in our database waiting to be stolen.
It follows your plan
Reading your data through an AI client needs an active plan, the same as the dashboard does. If a subscription lapses, the connection stays set up and answers with an explanation instead of data; restoring the plan brings it back with the same token, nothing to reconfigure. Accounts covered by an agency are included and never lose access for this reason.
Owners and admins can create and disconnect connections. A connection reads the whole account, so it takes the same standing as inviting a colleague. Everyone on the team can see which connections exist and when each was last used.
Connect your AI client
Pick the client you use and replace YOUR_TOKEN with the token you copied. The same blocks are on the Settings screen, with a copy button.
Claude Desktop
Add this block to claude_desktop_config.json. You can open it from Settings, Developer, Edit Config.
Config file: macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"local-wrangler": {
"type": "streamable-http",
"url": "https://app.localwrangler.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Claude Code (CLI)
Run this once in your terminal. The header keeps the token out of the URL, so it stays out of shell history and server logs.
claude mcp add --transport http local-wrangler https://app.localwrangler.com/api/mcp \
--header "Authorization: Bearer YOUR_TOKEN"Cursor
Add the server to your global config at ~/.cursor/mcp.json, or to .cursor/mcp.json inside a project.
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"local-wrangler": {
"url": "https://app.localwrangler.com/api/mcp",
"transport": "streamable-http",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Windsurf
Add the server to ~/.codeium/windsurf/mcp_config.json. Windsurf accepts serverUrl and url.
Config file: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"local-wrangler": {
"serverUrl": "https://app.localwrangler.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}VS Code (Copilot)
Add the server to .vscode/mcp.json in your workspace, or to your user level MCP config.
Config file: .vscode/mcp.json
{
"servers": {
"local-wrangler": {
"type": "http",
"url": "https://app.localwrangler.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}Raycast
Copy the block below, then run the Install Server command in Raycast. It fills the form from your clipboard.
{
"name": "local-wrangler",
"transport": "streamable-http",
"url": "https://app.localwrangler.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}Available tools
You do not call these yourself. You ask a question and the assistant picks the tool, often several in a row. They are listed so you know what it can and cannot see.
Leads and contacts
Every enquiry that reached you, from forms, tracked calls and chat.
| Tool | What it answers |
|---|---|
list_leads | List leads in a period. Filter by status, by channel (form, call, chat), by source, or to only those nobody has contacted yet. |
get_lead | One lead in full: what the visitor submitted, first and last touch attribution, and the AI summary of the call or chat. |
lead_summary | Counts by status, channel and source, against the period immediately before, so you can see whether a week was better or worse. |
find_contact | Find a person by email, phone or name and see every enquiry they have ever sent, oldest first. |
Traffic and attribution
Where visitors come from and which of them turn into leads.
| Tool | What it answers |
|---|---|
traffic_overview | Visitors, pageviews, visits, leads, engaged and bounced visits, average visit length, and conversion, against the period before. |
traffic_breakdown | Traffic by one dimension: source, channel, referrer, campaign, keyword, page, entry or exit page, country, region, city, device, browser, operating system or domain. Returns the leading entries, the same ones the dashboard shows. |
ad_channel_performance | Leads attributed to each marketing channel, including the paid ones, as measured rather than estimated. |
Calls
What your tracking numbers received.
| Tool | What it answers |
|---|---|
call_stats | Calls per tracking number in a period, and how they went. |
Dates and time zones
Ask for a period in plain language and your assistant works out the dates. Two things are worth knowing, because they decide whether a number matches the one on your screen.
- Days are counted in UTC unless your assistant passes your time zone. If it does not, a lead that arrived late in the evening can be counted on the following day. Telling your assistant your city once, at the start of a conversation, is enough.
- Any comparison against the period before covers the same elapsed portion. Half way through today, it compares against half of the equivalent earlier day, so a normal day never looks like a collapse.
Call and chat transcripts
Off unless you switch them on for a connection, because the words in a transcript are your customers', not yours. With the switch off, the assistant still gets the AI written summary of a call, its sentiment and its qualification, so you can ask which calls went badly without the conversation itself leaving your account.
What a connection can never reach
- Call recordings and audio files
- Passwords, API keys, or the secrets behind your integrations
- Anything belonging to another account
Disconnecting
Click Disconnect beside a connection and confirm. It stops working on the next request. The row stays in the list, marked as disconnected, so you keep the record of what was connected and when it was cut off.
Check Last used
Every connection shows when it last read anything. If one you do not recognise has been used, disconnect it and create a new token for the client you do recognise.