local-falcon

Local Falcon MCP Server

An MCP (Model Context Protocol) server for the Local Falcon local SEO and AI Visibility platform

---

Local SEO and AI Visibility Monitoring MCP Server

An MCP (Model Context Protocol) server for the Local Falcon platform, implemented in TypeScript, using the official MCP SDK. This server exposes Local Falcon scanning, tracking and reporting capabilities as 37 MCP tools, enabling integration with agentic AI systems and workflows.

---

Features

• 37 MCP tools for scanning, reporting, campaign management, competitor analysis, reviews, and Falcon Guard monitoring
• Interactive MCP Apps widget — geo-grid heatmap with Google Maps, colored rank pins, and clickable detail panels
• OAuth 2.1 with PKCE, refresh token support, and dynamic client registration
• Tool annotations on all 37 tools — readOnlyHint, destructiveHint, and openWorldHint for safe auto-execution
• Multi-platform — Google Maps, Apple Maps, ChatGPT, Gemini, Grok, Google AI Overviews, AI Mode
• ChatGPT MCP connector compatible — OAuth scope alignment, widget sandbox domain, structured content parsing
• HTML sanitizer for AI scrape content displayed in the heatmap widget

---

Prerequisites

• Node.js (install the LTS version)

Authentication

OAuth (Recommended)

OAuth is the recommended way to connect to the Local Falcon MCP server. It provides a secure, token-based authentication flow — no API key management required. You'll be redirected to Local Falcon to authorize access, and tokens are handled automatically.

1. Set the URL to https://mcp.localfalcon.com/mcp
2. Set Authentication to OAuth
3. Leave Client ID and Client Secret empty — the server handles client registration automatically
4. Connect and authorize when redirected to Local Falcon

Bearer Token

If your MCP client does not support OAuth, you can use your Local Falcon API key as a Bearer token.

1. Set the URL to https://mcp.localfalcon.com/mcp
2. Set Authentication to Bearer Token
3. Enter your Local Falcon API key as the token value

API Key via Query String

If your MCP client does not support OAuth or Bearer Token authentication, you can pass your API key directly in the URL:

https://mcp.localfalcon.com/mcp?local_falcon_api_key=INSERT_YOUR_API_KEY_HERE

---

Running via Remote (HTTP)

For MCP clients that use mcp-remote (all platforms):

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

Running via Remote (SSE — Legacy)

The /sse endpoint is considered legacy and will be removed in a future version. Use the /mcp endpoint instead.

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

Running via STDIO

One-click install: Download the latest .mcpb bundle from Releases and open it in Claude Desktop. For manual installation, follow the steps below.

For local installations, first install the package:

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

For 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"
      }
    }
  }
}