MCP Server

The Frontrun MCP server gives AI agents native access to the Frontrun API. 29 tools, version 2.3.2. Everything 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 credentials

Option 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-server

The --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 (29)

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_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
`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

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/ML 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)

GET /v1/discover OpenClaw