Model Context Protocol

Prerequisites

• Factori account with available credits
• Compatible client: Claude, VS Code, Cursor, Gemini CLI, Antigravity, and more
• OAuth-only auth — no API keys needed
• Per-user setup — each team member connects individually

MCP Server URL

https://mcp.factori.ai/mcp

Connect Factori to Your Client

Claude.ai/ Desktop

1. Open Settings → Connectors
2. Click Add custom connector
3. Factori · URL: https://mcp.factori.ai/mcp
4. Click Add → Authorize

• Verify: Start a new chat and ask "How many credits do I have?", Claude should return your balance.
• Token refresh: OAuth tokens refresh automatically. If your session expires, just click through the OAuth flow again — no need to remove and re-add the connector.
• Multiple clients: You can connect Factori to multiple clients simultaneously. Each maintains its own OAuth session. Credits are shared across all sessions.

Claude Code

• claude MCP add factori https://mcp.factori.ai/mcp
• Verfiy: claude MCP list factori should appear as connected

**Token refresh: **OAuth tokens refresh automatically. If your session expires, just click through the OAuth flow again — no need to remove and re-add the connector.

Multiple clients: You can connect Factori to multiple clients simultaneously. Each maintains its own OAuth session. Credits are shared across all sessions.

VS Code

Requires GitHub Copilot with Agent mode enabled. VS Code supports remote HTTP MCP servers natively.

• Open Command Palette (Cmd+Shift+P) → MCP: Open User Configuration Or create .vscode/mcp.json in your workspace root for project-scoped config.
• Add the Factori server block:

• Open Copilot Chat (Ctrl+Alt+I) and switch to Agent mode
• When prompted, confirm trust for the Factori server and complete the OAuth flow

Verify: Click Configure Tools in the chat input — Factori's tools should appear in the list.

Agent mode only. MCP tools are invisible in Ask or Edit mode — make sure you select "Agent" from the mode dropdown.

**Token refresh: **OAuth tokens refresh automatically. If your session expires, just click through the OAuth flow again — no need to remove and re-add the connector.

Multiple clients: You can connect Factori to multiple clients simultaneously. Each maintains its own OAuth session. Credits are shared across all sessions.

Start Using Factori

Just describe what you want in plain English with no special commands needed.

• Audience Sizing -"How many marketing managers in California earn over $150,000?"
• People Search- "Find Java developers in San Francisco who are interested in hiking."
• Places Search - "Show me wheelchair-accessible coffee shops in downtown Austin."
• Enrichment - "Enrich the highest-rated 5 of those restaurants."

and more.

What Teams Are Solving

Real workflows across retail, marketing, strategy, research and more.

• Site Selection - Compare foot traffic, demographics, and competitive density across candidate locations before you commit.

Example - Which of these five sites in Toronto has the best foot traffic and underserved demand? Site 3 on King Street West leads on weekday foot traffic at 12,400 daily and has the lowest competitor density within half a mile...

• Competitive Intelligence - Map the competitive landscape in any market globally. Understand distribution, gaps, and shifting dynamics.

Example - How has fast-casual density changed in central Barcelona over 18 months? Fast-casual density in central Barcelona grew 14% year-over-year, concentrated in the Eixample district with 23 new openings...

• **Demand Forecasting - ** Identify seasonal patterns, peak periods, and shifts in activity that predict where demand is headed.

Example - How does foot traffic near our Singapore location change during holiday season? Foot traffic in your zone increases 38% from mid-November through New Year's, with peak days concentrated on Saturdays...

• Market Analysis- Enter a new market with a clear picture of who's there, what's built, and where the white space is.

Example - What's the retail and dining landscape in Berlin's Mitte district, and who lives there? Mitte has dense premium retail and international dining, with residents skewing 25–38 and median household income of €62K.

How Your Data Is Protected

• All MCP traffic encrypted via TLS 1.3.
• Factori never sees your AI conversation. Only tool calls pass through.
• MCP server runs on Factori's managed cloud with SOC 2 controls.
• Every tool call logged to your account for compliance tracking.

rm -rf ~/.mcp-auth/

Disconnect Factori

You can remove the connector at any time. Your Factori account and data are not affected.

• Claude.ai / Desktop: Settings → Connectors → Factori → Uninstall

• Claude Code: claude mcp remove factori

• VS Code: Command Palette → MCP: List Servers → remove the entry

• Gemini CLI: Remove the "factori" block from ~/.gemini/settings.json

• Cursor / Antigravity / others: Remove the "factori" block from your MCP config file and restart

  You can reconnect at any time by repeating Step 1.