MCP
The GrowthFactor MCP lets you use GrowthFactor's site-evaluation tools directly inside the AI assistant you already use — Claude (Desktop, Web, Code), Cursor, or any MCP-compatible client. Instead of switching tabs into the GrowthFactor app, you ask Claude things like "score this address" or "rank my pipeline" and it pulls real data from your GrowthFactor workspace.
What you can do with the MCP
Every figure the assistant cites comes from a real tool call against your account. The MCP uses the same tools that power the GrowthFactor app:
Scoring a location
GrowthFactor Score (0–100) with the lens breakdown and explanations
Demographics
Population, income, age, education for a trade zone (drive-time, walk-time, or ring)
Foot traffic
Pedestrian patterns at the exact point
Analogs
Similar stores in your own portfolio to benchmark against
Cannibalization
Trade-zone overlap with your existing sites
Your portfolio
List, view, create, and update sites
Your pipeline
List, view, create, and update deals
Reports
Generate and retrieve site evaluation reports
ML predictions
Run any sales-prediction model your workspace has configured
MCP vs. the GrowthFactor Agent
The MCP and the in-app GrowthFactor Agent run on the same analytics tools, so they share the core data. The difference is where they run and what each is best at.
In most cases, build your strategy in the Agent. It's where you draw and combine trade zones into custom territories, find your whitespace, drop and compare pins live on the map, and annotate it all for your team — and it remembers your work across sessions. Reach for the MCP when you want GrowthFactor data inside the AI tool you already use, most often to turn a finished strategy into a committee-ready deck.
Where it runs
Your AI client (Claude, Cursor, ChatGPT)
Inside the GrowthFactor app
Demographics, traffic, scoring, analogs
✓
✓
Sites & deals (list, create, update)
✓
✓
Compute a trade zone
✓
✓
Sales-forecast reports
✓
✓
Build & combine trade zones
—
Union, intersect, and subtract zones into custom territories
Whitespace / gap analysis
—
Subtract existing coverage to find uncovered demand
Cannibalization
Single point vs. your portfolio
Pin-based — compare a pin against every other pin, area, and site, drawn on the map
Live market-planning visuals
Returns data to your client
Drops pins, draws zones, and renders the full map and tables as you plan
Annotate & share the map
—
Mark up, comment on, and rename study elements for your team
Memory
Stateless — each call starts fresh
Remembers you and your team across conversations
Committee-ready decks
Pipe GrowthFactor data into your AI client to assemble a deck
—
Omnichannel access
—
On the roadmap
Suggested workflow: build your strategy in the Agent — draw your territories, run cannibalization and whitespace analysis, and shape your market plan visually — then use the MCP to turn it into a committee-ready deck in your AI client.
Supported clients
The MCP works with any MCP-compatible client. The most common are:
Claude Code
Cursor
ChatGPT
Connecting GrowthFactor to your MCP client
Authentication
The MCP uses your existing GrowthFactor login. When you add the server, your client opens a browser tab and prompts you to sign in. Approve the connection and you're done.
Re-auth happens automatically when your session expires. You can revoke the connection at any time from your AI client's connector settings.
Configuration
The server URL is the same everywhere: https://mcp.growthfactor.ai/mcp. The steps differ by client.
Claude Desktop and Claude.ai
Open Settings
Select Connectors
Click Add custom connector at the bottom of the page
Click Add custom connector at the bottom of the page
Name it GrowthFactor and paste
https://mcp.growthfactor.ai/mcpas the URLSave. Claude opens a browser tab to GrowthFactor — sign in with your usual login and approve the connection.
Claude Code
Add the server by running the following in your command prompt or terminal:
Start the authentication flow by running
/mcpinside Claude Code and selecting GrowthFactor.Claude Code opens a browser tab to GrowthFactor — sign in with your usual login and approve the connection. You'll see
Authentication successful. Connected to growthfactor.in the terminal once it's done.
Example prompts
Open a chat in your AI client and ask the assistant directly. A few starting points:
"Score 123 Main St, Austin with a 10-minute drive-time trade zone."
"Pull demographics and analogs for the corner of Newbury and Dartmouth in Boston."
"Which 5 deals in my pipeline have the best foot traffic? Rank them."
"Where should I open next in Nashville?" — the assistant will pick candidate corridors, score each, and compare them in a table.
Workspace context
If you belong to more than one workspace, the assistant will ask which one to use. Say "use the Acme workspace" once and it'll stick for the rest of the conversation.
The MCP respects the active workspace's Site Score lenses, default trade zone, tracked brands, and brand-specific model defaults — the same context the in-app GrowthFactor Agent uses.
Privacy and permissions
Access uses your existing GrowthFactor login and respects your workspace permissions. If you can't see a site in the app, the assistant can't see it either.
Write actions (create deal, update site) require you to specify the exact target and value. The assistant won't experiment with your data.
You can revoke the connection at any time from your AI client's connector settings.
Tips for good results
Be specific about trade zones ("10-minute walk", "2-mile ring") or let the default apply — the assistant will tell you which zone it used.
Tell it your intent ("I'm scouting for a second location near my best store") — it tailors the analysis and helps us improve the product.
For broad asks ("where in Boston?"), the assistant proposes candidate areas first and waits for your go-ahead before running a full scan.
Last updated
Was this helpful?