Skip to content

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

MCP endpoint
https://app.localwrangler.com/api/mcp

Authentication

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.

Header (preferred)
Authorization: Bearer YOUR_TOKEN

Query parameter
https://app.localwrangler.com/api/mcp?token=YOUR_TOKEN

Getting a token

  1. 1
    Open Settings, AI Access and find Need a token.
  2. 2
    Give the connection a name you will recognise later, such as the device it runs on.
  3. 3
    Decide whether it may read call and chat transcripts. This is off unless you turn it on.
  4. 4
    Click 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

Claude Desktop
{
  "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 Code (CLI)
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

Cursor
{
  "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

Windsurf
{
  "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

VS Code (Copilot)
{
  "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.

Raycast
{
  "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.

ToolWhat it answers
list_leadsList leads in a period. Filter by status, by channel (form, call, chat), by source, or to only those nobody has contacted yet.
get_leadOne lead in full: what the visitor submitted, first and last touch attribution, and the AI summary of the call or chat.
lead_summaryCounts by status, channel and source, against the period immediately before, so you can see whether a week was better or worse.
find_contactFind 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.

ToolWhat it answers
traffic_overviewVisitors, pageviews, visits, leads, engaged and bounced visits, average visit length, and conversion, against the period before.
traffic_breakdownTraffic 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_performanceLeads attributed to each marketing channel, including the paid ones, as measured rather than estimated.

Calls

What your tracking numbers received.

ToolWhat it answers
call_statsCalls 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.