# Local SEO Data MCP Server

[Model Context Protocol](https://modelcontextprotocol.io) server for [Local SEO Data](https://localseodata.com). Gives AI assistants access to 42 local SEO tools -- SERP tracking, review monitoring, keyword research, AI visibility scoring, geogrid scans, and more.

One-time setup, then ask questions in plain English and your assistant calls the right endpoints automatically.

## Prerequisites

1. Sign up at [localseodata.com/signup](https://localseodata.com/signup)
2. Create an API key in your [API Keys dashboard](https://localseodata.com/dashboard/keys)
3. Replace `YOUR_API_KEY` below with your key (starts with `sk_live_`)

## Setup

### Claude Code

```bash
claude mcp add localseodata --transport http "https://mcp.localseodata.com/mcp?key=YOUR_API_KEY" --scope user
```

The `--scope user` flag makes it available across all your projects. Restart Claude Code after adding.

### Claude Desktop

Add to your config file:
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

```json
{
  "mcpServers": {
    "localseodata": {
      "url": "https://mcp.localseodata.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

Restart Claude Desktop after saving.

### Cursor

Add to `.cursor/mcp.json` in your project root, or `~/.cursor/mcp.json` for global access:

```json
{
  "mcpServers": {
    "localseodata": {
      "url": "https://mcp.localseodata.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### VS Code (GitHub Copilot)

Add to `.vscode/mcp.json` in your project:

```json
{
  "servers": {
    "localseodata": {
      "type": "streamable-http",
      "url": "https://mcp.localseodata.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

### Cline

Open Cline settings > MCP Servers > Add Remote Server:
- **Name:** localseodata
- **URL:** `https://mcp.localseodata.com/mcp?key=YOUR_API_KEY`

### Windsurf

Add to `~/.codeium/windsurf/mcp_config.json`:

```json
{
  "mcpServers": {
    "localseodata": {
      "serverUrl": "https://mcp.localseodata.com/mcp?key=YOUR_API_KEY"
    }
  }
}
```

## Available Tools

| Category | Tools |
|----------|-------|
| SERP Data | `local_pack`, `organic_serp`, `local_finder`, `maps`, `local_services_ads` |
| AI/LLM Optimization | `ai_overview`, `ai_mode`, `ai_mentions`, `ai_visibility`, `ai_compare`, `ai_keyword_data`, `ai_top_sources`, `ai_top_pages` |
| Business Data | `business_profile`, `google_reviews`, `qa`, `business_listings`, `multi_platform_reviews` |
| Keyword Research | `search_volume`, `keyword_suggestions`, `keywords_for_site`, `related_keywords`, `keyword_trends` |
| Audits | `local_audit`, `citation_audit`, `reputation_audit`, `page_audit`, `profile_health` |
| Competitive Intel | `competitor_gap`, `competitor_ads`, `brand_mentions`, `backlink_gap`, `backlink_summary` |
| Reports | `review_velocity`, `local_authority`, `keyword_opportunities` |
| Geogrid | `geogrid_scan` |
| Locations | `location_search` |
| Utility | `ping`, `get_balance` |

## Example Prompts

Once connected, just ask naturally:

- "Who ranks in the local pack for 'plumber' in Denver?"
- "Run a full local SEO audit for Mike's Plumbing in Austin, TX"
- "Compare my Google reviews to my top 3 competitors"
- "What keywords should a dentist in Portland be targeting?"
- "Check if my business NAP is consistent across directories"
- "Map my rankings on a 5x5 geogrid for 'bakery' in Brooklyn"
- "What's my AI visibility score for 'best pizza in Chicago'?"

## Authentication

Your API key is passed as a URL query parameter (`?key=YOUR_API_KEY`). This works with every MCP client without needing custom header configuration. Keys can be created or revoked anytime in the [API Keys dashboard](https://localseodata.com/dashboard/keys).

## Pricing

MCP calls consume credits from your Local SEO Data account, same as REST API calls. Most endpoints cost 1 credit ($0.005). Monitor usage in your [dashboard](https://localseodata.com/dashboard).

See [localseodata.com/pricing](https://localseodata.com/pricing) for plans.

## Self-Hosting

If you want to run the MCP server yourself:

```bash
git clone https://github.com/localseodata/mcp-server.git
cd mcp-server
npm install
npm run build
```

Set the required environment variable and start:

```bash
export API_BASE_URL=https://api.localseodata.com
npm start
```

The server runs on port 3003 by default (set `PORT` to change). A Dockerfile is included for container deployments.

## Development

```bash
npm run dev       # Watch mode with hot reload
npm run build     # Compile TypeScript
npm run typecheck # Type check without emitting
npm start         # Run compiled output
```

## License

MIT