Docs
Integrations
MCP Server

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:

  1. Open Claude → SettingsConnectorsAdd custom connector
  2. Paste the server URL:
https://mcp.frontrun.vc
  1. 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 → SettingsAPI 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 credentials

Option B: Manual API key

Go to frontrun.vc (opens in a new tab)SettingsAPI 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 (36)

No API key required

ToolDescription
trending_teaserFree sample: top 5 trending companies from the last 7 days, no auth needed
send_feedbackReport a confusing error, a missing capability, or a docs gap to the Frontrun team

Tracking

ToolDescription
frontrun_statusAccount status, balance, usage stats
frontrun_list_trackedList all monitored accounts
frontrun_trackStart monitoring an X account
frontrun_untrackStop monitoring an X account
frontrun_previewPreview an account before tracking - signal score, sector hints, recommendation

Signals

ToolDescription
frontrun_new_followsDetect new follows across tracked accounts
frontrun_snapshotGet current follow list for an account
frontrun_enriched_followsNew follows with full AI enrichment
frontrun_convergenceDetect multi-account convergence signals
frontrun_trendingGet trending entities by follow velocity
frontrun_searchSearch entities by sector, keyword, or type
frontrun_thesis_searchSemantic thesis search - plain-language thesis in, matching companies out
frontrun_feedReal-time activity feed across all tracked accounts
frontrun_sectorsSector breakdown of discovered entities
frontrun_discoverPersonalized recommendations - accounts your VCs follow that you're not tracking
frontrun_reportsGenerated intelligence reports for your tracked accounts

Company intelligence

ToolDescription
frontrun_companyCompany overview - what they do, sector, stage
frontrun_company_foundersFounder profiles, backgrounds, previous companies (one company)
frontrun_founders_batchFounder lookup for up to 10 companies in one call, served from verified cache
frontrun_company_signalsSocial buzz, sentiment, notable engagements
frontrun_company_resourcesWebsite, GitHub, docs, community links
frontrun_company_fundingFunding rounds, investors, amounts

VC intelligence

ToolDescription
frontrun_vc_activityVC follow patterns - velocity, sector focus, recent follows
frontrun_vc_similarFind VCs with overlapping follow patterns

Classification

ToolDescription
frontrun_classifyRun AI classification on specific entities
frontrun_create_ruleCreate custom classification rules
frontrun_list_rulesList classification rules
frontrun_update_ruleUpdate a classification rule
frontrun_delete_ruleDelete a classification rule
frontrun_tagAdd custom tags/notes to entities
frontrun_list_tagsList your custom-tagged entities

Webhooks

ToolDescription
frontrun_list_webhooksList your registered webhooks
frontrun_create_webhookRegister a webhook for new_follows / convergence events
frontrun_delete_webhookDelete 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)