How to Use the Local Falcon MCP in Claude

Q: Can I run a Local Falcon grid check directly from my Claude Desktop chat?

Yes, you just ask the agent to run a scan. It calls runscan and displays the grid results directly in your chat window using getscanresults.

Q: Can I pull trend data for multiple locations at once?

You can ask the agent to loop through your locations using listlocations and fetch historical trends. It runs gettrendreport for each identifier and summarizes the shifts in one clean desktop response.

Get live Google Maps grid rankings directly inside Claude Desktop to track local SEO performance without leaving your chat.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Local Falcon MCP to Claude Desktop

Create your Vinkius account to connect Local Falcon to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Local Falcon with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run instant grid scans from Claude Desktop

This Local Falcon MCP Server uses `run_scan` to trigger coordinate-based ranking checks directly from your Claude Desktop interface. Your Claude Desktop agent takes a specific business location ID, fires the grid scan, and pulls the raw search coordinates into your chat window. You don't need to open an external browser tab to check Google Maps ranking performance when Claude Desktop is running. The `get_scan_results` tool extracts the exact map ranking positions across your grid so your desktop app can analyze local visibility immediately.

Build local SEO trend reports in Claude Desktop

The `get_trend_report` tool compiles historical ranking shifts across your defined geographic coordinates directly inside your Claude Desktop chat window. Claude Desktop parses the Local Falcon trend data to show you exactly where your business is gaining or losing ground on Google Maps. Instead of exporting CSVs from a web portal, you ask the Claude Desktop agent to run `list_scans_by_location` to isolate specific trouble spots. It uses `get_scan_report` to format a clean breakdown of your local visibility over the last quarter right in the desktop chat.

Manage your location database inside your AI client

This Local Falcon MCP Server exposes `add_location` to let you register new business profiles directly through your Claude Desktop agent. The desktop agent verifies the setup instantly using `get_location` to make sure your coordinates are correct before running map scans. Keeping your Local Falcon keyword list clean is simple when you use `add_keyword` and `list_keywords` in the same Claude Desktop chat thread. You update your local search tracking parameters without touching a database or navigating external dashboards.

Setup guide

Set up Local Falcon MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Local Falcon MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Local Falcon MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under local-falcon-mcp.

json

{
  "mcpServers": {
    "local-falcon-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Local Falcon. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Local Falcon now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Local Falcon MCP in Claude Desktop

Open your Claude Desktop configuration file and add the server definition under the `mcpServers` key. Use the command and arguments provided by Vinkius, then restart your desktop app to see the tools.

Yes, you just ask the agent to run a scan. It calls `run_scan` and displays the grid results directly in your chat window using `get_scan_results`.

Vinkius manages the authentication securely, meaning your desktop app only needs a single endpoint token to execute tools like `check_localfalcon_status`. Your raw API key is never exposed to the LLM.

You can ask the agent to loop through your locations using `list_locations` and fetch historical trends. It runs `get_trend_report` for each identifier and summarizes the shifts in one clean desktop response.

Your location coordinates and search keywords are transmitted through sandboxed V8 isolates. This MCP setup processes these requests ephemerally, ensuring your proprietary geographic ranking data is never stored or used for training.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript