An MCP server for location data: ask, build and run flows from your AI assistant
Connect Claude, ChatGPT or a coding assistant to xMap Flows, ask about places, counts and gaps in a sentence, then turn a good answer into a flow that runs each week.
Part of the guide AI employees
xMap Flows runs an MCP server for location data at https://flows.xmap.ai/mcp. Once your AI assistant is connected, you can ask it how many pharmacies sit within two kilometres of a station, where the gaps are, or which of three addresses suits a new branch, and it answers from xMap's places database and the other data blocks. When an answer is worth repeating, the same conversation can build a flow, test it and, with your go-ahead, set it running every week.
MCP, the Model Context Protocol, is the standard way for an AI assistant to use outside tools. This article is for analysts, expansion and sales teams, and developers who already work in an assistant and want location data inside it rather than in another tab. It covers what the server offers, how to connect, what a session looks like, and what the assistant will not do without asking. For the people side of all this, see AI employees.
What the assistant can reach
The server gives the assistant the same building blocks a person uses in the app, as tools it can call:
- Quick answers about a place. Ask the map counts the places of one to three kinds within 1, 2 or 5 km of a point, splits the circle into a three by three grid and names where they are fewest, and adds residents where population figures exist. It quotes the price before it searches.
- Side by side comparisons. Two or three addresses measured the same way: people, rivals, getting there, risks, with a short verdict.
- Building flows in words. Describe a job and xMap AI builds the flow; the assistant can then check it, test run it and read the first results.
- Your existing work. List your AI employees, read their runs, look through results and tables, and see this week's findings.
- The catalogue. Every block that is switched on, with its settings, and the templates to start from.
Behind those tools sit the data blocks themselves: places from Nearby places, residents by age from Demographics in the countries it covers, live road speeds from Traffic Flow, job postings, weather and more. The assistant cannot invent coverage that is not there: population figures, for instance, exist in some countries and not in others, and the answer says so.
Connecting your assistant
- In Claude, add a custom connector with the server address and sign in to xMap Flows when asked; in ChatGPT, create a connector in developer mode with the same address and OAuth. No key is needed either way.
- For Claude Code, Cursor and other coding assistants, make a personal access key under Settings, API keys and AI assistants. The window shows the exact command or settings to paste.
- If you belong to several organizations, a key can open just the one you made it in, which is the safer choice. A key can also be read-only.
Connected assistants are listed on the same Settings page, and deleting one cuts it off immediately.
A session, step by step (made up)
An expansion analyst for a pharmacy group is weighing Toronto neighbourhoods. She opens her assistant and works through it in plain sentences:
- How many pharmacies are within 2 km of Union Station, and where are the gaps? The assistant asks Ask the map for the price, tells her, and on her yes returns the count, how many are chains, the average rating, and the parts of the circle with the most residents for each pharmacy.
- Now compare that spot with Yonge and Eglinton and with Liberty Village. The assistant runs a site comparison, again price first, and lays out the table with the strongest site for each row.
- Build me a flow that tells me every Monday when a pharmacy opens within 2 km of each of those three spots. xMap AI builds it: Schedule, Area of interest with the three points, Nearby places, Only new, and an Email to her.
- Test run it. The test run sends nothing and shows the places it would have reported.
- Deploy it. The assistant asks her to confirm before it switches the flow on, because a live flow uses credits and sends email.
By the end she has three answers for today's meeting and an AI employee that keeps watch from now on, without leaving the conversation.
What it will not do without asking
| Action | What happens |
|---|---|
| A test run | Runs at once; nothing is sent |
| A paid search | The price is said first |
| A real run or a deploy | Asks you to confirm |
| Sending an email or an app message | Asks you to confirm |
| Deleting a flow | Asks first; deletion is permanent |
| Connecting an app or database | Not from the assistant: add connections in the app |
The assistant acts as you, with the access you already have, never more.
It sees only your own organizations, and only the flows you may see in them. Results of a colleague's private flow stay hidden from your assistant exactly as they do in the app.
Getting good answers
- Name a distance. Near the station leaves the assistant guessing; within 1 km does not.
- Use the words the data uses for a kind of place, or let the assistant suggest them: pharmacy, dentist, coffee shop, gym.
- Ask for the flow once you have asked the same question twice. A weekly flow is cheaper than asking by hand every week, and it only reports what is new.
- Keep one conversation per question. Long threads mixing three cities and five kinds of place are harder for any assistant to follow.
Questions
Which AI assistants work with the xMap Flows MCP server?
Claude and ChatGPT connect by signing in through the browser. Claude Code, Cursor, Windsurf and other assistants that speak MCP connect with a personal access key.
Does it cost anything to ask a question?
Questions about your own flows and results do not. Searches on live data use your organization's credits, as in the app, and the assistant tells you the price before it searches.
Can the assistant change or delete my flows?
With a full key or a browser connection it can change flows you may change, but it asks before deploying, sending or deleting. A read-only key can only look.
Where does the location data come from?
From xMap's own data blocks: the places database, population figures where they exist, live road speeds, job postings and others. Coverage varies by block and country, and answers say when something is not covered.
Templates that do this
Read next
More on ai employees and automation · Every article · Templates