Local Falcon MCP Server

Official MCP server for Local Falcon's local SEO platform. Geo-grid rank tracking, GBP monitoring, campaign management, and competitor analysis.

SEO & Content by Local Falcon OAuth2 active

Connect (Remote Server) GitHub Docs npm: @local-falcon/mcp

Overview

The Local Falcon MCP server is the official Model Context Protocol integration for Local Falcon, a local SEO and AI visibility platform focused on Google Business Profile (GBP) rank tracking via geo-grid scans. It exposes 37 tools across scan reporting, campaign scheduling, Falcon Guard GBP monitoring, reviews analysis, trend tracking, competitor analysis, and on-demand single-point ranking checks. Implemented in TypeScript using the official MCP SDK, it can run as a self-hosted STDIO server, a cloud-hosted remote server at https://mcp.localfalcon.com/mcp, or as a legacy SSE endpoint.

The server includes an interactive MCP Apps widget that renders a geo-grid heatmap with Google Maps integration, colored rank pins, and clickable detail panels when calling getLocalFalconReport in supported clients. Tools are annotated with safety hints: 26 are marked read-only and safe to auto-execute, 3 are destructive (consume credits or remove resources), and 8 modify state but are reversible. The repo also ships two bundled AI skills (local-falcon-mcp and local-visibility-skill) for agent guidance on metrics interpretation and tool usage.

Authentication supports OAuth 2.1 with PKCE and dynamic client registration (recommended for the hosted server), bearer token, or query-string API key for STDIO mode. Access requires a Local Falcon Basic monthly plan or higher.

Tools

Tool	Description
`runLocalFalconScan`	Executes a new geo-grid scan at specified coordinates to collect business ranking data (consumes credits).
`listLocalFalconScanReports`	Lists all existing scan reports. Check before running new scans to avoid duplicates.
`getLocalFalconReport`	Retrieves a specific scan report by key and renders an interactive geo-grid heatmap in supported clients.
`createLocalFalconCampaign`	Creates a campaign with recurring scheduled scans.
`runLocalFalconCampaign`	Manually triggers immediate execution of an existing campaign.
`pauseLocalFalconCampaign`	Pauses a campaign's scheduled runs.
`resumeLocalFalconCampaign`	Resumes a paused campaign.
`reactivateLocalFalconCampaign`	Reactivates a campaign halted due to insufficient credits.
`listLocalFalconCampaignReports`	Lists campaign reports with scheduled scan tracking.
`getLocalFalconCampaignReport`	Retrieves a specific campaign report.
`listLocalFalconGuardReports`	Lists Falcon Guard reports for monitored GBP locations.
`getLocalFalconGuardReport`	Retrieves a Falcon Guard report by place_id.
`addLocationsToFalconGuard`	Adds locations to Falcon Guard protection for GBP change monitoring.
`pauseFalconGuardProtection`	Pauses Falcon Guard protection for specified locations.
`resumeFalconGuardProtection`	Resumes paused Falcon Guard protection.
`removeFalconGuardProtection`	Removes locations from Falcon Guard entirely (destructive).
`listLocalFalconReviewsAnalysisReports`	Lists Reviews Analysis reports with AI-powered insights.
`getLocalFalconReviewsAnalysisReport`	Retrieves a specific Reviews Analysis report.
`listLocalFalconTrendReports`	Lists auto-generated reports showing ranking changes over time.
`getLocalFalconTrendReport`	Retrieves a specific trend report.
`listLocalFalconAutoScans`	Lists individually scheduled automatic scans (non-campaign).
`listLocalFalconLocationReports`	Lists auto-generated location-specific aggregate reports.
`getLocalFalconLocationReport`	Retrieves a specific location report.
`listLocalFalconKeywordReports`	Lists auto-generated keyword-specific aggregate reports.
`getLocalFalconKeywordReport`	Retrieves a specific keyword report.
`getLocalFalconCompetitorReports`	Lists auto-generated competitor analysis reports.
`getLocalFalconCompetitorReport`	Retrieves a specific competitor analysis report.
`listAllLocalFalconLocations`	Lists all business locations saved in the account.
`getLocalFalconGoogleBusinessLocations`	Searches Google for business listings and Place IDs.
`searchForLocalFalconBusinessLocation`	Searches for business locations on Google or Apple platforms.
`saveLocalFalconBusinessLocationToAccount`	Saves a business location to the Local Falcon account.
`getLocalFalconGrid`	Generates grid coordinates for single-point checks.
`getLocalFalconRankingAtCoordinate`	Single-point ranking check at one coordinate.
`getLocalFalconKeywordAtCoordinate`	Single-point keyword search at one coordinate.
`searchLocalFalconKnowledgeBase`	Searches Local Falcon's Knowledge Base for help articles.
`getLocalFalconKnowledgeBaseArticle`	Retrieves full content of a Knowledge Base article.
`viewLocalFalconAccountInformation`	Retrieves account info including user, credits, and subscription details.

