# Local Dominator MCP Server

Official Model Context Protocol (MCP) connector for [Local Dominator](https://localdominator.co). Connects AI agents (Claude, Google Antigravity, OpenAI Codex, OpenClaw, and any other MCP-compatible client) directly to your Local Dominator account.

Once connected, you can ask your AI agent in plain English to pull SERP rankings, site audit issues, AI Tracker visibility, geogrid scans, and review data. No CSV exports, no dashboard switching.

All 20 tools are read-only. Nothing that spends credits (new scans, new audits, new AI Tracker runs) is exposed through this connector.

## Requirements

- Node.js v18 or higher
- - Git (`npx` needs it to fetch this repo from GitHub; most Mac/Linux machines already have it, on Windows install with `winget install --id Git.Git -e` if `git --version` doesn't work)
  - - A Local Dominator account and API key (from your account's API settings page)
   
    - ## Usage
   
    - Add this to your MCP client's config, using `npx` to run directly from this repo (no local install or npm registry required):
   
    - ```json
      {
        "mcpServers": {
          "local-dominator": {
            "command": "npx",
            "args": ["-y", "github:localdominator/mcp-server"],
            "env": {
              "LOCAL_DOMINATOR_API_KEY": "ld_your_actual_key_here"
            }
          }
        }
      }
      ```

      Replace the API key with your real one. Never share it in chat, email, or a screenshot, treat it like a password.

      Clients that use a TOML config instead of JSON (like the OpenAI Codex app) use the same `command`/`args`/env pattern under a `[mcp_servers.local-dominator]` table, see that client's setup guide for the exact syntax.

      ### Alternative install: Claude Desktop Extension

      If you're on Claude Desktop, you can skip the `npx`/Git setup entirely and install a self-contained `.mcpb` Desktop Extension instead:

      1. Download [local-dominator.mcpb](https://github.com/localdominator/mcp-server/releases/download/v1.0.0/local-dominator.mcpb) from the latest release.
      2. 2. In Claude Desktop, go to **Settings → Extensions → Advanced settings → Install Extension** and select the downloaded file.
         3. 3. Enter your API key when prompted.
           
            4. This bundles the connector directly in the package, no Git, no `npx`, no internet fetch at install time.
           
            5. Setup guides for specific clients:
            6. - [Connect to Claude Desktop](https://localdominator.co/help/connect-local-dominator-claude)
               - - [Connect to Google Antigravity](https://localdominator.co/help/connect-local-dominator-antigravity)
                 - - More guides at [localdominator.co/help-category/integrations](https://localdominator.co/help-category/integrations/)
                  
                   - ## Available Tools
                  
                   - | Tool | What it does |
                   - |------|---------------|
                   - | `ld_account_status` | Credit balances across all modules |
                   - | `ld_serp_list_campaigns` | List SERP campaigns |
                   - | `ld_serp_get_keywords` | Keyword rankings for a campaign |
                   - | `ld_serp_campaign_analytics` | Campaign-level trends and visibility scores |
                   - | `ld_serp_keyword_analytics` | Single keyword rank history |
                   - | `ld_serp_get_serp_snapshot` | Full SERP result snapshot for a keyword |
                   - | `ld_serp_export` | CSV export of a campaign |
                   - | `ld_site_audit_list` | List sites and audits |
                   - | `ld_site_audit_get_issues` | Technical SEO issues (filterable by severity) |
                   - | `ld_site_audit_get_pages` | Crawled pages from an audit |
                   - | `ld_geogrid_list_scans` | List geogrid scans |
                   - | `ld_geogrid_get_results` | Grid results for a scan (auto-polls until ready) |
                   - | `ld_geogrid_list_scheduled_scans` | List recurring scan campaigns |
                   - | `ld_geogrid_get_scheduled_run_results` | Results from a scheduled run |
                   - | `ld_ai_tracker_list_campaigns` | List AI Tracker campaigns |
                   - | `ld_ai_tracker_get_results` | LLM visibility results and rankings |
                   - | `ld_ai_tracker_get_prompts` | Tracked prompts for a campaign |
                   - | `ld_reviews_list_campaigns` | List Review Velocity campaigns |
                   - | `ld_reviews_get_reviews` | Scraped reviews with rating/date filters |
                   - | `ld_reviews_get_analysis` | Velocity and reputation analysis |
                  
                   - ## Full API Reference
                  
                   - For anything beyond these prebuilt tools: [app.localdominator.co/api-doc](https://app.localdominator.co/api-doc/)
                  
                   - ## Security
                  
                   - - Your API key is passed via the `LOCAL_DOMINATOR_API_KEY` environment variable at runtime. It is never written to disk by this server and never leaves your machine except in requests to `api.localdominator.co`.
                     - - If a key is ever exposed, revoke it immediately in your Local Dominator account settings and generate a new one.
                       - - Use a separate API key per team member for accurate audit trails and easy revocation.
                        
                         - ## License
                        
                         - MIT
                         -