This Local Falcon MCP Server enables AI agents to integrate with Local Falcon's local search marketing tools through the Model Context Protocol. With this server, you can:
- Access Reports: Retrieve various report types including Scan, Trend, Keyword, Competitor, Campaign, and Falcon Guard Reports
- Manage Locations: List and fetch Google Business locations and their associated data
- Perform Searches: Execute grid searches with customizable parameters (coordinates, radius, grid size)
- Analyze Rankings: Get search results and ranking data for specific businesses at given coordinates
- Monitor Competitors: Access competitor business data and performance reports
- Track Campaigns: Analyze campaign performance and retrieve detailed reports
- Apply Filters: Use pagination and filtering options when retrieving lists of data
- Access AI Analysis: Retrieve AI-generated analysis of scan reports
Pro users (Claude Max/Team) benefit from higher tool call limits for more advanced workflows.
Provides tools for retrieving Google Business location data, analyzing search rankings at specific coordinates, and performing grid searches for business rankings across geographic areas.
Local Falcon MCP Server
An MCP (Model Context Protocol) server for the Local Falcon API, implemented in TypeScript, using the official MCP SDK. This server exposes Local Falcon reporting capabilities as MCP tools, enabling integration with agentic AI systems and workflows.
Prerequisites
- Node.js (install the LTS version)
Getting Started in Claude Desktop
- Create a new directory for the MCP server and install the package.
- Copy the path to the installed npm module and add it to the args in the mcp.json file making sure to point to the index.js file under /dist.
- Add your API key to the env in the mcp.json file.
Running via STDIO
For MacOS/Unix use the following format:
For Windows use the following format:
Running via SSE via a STDIO Gateway
For all platforms use the following format:
Pro Users
For Claude Max/Team users you unlock a greater MCP tool call limit. This must be enabled by appending the is_pro=true
in the query string of the URL. For example:
Running via Claude Integrations (SSE)
If connecting to Claude integrations:
- name the server
Local Falcon MCP
- add the following url: https://mcp.localfalcon.com/sse?local_falcon_api_key=YOUR_API_KEY_HERE
Tools List
- listLocalFalconScanReports: Retrieves a list of all Scan Reports performed by your Local Falcon account.
- listLocalFalconTrendReports: Retrieves a list of all Trend Reports performed by your Local Falcon account.
- listLocalFalconAutoScans: Retrieves a list of all Auto Scans.
- listAllLocalFalconLocations: Retrieves a list of all locations.
- listLocalFalconLocationReports: Retrieves a list of all location reports.
- getLocalFalconLocationReport: Retrieves a single location report. A location report looks like https://www.localfalcon.com/reports/location/view/c60c325a8665c4a where c60c325a8665c4a is the report key.
- getLocalFalconReport: Retrieves a single Local Falcon scan report given a report key. Only reads the ai analysis of the returned report. Otherwise report the ai analysis is not present. Users can also enter the report key in the format of https://www.localfalcon.com/reports/view/0b38313fa35c37f where 0b38313fa35c37f is the report key.
- getLocalFalconTrendReport: Retrieves a single Local Falcon trend report. A trend report looks like https://www.localfalcon.com/reports/trend/view/95290829819f6e8 where 95290829819f6e8 is the report key.
- listLocalFalconKeywordReports: Retrieves a list of all keyword reports. A keyword report looks like https://www.localfalcon.com/reports/keyword/view/754ffcb0f309938 where 754ffcb0f309938 is the report key.
- getLocalFalconKeywordReport: Retrieves a single Local Falcon keyword report.
- getLocalFalconGrid: A helper method to create a Local Falcon grid.
- getLocalFalconGoogleBusinessLocations: Fetches Local Falcon Google Business locations.
- getLocalFalconRankingAtCoordinate: Retrieves search results at the specified coordinate point and gets ranking data for specified business.
- getLocalFalconKeywordAtCoordinate: Retrieves search results at the specified coordinate point without any rank comparison data.
- runLocalFalconFullGridSearch: Retrieves a full grid search using the passed keyword or search term to match against the specified business.
- getLocalFalconCompetitorReports: Retrieves a list of all Competitor Reports within your Local Falcon account.
- getLocalFalconCompetitorReport: Retrieves up to 20 competitor businesses from a specific Competitor Report from your Local Falcon account.
- listLocalFalconCampaignReports: Retrieves a list of all Location Reports within your Local Falcon account.
- getLocalFalconCampaignReport: Retrieves a full report of a Campaign from your Local Falcon account.
- listLocalFalconGuardReports: Retrieves a list of all Falcon Guard Reports within your Local Falcon account.
- getLocalFalconGuardReport: Retrieves a full report of a Falcon Guard Report from your Local Falcon account given a place_id.
For developers
- Build (necessary to run in local MCP host applications):
- Run MCP Inspector:
- Run MCP Server:Run one of the following:Note: if sse is not specified, the server will default to stdio.
License
MIT
Acknowledgments
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Tools
Connects AI systems to Local Falcon API, enabling access to local SEO reporting tools including scan reports, trend analysis, keyword tracking, and competitor data through the Model Context Protocol.
- Prerequisites
- Running via STDIO
- Running via SSE via a STDIO Gateway
- Pro Users
- Running via Claude Integrations (SSE)
- Tools List
- For developers
- License
- Acknowledgments
Related Resources
Related MCP Servers
- -securityAlicense-qualityActs as a bridge between AI models and Google's PageSpeed Insights API, enabling detailed performance analysis of websites.Last updated -44JavaScriptMIT License
- -securityFlicense-qualityProvides SEO automation with tools for keyword research, SERP analysis, and competitor analysis through Google Ads API integration, enabling AI assistants to access these capabilities via MCP.Last updated -4JavaScript
- -securityFlicense-qualityConnects Google Search Console with Claude AI to enable SEO professionals to analyze their SEO data through natural language conversations, providing access to property information, search analytics, URL inspection, and sitemap management.Last updated -44Python
- -securityFlicense-qualityEnables LLMs to interact with DataForSEO and other SEO APIs through natural language, allowing for keyword research, SERP analysis, backlink analysis, and local SEO tasks.Last updated -1,00838TypeScript