# Local Falcon MCP > Local Falcon tracks Google Maps rankings across geographic grids. This tool lets you monitor local SEO performance and track search visibility for every business location. Use your AI client to programmatically run geo-grid scans, list competitor data, and get high-fidelity ranking reports. ## Overview - **Category:** marketing-automation - **Price:** Free - **Tags:** local-seo, geo-grid, rank-tracking, google-maps, search-visibility, competitor-analysis ## Description Local Falcon tracks Google Maps rankings across specific geographic grids, letting you monitor local SEO performance and track search visibility for every business location. Use your AI client to run geo-grid scans, list competitor data, and pull high-fidelity ranking reports. Before anything else, you gotta check the connection. You can use `check_localfalcon_status` to confirm that the API key is active and ready to go right now. Once it's confirmed live, you define what you wanna track by adding targets. To set up a new search term, just call `add_keyword`. If you need to monitor a different brick-and-mortar spot, use `add_location` to save a new business address or name; then, if you ever gotta grab details on one of those saved spots later, you run `get_location`. When you're ready to go live, triggering a scan is simple. You kick off the whole process with `run_scan`, providing it with the keywords and locations you set up. To see if that job kicked off correctly, you can pull basic status info using `get_scan`. For an overview of your history, running `list_scans` gives you a rundown of every scan job run through the system; you can also narrow that down to only view historical jobs for one specific spot by calling `list_scans_by_location`, or just see all your keywords with `list_keywords` and all your saved spots using `list_locations`. The real data comes after the scan completes. You'll pull the full report card, including competitor performance and ranking metrics, straight from `get_scan_report`. If you only need specific numbers—like a list of just the rankings and core metrics—you can grab that granular info with `get_scan_results`. For historical deep dives, don't mess around with manual sheets; use `get_trend_report` to generate reports showing exactly how your rankings have moved over multiple tracking periods. When you need to manage or check specific assets, the tools let you do it piece by piece. You can pull a list of all keywords configured right now using `list_keywords`, and if you're just looking at a single location's history, `list_scans_by_location` lets you filter that view down tight. Ultimately, your AI client acts like your dedicated local search coordinator. It handles the whole workflow—from verifying connectivity to defining targets, triggering the scan, and finally spitting out comprehensive reports on everything from Average Ranking Position (ARP) to competitor share of voice. ## Tools ### add_keyword Adds a new search term that the system will track for rankings. ### add_location Saves a new business address or location name to be included in scans. ### check_localfalcon_status Confirms the API connection is active and operational for immediate use. ### get_location Retrieves specific details about a saved location or business address. ### get_scan_report Fetches the full, detailed report card for a completed local search scan. ### get_scan_results Extracts specific ranking data and metrics from a finished scan job. ### get_scan Pulls basic status information for a previously initiated scan job. ### get_trend_report Generates reports showing how rankings have changed over multiple tracking periods. ### list_scans_by_location Filters and lists only the scans associated with a specific business location. ### list_keywords Lists all keywords currently configured in the Local Falcon account. ### list_locations Shows a list of all saved business locations for quick reference. ### list_scans Provides an overview and list of all historical scan jobs run through the system. ### run_scan Triggers an immediate, real-time geo-grid scan based on provided keywords and locations. ## Prompt Examples **Prompt:** ``` List the last 5 scan reports in my Local Falcon account. ``` **Response:** ``` I've retrieved your scans. You currently have 50 completed reports, including 'Plumber SEO Grid' and 'Dental NYC'. Would you like the detailed high-fidelity ranking metadata for any of them? ``` **Prompt:** ``` Show the rankings and SoLV for scan report 'rep_123'. ``` **Response:** ``` Accessing ranking architecture... Report rep_123 shows an ARP of 3.5 and a Share of Local Voice (SoLV) of 65%. I've retrieved the high-fidelity grid data for your review. Need help analyzing your top competitors? ``` **Prompt:** ``` Run a new grid scan for business 'Acme Plumbers' and keyword 'emergency plumbing'. ``` **Response:** ``` Scan orchestrated! I've successfully triggered a new geo-grid scan for 'Acme Plumbers'. The report key is rep_456. Local Falcon is now gathering real-time visibility data. Shall I notify you once the high-fidelity results are ready? ``` ## Capabilities ### Check Connectivity Status Verifies that the Local Falcon API key is active and connected to the system. ### Define Search Targets Adds new keywords or specific business locations to your tracking list. ### Run New Scans Initiates a real-time geo-grid scan for defined keywords and locations, gathering current visibility data. ### Retrieve Scan Reports Pulls detailed reports on completed scans, including ranking architecture metrics and competitor performance. ### Get Trend Data Access historical trend reports to track how rankings change over time for specific grids. ### List All Assets Retrieves lists of all saved keywords, locations, and completed scan jobs. ## Use Cases ### Client Audit: Checking Competitor Drift An agency owner needs to prove a client lost local ranking share. They ask their agent to run `list_scans_by_location` for the target site, then use `get_scan_report` on the last two scans. The agent pulls the ARP and SoLV metrics side-by-side, showing exactly when and where the competitor gained ground. ### New Campaign Launch: Full Geo-Grid Coverage A marketing ops person launches a new service area (e.g., 'Downtown Miami'). They first use `add_location` to save it, then call `run_scan` with the relevant keywords. The agent confirms the scan is running and sets up monitoring for when results are ready. ### Troubleshooting: Why Did Rankings Drop? A local SEO manager notices a sudden dip in visibility. They ask their AI client to run `get_trend_report` for the affected area and keyword. The agent analyzes the historical data, pinpointing the exact date and magnitude of the drop. ### Initial Setup: Building the Keyword Map A new user needs to build out their entire service area tracking. They use `list_locations` to see what's already saved, then call `add_keyword` multiple times for every relevant search term before running the first comprehensive scan. ## Benefits - See competitor performance at every grid point. Use `get_scan_report` to pull high-fidelity ranking data for all local rivals instantly. - Automate visibility checks on demand. Call `run_scan` with a new keyword or location, and get real-time results without leaving your chat window. - Track performance over time. Generate historical trends using `get_trend_report` to prove seasonal changes in search rank positioning. - Manage data efficiently. Use `list_scans` to see every scan run, and `list_locations` to verify which addresses are included in your campaigns. - Verify the setup quickly. Run `check_localfalcon_status` first—it confirms your API connection is solid before you start any major workflow. ## How It Works The bottom line is you don't check rank trackers manually; your AI client runs the scans and pulls all the resulting metadata for you. 1. Subscribe to the Local Falcon server and grab your API Key from the dashboard. 2. Tell your AI client what you want—for example, 'Run a new grid scan for Acme Plumbers and emergency plumbing.' 3. The agent calls `run_scan` and then uses tools like `get_scan_report` to pull back the high-fidelity ranking data. ## Frequently Asked Questions **How do I start tracking a new keyword with Local Falcon MCP Server?** First, use the `add_keyword` tool to save your term. Then, make sure you've run scans for that keyword using `run_scan`. You can confirm everything is ready by checking connectivity with `check_localfalcon_status`. **What data does get_scan_report provide?** `get_scan_report` pulls the complete, high-fidelity dataset for a finished scan. This includes detailed geo-grid rankings and competitor metrics that you can't find in basic summaries. **Can I check my API key status using Local Falcon MCP Server?** Yes, just call `check_localfalcon_status`. It confirms your account is active, which is the first step before running any other tools like `run_scan`. **Which tool do I use to see historical rank changes?** Use `get_trend_report`. This tool analyzes past data, letting you track how a keyword's performance has shifted over time across multiple scans. **How do I check available business coordinates before running a scan using `list_locations`?** It retrieves all known location identifiers within your account. This is the first step; use it to pull a list of valid locations you can then pass to the `add_location` tool for active targeting. **What should I do if my scan fails when using the `run_scan` tool?** The system will generate an error code and a status update. You need that report key to pass to the `get_scan` tool, which provides diagnostic details on why the scan failed. **Are there limits when I use `list_keywords` to manage my list?** The API handles large keyword sets efficiently. If you hit usage caps, check your dashboard for current consumption metrics. For high-volume work, consider optimizing your input lists. **What specific data points does `get_scan_results` return?** It returns raw, granular geo-grid data, including the precise ranking position and local voice share for every tracked keyword at a given location. It's the high-fidelity source material. **How do I find my Local Falcon API Key?** Log in to your account, navigate to the **API Credentials** page, and copy your unique Bearer Token or API Key. **Can I run new scans via AI?** Yes! The `run_localfalcon_scan` tool allows your agent to trigger real-time geo-grid scans by providing business and keyword metadata. **How do I check my scan credit balance?** Use the `check_localfalcon_status` tool to retrieve your current account metrics and remaining high-fidelity scan credits programmatically.