Local Falcon

You can connect to the Local Falcon MCP Server to access scanning, tracking, and reporting capabilities as MCP tools. This enables seamless integration with agented AI systems and IDEs, letting you run scans, view reports, and manage campaigns from your preferred MCP client.

How to use

You connect using either OAuth, a bearer token, an API key in the query string, or a local STDIO setup for offline development. The server exposes a comprehensive set of tools for scan reporting, campaign management,Reviews analysis, Falcon Guard monitoring, trend insights, and location/keyword data. Choose the connection method that fits your client capabilities and security preferences, then use the available tools to perform actions like running scans, listing reports, and managing campaigns.

How to install

Prerequisites: Node.js LTS installed on your development machine.

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

Additional sections

Connection options are described below. Each option includes the exact URL or command you should use and any required authentication steps.

OAuth (Recommended): Use the server URL with OAuth authentication. You’ll be redirected to Local Falcon to authorize access, and tokens are managed automatically.

Bearer Token: If your MCP client does not support OAuth, provide your Local Falcon API key as a bearer token when connecting.

API Key via Query String: You can pass the API key directly in the URL when your client supports it.

Local STDIO: For offline development, run the local server and configure your MCP client to invoke the local node process with the provided script path and API key.

Security notes

Keep API keys and tokens secure. Use OAuth when possible to avoid manual key management.

Troubleshooting

Verify that the MCP server URL is reachable from your client, and confirm that authentication is configured correctly for your chosen method.

Available tools

listLocalFalconScanReports

List all existing scan reports so you can check for duplicates before running new scans.

getLocalFalconReport

Retrieve a specific scan report by its report key.

runLocalFalconScan

Execute a new scan at given coordinates to obtain ranking data for a business.

listLocalFalconCampaignReports

List all campaign reports for time-based ranking data across multiple scans.

getLocalFalconCampaignReport

Retrieve a specific campaign report by its key.

createLocalFalconCampaign

Create a new campaign with scheduled recurring scans.

runLocalFalconCampaign

Manually trigger a campaign to run immediately.

pauseLocalFalconCampaign

Pause a campaign's scheduled runs.

resumeLocalFalconCampaign

Resume a paused campaign.

reactivateLocalFalconCampaign

Reactivate a campaign deactivated due to insufficient credits.

listLocalFalconReviewsAnalysisReports

List AI-powered reviews analysis reports.

getLocalFalconReviewsAnalysisReport

Retrieve a specific reviews analysis report.

listLocalFalconGuardReports

List Falcon Guard reports for monitored locations.

getLocalFalconGuardReport

Retrieve a specific Falcon Guard report by place_id.

addLocationsToFalconGuard

Add locations to Falcon Guard protection.

pauseFalconGuardProtection

Pause protection for specified locations.

resumeFalconGuardProtection

Resume protection for paused locations.

removeFalconGuardProtection

Remove locations from Falcon Guard protection.

listLocalFalconTrendReports

List auto-generated trend reports showing ranking changes over time.

getLocalFalconTrendReport

Retrieve a specific trend report.

listLocalFalconAutoScans

List individually scheduled automatic scans (not campaign-based).

listLocalFalconLocationReports

List auto-generated location-specific reports.

getLocalFalconLocationReport

Retrieve a specific location report.

listLocalFalconKeywordReports

List auto-generated keyword reports.

getLocalFalconKeywordReport

Retrieve a specific keyword report.

getLocalFalconCompetitorReports

List auto-generated competitor analysis reports.

getLocalFalconCompetitorReport

Retrieve a specific competitor report.

listAllLocalFalconLocations

List all business locations saved in your account.

getLocalFalconGoogleBusinessLocations

Search Google for business listings to find Place IDs.

searchForLocalFalconBusinessLocation

Search for business locations on Google or Apple platforms.

saveLocalFalconBusinessLocationToAccount

Save a business location to your account.

getLocalFalconGrid

Generate grid coordinates for single-point checks.

getLocalFalconRankingAtCoordinate

Check ranking at a single coordinate.

getLocalFalconKeywordAtCoordinate

Search for a keyword at a single coordinate.

viewLocalFalconAccountInformation

Retrieve account information including user, credits, and subscription details.