MCP Server
The Frontrun MCP server gives AI agents native access to the Frontrun API. 36 tools, version 2.6.0.
Claude (claude.ai and Claude Desktop): custom connector
The fastest way to connect. No install, no key handling:
- Open Claude → Settings → Connectors → Add custom connector
- Paste the server URL:
https://mcp.frontrun.vc- Claude opens a Frontrun login window. Sign in, click Connect, done.
Behind the scenes this uses OAuth: Claude gets your personal MCP key, which you can revoke anytime at frontrun.vc → Settings → API Keys. Requires an active Pro subscription or trial.
For terminal and IDE clients (Claude Code, Cursor), everything below runs via npx.
Setup
Option A: OAuth login (recommended)
No API key needed. Log in with your frontrun.vc account directly:
# Step 1: Log in - opens browser to frontrun.vc, saves credentials locally
npx frontrun-mcp-server --login
# Step 2: Auto-configure your client
npx frontrun-mcp-server --setup # Claude Desktop
npx frontrun-mcp-server --setup-code # Claude Code (uses `claude mcp add`)Credentials are saved to ~/.frontrun/credentials.json.
npx frontrun-mcp-server --status # Check auth status
npx frontrun-mcp-server --logout # Clear saved credentialsOption B: Manual API key
Go to frontrun.vc (opens in a new tab) → Settings → API Keys and create a key (starts with sig_). Then configure your client below.
Claude Code
If you used --setup-code above, you're done. Otherwise, run:
claude mcp add frontrun -e FRONTRUN_API_KEY=your_api_key --scope user -- npx frontrun-mcp-serverThe --scope user flag makes it available in every project. Verify with claude mcp list.
Claude Desktop
If you used --setup above, you're done. Otherwise, add to your config file:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"frontrun": {
"command": "npx",
"args": ["frontrun-mcp-server"],
"env": {
"FRONTRUN_API_KEY": "your_api_key"
}
}
}
}Restart Claude Desktop. The Frontrun tools will appear automatically.
Cursor
Add to .cursor/mcp.json in your project root:
{
"mcpServers": {
"frontrun": {
"command": "npx",
"args": ["frontrun-mcp-server"],
"env": {
"FRONTRUN_API_KEY": "your_api_key"
}
}
}
}Python
import subprocess, json
process = subprocess.Popen(
["npx", "frontrun-mcp-server"],
stdin=subprocess.PIPE,
stdout=subprocess.PIPE,
env={"FRONTRUN_API_KEY": "your_api_key", "PATH": "/usr/local/bin:/usr/bin"}
)JavaScript
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
const transport = new StdioClientTransport({
command: "npx",
args: ["frontrun-mcp-server"],
env: { FRONTRUN_API_KEY: "your_api_key" },
});
const client = new Client({ name: "my-app", version: "1.0.0" });
await client.connect(transport);Available tools (36)
No API key required
| Tool | Description |
|---|---|
trending_teaser | Free sample: top 5 trending companies from the last 7 days, no auth needed |
send_feedback | Report a confusing error, a missing capability, or a docs gap to the Frontrun team |
Tracking
| Tool | Description |
|---|---|
frontrun_status | Account status, balance, usage stats |
frontrun_list_tracked | List all monitored accounts |
frontrun_track | Start monitoring an X account |
frontrun_untrack | Stop monitoring an X account |
frontrun_preview | Preview an account before tracking - signal score, sector hints, recommendation |
Signals
| Tool | Description |
|---|---|
frontrun_new_follows | Detect new follows across tracked accounts |
frontrun_snapshot | Get current follow list for an account |
frontrun_enriched_follows | New follows with full AI enrichment |
frontrun_convergence | Detect multi-account convergence signals |
frontrun_trending | Get trending entities by follow velocity |
frontrun_search | Search entities by sector, keyword, or type |
frontrun_thesis_search | Semantic thesis search - plain-language thesis in, matching companies out |
frontrun_feed | Real-time activity feed across all tracked accounts |
frontrun_sectors | Sector breakdown of discovered entities |
frontrun_discover | Personalized recommendations - accounts your VCs follow that you're not tracking |
frontrun_reports | Generated intelligence reports for your tracked accounts |
Company intelligence
| Tool | Description |
|---|---|
frontrun_company | Company overview - what they do, sector, stage |
frontrun_company_founders | Founder profiles, backgrounds, previous companies (one company) |
frontrun_founders_batch | Founder lookup for up to 10 companies in one call, served from verified cache |
frontrun_company_signals | Social buzz, sentiment, notable engagements |
frontrun_company_resources | Website, GitHub, docs, community links |
frontrun_company_funding | Funding rounds, investors, amounts |
VC intelligence
| Tool | Description |
|---|---|
frontrun_vc_activity | VC follow patterns - velocity, sector focus, recent follows |
frontrun_vc_similar | Find VCs with overlapping follow patterns |
Classification
| Tool | Description |
|---|---|
frontrun_classify | Run AI classification on specific entities |
frontrun_create_rule | Create custom classification rules |
frontrun_list_rules | List classification rules |
frontrun_update_rule | Update a classification rule |
frontrun_delete_rule | Delete a classification rule |
frontrun_tag | Add custom tags/notes to entities |
frontrun_list_tags | List your custom-tagged entities |
Webhooks
| Tool | Description |
|---|---|
frontrun_list_webhooks | List your registered webhooks |
frontrun_create_webhook | Register a webhook for new_follows / convergence events |
frontrun_delete_webhook | Delete a webhook |
Example prompts
Once connected, ask your agent:
- "What are the trending companies this week?"
- "Show me convergence signals with threshold 3 in the last 14 days"
- "What new accounts did pmarca follow in the last 48 hours?"
- "Search for AI startups in the follow graph"
- "Track @sequoia"
- "Tag @openai as a competitor with sector AI"
Troubleshooting
"FRONTRUN_API_KEY environment variable is required" Your API key isn't set. Double-check the key in your config or command.
"Invalid API key" The key is wrong or inactive. Generate a new one at frontrun.vc → Settings → API Keys.
npx command not found Install Node.js 18+ from nodejs.org (opens in a new tab).
Compatible clients
Any MCP-compatible client works:
- Claude Code (CLI)
- Claude Desktop
- Cursor
- Windsurf
- Continue
- Custom MCP clients
Source code
The MCP server is open source: github.com/jongall45/frontrun-mcp-server (opens in a new tab)