# Local Falcon MCP for AI Agents AI Agent Connect > Local Falcon lets you manage local SEO ranking data through your AI agent. It pulls geo-grid data, tracks how your business shows up on Google Maps, and monitors competitor performance across specific locations. You can trigger new scans, pull report metrics like Share of Local Voice, and manage keywords without clicking through a dashboard. ## Overview - **Category:** marketing-automation - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_S1OiGGj6bQPDywAZInaGG0YS21Wl1vNsXcVA3oIk/ai-agent-connect - **Tags:** local-seo, geo-grid, rank-tracking, google-maps, search-visibility, competitor-analysis ## Description You spend your day jumping between different tabs to see if your local shops actually show up on the map. It's a mess of spreadsheets and manual checks to see how a plumber in one city ranks compared to a competitor in the next. This Connector changes that by giving your AI agent a direct line into your Local Falcon account. Instead of hunting for reports, you just ask your agent to show you the latest ranking data or trigger a new geo-grid scan for a specific keyword. It handles the heavy lifting of pulling high-fidelity metrics like Average Ranking Position and Share of Local Voice so you can focus on the strategy. When you use this with Vinkius, you get a centralized way to manage your entire local search footprint. You can check your scan credits, verify your connection, and pull competitor data in one conversation. It turns your AI into a dedicated local search coordinator that knows exactly where your business stands across every grid point you care about. ## Tools ### list_keywords Get a list of all keywords you are currently tracking. Use this to audit your current search strategy. ### list_locations See every location currently in your Local Falcon account. It helps you manage your entire portfolio at once. ### list_scans List all scans in your account. Use this to quickly find your most recent ranking data. ### add_keyword Add a new keyword to your tracking list. This helps your agent know exactly what search terms to monitor. ### add_location Add a specific business location to your account. It ensures your geo-grid scans cover the right geographic areas. ### get_location Retrieve specific details about a business location. This helps you quickly identify which site you are looking at. ### check_localfalcon_status Verify your API connection is active. Use this to make sure your agent can still talk to your account. ### get_scan_report Pull the full data from a completed scan report. It gives you the high-fidelity ranking numbers you need for analysis. ### get_scan_results Get the specific results from a scan. Use this to see how your business performed at every grid point. ### get_scan Fetch the metadata and details of a specific scan. This is useful for identifying the correct report to analyze. ### get_trend_report Pull a report on ranking trends over time. It helps you see if your visibility is improving or dropping. ### list_scans_by_location See all scans associated with a specific location. This makes it easy to find historical data for one branch. ### run_scan Trigger a new geo-grid scan immediately. This lets you get real-time visibility data for any keyword or location. ## Prompt Examples **Prompt:** ``` Show me the Share of Local Voice for our main downtown location. ``` **Response:** ``` ### Local Search Visibility Report: Downtown **Location:** 123 Main St, Downtown **Key Metric: Share of Local Voice (SoLV)** | Business | SoLV % | Avg. Rank | | :--- | :--- | :--- | | **Your Business** | **65%** | **3.2** | | Competitor A | 20% | 5.1 | | Competitor B | 15% | 8.4 | Your business currently dominates the downtown grid. Would you like to see the specific grid points where your visibility drops? ``` **Prompt:** ``` Did our ranking for 'emergency plumbing' improve this week? ``` **Response:** ``` ### Ranking Trend Analysis **Keyword:** "emergency plumbing" * **Last Week:** Average Ranking Position (ARP) of **4.8** * **This Week:** Average Ranking Position (ARP) of **3.5** **Status:** 🟢 **Improved** Your visibility for this high-intent keyword has moved up by 1.3 positions on average across the geo-grid. Should I run a new scan to confirm these numbers? ``` **Prompt:** ``` Run a new scan for the new bakery location in Austin. ``` **Response:** ``` ### Scan Orchestrated I've successfully triggered a new geo-grid scan for the **Austin Bakery** location. * **Location:** Austin, TX * **Status:** Processing * **Report Key:** `rep_9921_austin` Local Falcon is now gathering real-time visibility data. I'll let you know as soon as the high-fidelity results are ready for review. ``` ## Capabilities ### Trigger new geo-grid scans Start a new ranking scan for any keyword and location using natural language. ### Pull ranking reports Retrieve high-fidelity ranking data and competitor metrics from completed scans. ### Monitor competitor visibility Access ranking data for local competitors at every grid point. ### Track local search trends Get reports on how your visibility changes over time. ### Manage keyword and location lists Add or list keywords and business locations directly through your agent. ### Check account status and credits Verify your API connection and monitor your remaining scan credits. ## Use Cases ### Checking a new location's visibility An SEO manager needs to see if a new shop is ranking. They ask the agent to run_scan for 'emergency plumbing' in a new zip code. ### Analyzing competitor market share An agency owner wants to see a competitor's SoLV. They use get_scan_report to pull the data for a specific grid and compare it to their own. ### Verifying campaign impact over time A marketing lead wants to see if a campaign worked. They use get_trend_report to see if their Share of Local Voice has increased over the last month. ### Quick portfolio audit An ops person needs to check their account. They use check_localfalcon_status to make sure their API key is still valid before a big meeting. ## Benefits - Get instant access to Share of Local Voice (SoLV) data by using get_trend_report to see your market share. - Monitor competitors across every grid point without manual searching by using list_scans to see their ranking data. - Trigger new scans on demand with run_scan to get real-time visibility for new keywords or locations. - Manage your entire portfolio of sites easily by using list_locations and list_keywords to audit your setup. - Keep your workflow moving by using check_localfalcon_status to ensure your connection is always active. ## How It Works The bottom line is you get a voice-controlled dashboard for your local SEO rankings. 1. Subscribe to the Connector and get your API key from the Local Falcon dashboard under API Credentials. 2. Connect your API key to your preferred AI client like Claude or Cursor. 3. Ask your agent to run a scan, list your keywords, or pull a ranking report for a specific location. ## Frequently Asked Questions **How does the Local Falcon MCP help with local SEO?** It pulls your geo-grid ranking data into your AI client so you can ask questions about your visibility. You can get summaries, check trends, and analyze competitor data without leaving your workspace. **Can I use Local Falcon MCP to see my competitors?** Yes, it lets your agent retrieve ranking data for competitors at every grid point. This helps you see exactly how much market share they are taking in specific neighborhoods. **Does Local Falcon MCP work for multiple locations?** It allows you to manage and list all locations in your account at once. You can quickly switch between different branches or cities to see how each one is performing. **How do I trigger a new scan with Local Falcon MCP?** You can just tell your agent to run a scan for a specific keyword and location. It handles the request to Local Falcon and gives you a report key to track the progress. **Can Local Falcon MCP show me ranking trends?** Yes, it can pull trend reports to show how your visibility has changed over time. This is great for seeing if your recent marketing efforts are actually moving the needle. **Is Local Falcon MCP good for agencies?** It's perfect for agencies because it lets you manage dozens of locations and keywords in one place. You can pull reports for various clients using natural language commands. **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.