SearchAtlas MCP Server
The SearchAtlas MCP Server connects AI clients to a comprehensive SEO and digital marketing platform with 500+ tools, enabling automation across SEO, content, PPC, and more — accessible through natural language and compatible with clients like Claude, Cursor, VS Code, and Windsurf.
Multi-agent Orchestration – Route queries to specialized agents (SEO, content, PPC, etc.) using
searchatlas_orchestratorOn-Page SEO Automation (OTTO) – Deploy technical fixes, schema markup, and content optimizations via
searchatlas_otto_seoPPC / Google Ads Management – Create campaigns, set bid strategies, and analyze performance with
searchatlas_ppcAI Content Generation – Produce blog posts, landing pages, and optimized copy using
searchatlas_contentSite Auditing & Analysis – Crawl sites, analyze backlink profiles, and gather competitive intelligence with
searchatlas_site_explorerGoogle Business Profile Management – Manage listings, reviews, and local SEO via
searchatlas_gbpLink Building & Digital PR – Run outreach, guest posting, and authority-building campaigns with
searchatlas_authority_buildingLLM Brand Monitoring – Track how AI models reference your brand and competitors using
searchatlas_llm_visibilityKeyword Research – Analyze search volume, difficulty, SERP data, and clustering with
searchatlas_keywordsWebsite Building – Create and edit pages, layouts, and site structure via
searchatlas_website_studioProject Management – List and create SearchAtlas projects with
searchatlas_list_projectsandsearchatlas_create_projectConversation & Artifact Management – Browse past sessions and access generated code, content, and reports with
searchatlas_list_conversationsandsearchatlas_list_artifactsPlaybook Automation – Discover and execute pre-built automation recipes using
searchatlas_list_playbooksandsearchatlas_run_playbookPlan Mode – Enable step-by-step proposal mode before execution on any agent for safer, reviewable workflows
Provides tools for managing Google Business Profiles, local SEO optimization, and analyzing search engine results (SERP) for keyword insights.
Enables management and performance tracking of Google Ads campaigns, including bid adjustments.
SearchAtlas MCP Server
npm · MCP Registry · GitHub
Connect any MCP-compatible AI client to the SearchAtlas v2 MCP server — 500+ tools covering OTTO SEO, PPC, Content Genius, Site Explorer, Google Business Profile, Local SEO, Link Laboratory, Digital PR, LLM Visibility, keyword research, and more.
This package runs as a thin stdio bridge to the hosted v2 MCP server at https://mcp.searchatlas.com/mcp/ so it works with clients that only speak stdio. Clients with native Streamable-HTTP support can connect to the remote endpoint directly.
Works with Claude Code, Cursor, Claude Desktop, VS Code, Windsurf, and Zed.
Setup (3 steps)
1. Install & log in
With npm:
npm install -g searchatlas-mcp-server
searchatlas loginWith yarn:
yarn global add searchatlas-mcp-server
searchatlas loginWith pnpm:
pnpm add -g searchatlas-mcp-server
searchatlas loginWithout installing (npx):
npx searchatlas-mcp-server loginThis opens your browser. After logging in:
Press F12 (or Cmd+Option+I on Mac) to open DevTools
Go to Console tab
Run:
localStorage.getItem("token")Copy the result and paste it into the terminal
The CLI validates your token, saves it, and prints ready-to-paste configs with your paths auto-detected.
2. Add to your MCP client
Claude Code
macOS / Linux:
claude mcp add searchatlas -e SEARCHATLAS_TOKEN=your-token -- npx -y searchatlas-mcp-serverWindows (PowerShell):
claude mcp add searchatlas -e SEARCHATLAS_TOKEN=your-token -- npx.cmd -y searchatlas-mcp-serverWindows note: You must use
npx.cmdinstead ofnpx. This is because Claude Code spawns processes directly and Windows requires the.cmdextension.
Done. That's it.
Cursor
Create .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):
{
"mcpServers": {
"searchatlas": {
"command": "/opt/homebrew/bin/node",
"args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
"env": {
"SEARCHATLAS_TOKEN": "your-token"
}
}
}
}Your paths may differ. Run
which nodeandnpm root -gto find them, or just copy the config thatsearchatlas loginprinted — it has your exact paths.
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"searchatlas": {
"command": "/opt/homebrew/bin/node",
"args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
"env": {
"SEARCHATLAS_TOKEN": "your-token"
}
}
}
}Restart Claude Desktop after saving.
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"searchatlas": {
"command": "/opt/homebrew/bin/node",
"args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
"env": {
"SEARCHATLAS_TOKEN": "your-token"
}
}
}
}Add to .vscode/mcp.json in your project:
{
"servers": {
"searchatlas": {
"command": "/opt/homebrew/bin/node",
"args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
"env": {
"SEARCHATLAS_TOKEN": "your-token"
}
}
}
}Add to Zed settings.json:
{
"context_servers": {
"searchatlas": {
"command": {
"path": "/opt/homebrew/bin/node",
"args": ["/opt/homebrew/lib/node_modules/searchatlas-mcp-server/dist/index.js"],
"env": {
"SEARCHATLAS_TOKEN": "your-token"
}
}
}
}
}3. Verify
searchatlas check SearchAtlas MCP Server — Health Check
✓ Credential source: ~/.searchatlasrc
✓ Config loaded successfully (endpoint: https://mcp.searchatlas.com/mcp)
✓ JWT structure valid (expires in 12 days) — user 42
✓ MCP handshake succeeded — 587 tools available
All checks passed — you're ready to go!Related MCP server: MCP by Amal Alexander
Why full paths?
macOS GUI apps (Cursor, Claude Desktop, VS Code, Windsurf, Zed) don't inherit your shell's PATH, so they can't find node or npx. Using the full path to node and pointing it directly at the installed package avoids spawn npx ENOENT and env: node: No such file errors entirely.
searchatlas login detects your paths automatically and prints configs you can copy-paste.
How to find your paths | Command |
Full path to |
|
Global npm modules dir |
|
Usage
Just talk naturally. The AI picks the right tool:
"What are the top SEO issues for my site?"
"Run a technical SEO audit on example.com"
"Write a blog post about technical SEO best practices"
"Find long-tail keywords for project management software"
"List my projects"
"Show available playbooks and run one"CLI Commands
Command | Description |
| Log in, save token, print MCP configs |
| Validate credentials + API connectivity |
| Print version |
| Show help |
All commands also work via
npx searchatlas-mcp-server <command>.
Tools
Tools are discovered dynamically from the hosted v2 MCP server — your client sees the live catalogue (currently ~587 tools) without needing a package update when new ones ship. The major groups:
Prefix | Area | Representative tools |
| OTTO SEO automation (70 tools) |
|
| Google Ads / PPC (76 tools) |
|
| Content Genius (74 tools) |
|
| Site Explorer (46 tools) |
|
| Google Business Profile (96 tools) |
|
| Local SEO heatmaps (19 tools) |
|
| Link Laboratory (24 tools) |
|
| Digital PR (20 tools) |
|
| LLM Visibility (30 tools) |
|
| Keyword Rank Tracking (16 tools) |
|
| Brand Vault (25 tools) |
|
| Website Studio (8 tools) |
|
| Google Search Console (11 tools) |
|
| Social Hub (19 tools) |
|
| Content Strategy (12 tools) |
|
| Knowledge Graph (7 tools) |
|
| Domain Knowledge Network (7 tools) |
|
| Indexer (6 tools) |
|
| Report Builder (3 tools) |
|
| Press Release (14 tools) |
|
Run searchatlas check to see the live count, or ask your MCP client to list tools after connecting.
Configuration
Token priority (first match wins)
SEARCHATLAS_TOKENenv varSEARCHATLAS_API_KEYenv var~/.searchatlasrcfile (created bysearchatlas login)
Environment variables
Variable | Required | Description |
| Yes | JWT token from SearchAtlas |
| Alternative | API key auth |
| No | Custom v2 MCP endpoint (default: |
Native Streamable-HTTP clients
If your MCP client supports Streamable HTTP directly, you can skip this npm package and connect to the remote server in one step:
URL:
https://mcp.searchatlas.com/mcp/Transport: Streamable HTTP (JSON-RPC + SSE)
Header:
Authorization: Bearer <SEARCHATLAS_TOKEN>
Troubleshooting
Error | Fix |
| Use full paths (see Why full paths?) or re-run |
| Use |
| Run |
| Run |
| Token expired — run |
| Check network; run |
Tools not showing up | Restart your MCP client after adding config |
Still stuck? Run searchatlas check, make sure Node.js >= 18 (node --version), or open an issue.
Development
git clone https://github.com/Search-Atlas-Group/searchatlas-mcp-server.git
cd searchatlas-mcp-server
npm install && npm run buildTest with MCP Inspector:
npx @modelcontextprotocol/inspector npx searchatlas-mcp-serverRequirements
Node.js >= 18
A SearchAtlas account — sign up here
License
MIT
Available Tools
16 toolssearchatlas_authority_buildingC
Link building and digital PR — outreach, guest posts, and authority signals
Inputs: message (required), project_id, playbook_id, plan_mode.
searchatlas_contentC
AI content generation — blog posts, landing pages, and optimized copy
Inputs: message (required), project_id, playbook_id, plan_mode.
searchatlas_create_projectC
Create a new SearchAtlas project
Inputs: domain (required), country_code.
searchatlas_gbpC
Google Business Profile management — listings, reviews, and local SEO
Inputs: message (required), project_id, playbook_id, plan_mode.
searchatlas_keywordsC
Keyword research — search volume, difficulty, SERP analysis, and clustering
Inputs: message (required), project_id, playbook_id, plan_mode.
searchatlas_list_artifactsC
List artifacts (code, content, reports) across all sessions
Inputs: page, page_size, type, search, +1 more.
searchatlas_list_conversationsB
List conversation sessions, optionally filtered by agent
Inputs: agent_namespace, page, page_size, search.
searchatlas_list_playbooksB
List available playbooks (automation recipes), optionally filtered by agent or ownership
Inputs: filter, agent_namespace, search, page, +1 more.
searchatlas_list_projectsB
List SearchAtlas projects for the authenticated user
Inputs: page, page_size, search.
searchatlas_llm_visibilityC
LLM brand monitoring — tracks how AI models reference your brand and competitors
Inputs: message (required), project_id, playbook_id, plan_mode.
searchatlas_orchestratorB
Multi-agent coordinator — routes queries to the best specialized agent (SEO, content, PPC, etc.)
Inputs: message (required), project_id, playbook_id, plan_mode.
searchatlas_otto_seoC
On-page SEO automation — deploys technical fixes, schema markup, and content optimizations
Inputs: message (required), project_id, playbook_id, plan_mode.
searchatlas_ppcC
PPC / Google Ads management — campaign creation, bid strategy, and performance analysis
Inputs: message (required), project_id, playbook_id, plan_mode.
searchatlas_run_playbookC
Execute a playbook (automation recipe) on a project using the appropriate agent
Inputs: playbook_id (required), project_id (required), message, agent_namespace.
searchatlas_site_explorerC
Site audit and analysis — crawl data, backlink profiles, and competitive intelligence
Inputs: message (required), project_id, playbook_id, plan_mode.
searchatlas_website_studioC
Website builder — creates and edits pages, layouts, and site structure
Inputs: message (required), project_id, playbook_id, plan_mode.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Most tools have distinct purposes targeting specific SEO and marketing domains (e.g., keywords, content, PPC), but there is some overlap in scope between 'searchatlas_site_explorer' (site audit) and 'searchatlas_otto_seo' (on-page SEO), which could cause confusion as both involve site analysis and optimization. The descriptions help clarify, but boundaries are not perfectly sharp.
All tool names follow a consistent 'searchatlas_' prefix with snake_case and clear verb_noun patterns (e.g., 'searchatlas_create_project', 'searchatlas_list_projects'), making them predictable and easy to parse. There are no deviations in naming conventions across the set.
With 16 tools, the count is slightly high but reasonable for a comprehensive SEO and marketing platform, covering areas like content, keywords, PPC, and site management. It feels a bit heavy but not excessive, as each tool appears to serve a distinct function within the broad domain.
The tool set provides broad coverage for SEO and marketing tasks, including project management, content generation, keyword research, and automation. Minor gaps exist, such as no explicit tools for deleting projects or managing user settings, but core workflows are well-supported, and agents can likely work around these omissions.
Maintenance
Related MCP Connectors
Hosted MCP server for marketing agencies: connect Google Ads, GA4, Search Console, Meta, LinkedIn and more to Claude or ChatGPT. Pull reports and make changes via OAuth login, no setup.
Remote MCP server that gives Claude, ChatGPT, Cursor or any MCP client Google search volume, CPC, competition and similar keywords for 50+ countries. Works with no signup at 20 lookups a day; sign in with OAuth or an API key for higher limits, or $4.99 a month for unlimited.
Meta Ads and Google Ads MCP server: 250+ tools for Claude, ChatGPT, Cursor and Codex.
Google Search Console, GA4 and PageSpeed MCP server for Claude, ChatGPT and Cursor. Free, hosted.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server that enables AI assistants to perform SEO automation tasks including keyword research, SERP analysis, and competitor analysis through Google Ads API integration.1ISC
- AlicenseNot gradedqualityCmaintenanceAn MCP server that connects AI assistants to SEO platforms like Google Search Console, GA4, Bing Webmaster Tools, and Adobe Analytics, enabling natural language queries about SEO performance.1,377 npmMIT
- AlicenseBqualityDmaintenanceProfessional Google Search Console MCP server providing 40+ SEO tools for performance analysis, content decay, CTR opportunities, and more, enabling real search data in clients like Cursor and Claude.4021 npm6MIT
- AlicenseBqualityDmaintenanceAn MCP server that gives AI assistants 23 SEO tools for rank tracking, Google Analytics, site audits, keyword research, competitive analysis, and more, accessible through natural language.2512MIT