Setup Guide

Prerequisites

Local Falcon Basic monthly plan or higher
Node.js 18+ (for self-hosted/STDIO mode)
A Local Falcon API key (found in your account settings)

Option 1: Remote MCP (Cloud-Hosted, OAuth)

Point your MCP client at the hosted endpoint and authorize via OAuth. No client ID or secret is needed (dynamic client registration is supported).

{
  "mcpServers": {
    "local-falcon-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.localfalcon.com/mcp?local_falcon_api_key=INSERT_YOUR_API_KEY_HERE"
      ]
    }
  }
}

For OAuth-capable clients, configure:

URL: https://mcp.localfalcon.com/mcp
Authentication: OAuth (or Bearer Token using your API key)

Option 2: Self-Hosted (STDIO)

mkdir lf-mcp
cd lf-mcp
npm i @local-falcon/mcp

Then add to your Claude Desktop config (MacOS/Unix):

{
  "mcpServers": {
    "local-falcon-mcp": {
      "command": "node",
      "args": ["/Users/YOUR_USERNAME/lf-mcp/node_modules/@local-falcon/mcp/dist/index.js"],
      "env": {
        "LOCAL_FALCON_API_KEY": "INSERT_YOUR_API_KEY_HERE"
      }
    }
  }
}

Windows uses the same shape with a backslash path under C:\\Users\\YOUR_USERNAME\\lf-mcp\\node_modules\\@local-falcon\\mcp\\dist\\index.js.

Environment Variables

LOCAL_FALCON_API_KEY: Local Falcon API key, required for STDIO mode

Use Cases

Run geo-grid scans for a target business and keyword, then render the heatmap directly in Claude to identify weak coverage zones
Set up and manage recurring Local Falcon campaigns to track GBP ranking changes across multiple keywords and locations
Monitor Google Business Profile listings with Falcon Guard, get alerts on unauthorized edits, and resume or remove protection conversationally
Pull competitor reports and trend reports to summarize ranking shifts week over week for client reporting
Perform quick single-point rank checks (getLocalFalconRankingAtCoordinate) without consuming full scan credits

Example Prompts

"Run a Local Falcon scan for 'emergency plumber' centered on our Austin location, then show me the heatmap."
"List all my Falcon Guard reports and tell me which locations had GBP changes this week."
"Create a weekly campaign that scans our top 5 keywords across all saved locations."
"Pull the most recent competitor report for our Denver office and summarize who's outranking us in the top-left grid quadrant."
"Check my Local Falcon account credit balance and pause any campaigns I can't afford to keep running."

Pros

Officially built and maintained by Local Falcon under the local-falcon GitHub org
Comprehensive coverage: 37 tools spanning scans, campaigns, Falcon Guard, reviews, trends, and competitor reports
Interactive geo-grid heatmap widget renders directly in supported MCP clients
Flexible deployment: hosted remote server with OAuth 2.1, or self-hosted STDIO with API key

Limitations

Requires a paid Local Falcon Basic monthly plan or higher
Scan execution consumes Local Falcon credits, so unattended agent loops can be expensive
Niche scope: only useful if you already use Local Falcon for local SEO tracking

Alternatives

DataForSEO MCP Server for broader SERP and SEO data including local pack results
BrightLocal or Whitespark (no official MCP server at this time, accessed via custom API integrations)
Google Business Profile API integrations for raw GBP performance metrics without geo-grid visualization