io.github.localseodata/mcp-server
42 local SEO tools for AI assistants. SERP tracking, reviews, keywords, audits, and more.
Open source Open in the app JSON README (API)
About
42 local SEO tools for AI assistants. SERP tracking, reviews, keywords, audits, and more.
Details
- Kind
- MCP servers
- Topic
- Marketing & analytics
- Publisher
- localseodata
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.1
- Stars
- 3
- Last push
- 2026-05-11T17:15:20Z
- Repository state
- ativo
- Language
- TypeScript
- License
- MIT
- Added
- 2026-08-29 04:00:24
- Updated
- 2026-08-29 04:00:24
- Origin id
io.github.localseodata/mcp-server
README
# 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