Factori MCP Server

Your AI learned the internet. Now it can learn what's actually happening outside. Ask about people, places, movement, and markets across 229 countries, in plain English.

Prerequisites​

Factori account with available credits

OAuth-only auth, no API keys needed

Compatible client: Claude, VS Code, Cursor, Gemini CLI, Antigravity & more

Per-user setup, each team member connects individually

MCP Server URL – https://mcp.factori.ai/mcp

Distributed as a custom connector, paste the URL into your client’s MCP settings. Not yet listed in any client’s built-in connector directory.

Native remote MCP support. No bridge or proxy needed.

Open Settings → Connectors

Click Add custom connector

Name: Factori: URL: https://mcp.factori.ai/mcp

Click Add → Authorize

Complete the Factori OAuth login in the browser window that opens

You'll be redirected back, the connector is now active

One command. The CLI handles OAuth automatically.

claude mcp add factori https://mcp.factori.ai/mcp

Your browser will open to complete the Factori OAuth flow.
Verify:

claude mcp list
# → factori should appear as connected

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

Cursor uses the mcp-remote bridge. Requires Node.js 18+.
1

Open your Cursor MCP config:

Project-scoped: .cursor/mcp.json · User-scoped: ~/.cursor/mcp.json

2

Add the Factori server block:

Open your Cursor MCP config:

Project-scoped: .cursor/mcp.json · User-scoped: ~/.cursor/mcp.json

3

Fully quit Cursor (Cmd+Q) and reopen, hot-reload is unreliable for MCP config changes

4

On first use, mcp-remote opens your browser for OAuth. Tokens are cached in ~/.mcp-auth/​

Google Antigravity uses stdio MCP servers. Requires Node.js 18+.
1

In the Editor, click ⋯ menu → MCP Servers

2

Click Manage MCP Servers → View raw config

Opens ~/.gemini/antigravity/mcp_config.json

3

Fully quit Cursor (Cmd+Q) and reopen, hot-reload is unreliable for MCP config changes

4

Go back to Manage MCP Servers and click Refresh

5

On first use, mcp-remote opens your browser for the Factori OAuth flow​

Gemini CLI supports remote HTTP MCP servers natively with OAuth auto-discovery.
1

Open ~/.gemini/settings.json

Or use project-scoped .gemini/settings.json

2

Add the Factori server block:

3

Restart Gemini CLI or run /mcp reload

4

On first use, the CLI opens your browser to complete the Factori OAuth flow

5

On first use, mcp-remote opens your browser for the Factori OAuth flow​

The mcp-remote bridge works with Windsurf, Zed, JetBrains IDEs, and any stdio-only MCP client.

Restart the client after editing. OAuth happens on first tool call.

Claude Desktop config file paths:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json /

What Teams Are Solving​

Real workflows across retail, marketing, strategy, and research, all in plain English.

Site Selection

Compare foot traffic, demographics, and competitive density across candidate locations before you commit.

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…Which of these five sites in Toronto has the best foot traffic and underserved demand?

Competitive Intelligence

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

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…

Demand Forecasting

Identify seasonal patterns, peak periods, and shifts in activity that predict where demand is headed.

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.

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

Enterprise-grade security by default. No configuration required.

Encrypted in Transit​

All MCP traffic encrypted via TLS 1.3.

No Conversation Access

Factori account with available credits

Secure Infrastructure

MCP server runs on Factori's managed cloud with SOC 2 controls.

Audit Logging

Every tool call logged to your account for compliance tracking.

Troubleshooting

Connector won't authorize

Check that you're signed in to Factori in another tab, then retry.

"Insufficient credits" error

Check your balance: "How many credits do I have left?"

Tools don't appear in the client

Restart your client and verify the connector is active. In VS Code, make sure you're in Agent mode.

VS Code: config not loading

Restart your client and verify the connector is active. In VS Code, make sure you're in Agent mode.

Cursor / Antigravity: npx command not found

Install Node.js 18+ from nodejs.org

Cursor: tools not appearing after editing mcp.json

Fully quit (Cmd+Q on Mac) and reopen — hot-reload is unreliable for MCP config changes.

Bridge clients: mcp-remote keeps re-prompting for login

Delete cached tokens: rm -rf ~/.mcp-auth/ and retry.

Gemini CLI: server not connecting

Verify you used "httpUrl" (not "url") in settings.json. Run /mcp reload to retry.

Antigravity: tools not showing after config edit

Go to Manage MCP Servers and click Refresh. If that fails, uninstall and re-add the entry.

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.

Ready to give your agents real-world eyes?

Join the early access waitlist and be among the first to integrate 
Factori MCP into your AI stack.