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:

You can ask about…	What it does
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

Supported clients

The MCP works with any MCP-compatible client. The most common are:

• Claude Code

• Cursor

• ChatGPT

Connecting GrowthFactor to your MCP client

• ChatGPT Setup documentation

• Claude Setup documentation

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

1. Open Settings

1. Select Connectors

1. Click Add custom connector at the bottom of the page

1. Click Add custom connector at the bottom of the page

2. Name it GrowthFactor and paste https://mcp.growthfactor.ai/mcp as the URL

3. Save. Claude opens a browser tab to GrowthFactor — sign in with your usual login and approve the connection.

Claude Code

1. Add the server by running the following in your command prompt or terminal:

   claude mcp add --transport http growthfactor https://mcp.growthfactor.ai/mcp

2. Start the authentication flow by running /mcp inside Claude Code and selecting GrowthFactor.

3. 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, apply tags) 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.