Keywords Everywhere MCP Server

A Model Context Protocol (MCP) server that provides access to the Keywords Everywhere API for SEO research and keyword analysis. This server enables AI assistants like Claude to perform keyword research, analyze search volumes, get competition data, and access various SEO metrics.

Do note that this is NOT an official MCP server by Keywords Everywhere.

Features

• Keyword Data Analysis: Get search volume, CPC, and competition data for keywords
• Related Keywords: Find related keywords and "People Also Search For" suggestions
• Domain Analysis: Analyze what keywords a domain or URL ranks for
• Traffic Metrics: Get traffic estimates and costs for domains and URLs
• Backlink Analysis: Retrieve backlink data for domains and pages
• Account Management: Check your Keywords Everywhere credit balance
• Multi-Country Support: Analyze keywords across different countries and currencies

Installation

Prerequisites

• Node.js 16.0.0 or higher
• A Keywords Everywhere API key (get one from Keywords Everywhere)

Quick Installation (NPX)

The easiest way to use this MCP server is with npx:

npx mcp-keywords-everywhere

Global Installation

npm install -g mcp-keywords-everywhere

Smithery Installation

You can also use this MCP server through Smithery:

1. Connect to the server using the Smithery URL:

   server.smithery.ai/@hithereiamaliff/mcp-keywords-everywhere
   

2. Smithery works with any streamable HTTP transport compatible client including:

   • Claude Desktop
   • Claude Code
   • Gemini CLI
   • Raycast
   • Cursor
   • VS Code
   • And many more

For more information, visit Smithery.

Configuration

For Claude Desktop

Add the following to your Claude Desktop configuration file:

Location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "keywords-everywhere": {
      "command": "npx",
      "args": ["-y", "mcp-keywords-everywhere"],
      "env": {
        "KEYWORDS_EVERYWHERE_API_KEY": "your_api_key_here"
      }
    }
  }
}

For Other MCP Clients

If you're using other MCP clients, you can run the server directly:

KEYWORDS_EVERYWHERE_API_KEY=your_api_key_here npx mcp-keywords-everywhere

Available Tools

Account Management

• get_credits - Check your account's credit balance
• get_countries - Get list of supported countries
• get_currencies - Get list of supported currencies

Keyword Research

• get_keyword_data - Get volume, CPC, and competition data for keywords
• get_related_keywords - Find related keywords based on a seed keyword
• get_pasf_keywords - Get "People Also Search For" keywords

Domain Analysis

• get_domain_keywords - Get keywords that a domain ranks for
• get_url_keywords - Get keywords that a specific URL ranks for
• get_domain_traffic - Get traffic metrics for a domain
• get_url_traffic - Get traffic metrics for a URL

Backlink Analysis

• get_domain_backlinks - Get backlinks for a domain
• get_unique_domain_backlinks - Get unique domain backlinks
• get_page_backlinks - Get backlinks for a specific page
• get_unique_page_backlinks - Get unique backlinks for a page

Usage Examples

Basic Keyword Research

"Get keyword data for 'SEO tools' and 'keyword research' for Malaysia"

Domain Analysis

"What keywords does example.com rank for?"

Traffic Analysis

"Get traffic metrics for https://example.com"

Backlink Research

"Show me the top 20 backlinks for example.com"

API Key Setup

1. Sign up at Keywords Everywhere
2. Purchase credits for API access
3. Get your API key from the dashboard
4. Add the API key to your environment variables or MCP configuration

Error Handling

The server includes comprehensive error handling:

• Authentication errors: Clear messages for invalid API keys
• Credit exhaustion: Helpful messages when credits run out
• Rate limiting: Automatic retry with exponential backoff
• Bad requests: Detailed error messages with suggestions

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see the LICENSE file for details.

Support

• GitHub Issues: Report bugs or request features
• Keywords Everywhere API: Official documentation

Development and Deployment

This MCP server uses TypeScript with Smithery CLI for development and deployment. The TypeScript Smithery CLI approach is the recommended migration path for MCP servers, providing built-in development tools, automatic deployment, and containerization with minimal configuration.

Prerequisites

• Node.js 18+ installed
• Keywords Everywhere API key

Project Structure

mcp-keywords-everywhere/
├── src/
│   └── index.ts          # Main server file with createServer export
├── package.json          # Updated with Smithery CLI scripts
├── smithery.yaml         # Smithery runtime configuration
├── tsconfig.json         # TypeScript configuration
└── README.md             # Documentation

Local Development

# Install dependencies
npm install

# Start development server
npm run dev

The development server will provide a link to the Smithery playground for testing. The playground allows you to interact with your MCP server and test all available tools.

Building for Production

# Build the server
npm run build

# Push changes to GitHub for automatic deployment
git push

Smithery will automatically detect changes and deploy your server. You can also manually trigger deployment from your Smithery server dashboard.

Transport Support

This MCP server uses the Streamable HTTP Transport, which is the recommended transport for production use, offering improved scalability, concurrency, and latency compared to STDIO transport.

For detailed information about the migration from STDIO to TypeScript Smithery CLI with HTTP transport, see MIGRATION.md.

Key Benefits

• Simplified Development: Built-in development tools with hot reloading
• Automatic Deployment: Push to GitHub and Smithery handles the rest
• No Dockerfile Needed: Smithery CLI handles containerization
• Type Safety: Full TypeScript support with proper type checking
• Better Performance: HTTP transport offers improved scalability and latency

Changelog

2.0.0

• Migrated to TypeScript Smithery CLI architecture
• Converted codebase to TypeScript with proper types
• Updated project structure to follow Smithery CLI best practices
• Added tsconfig.json for TypeScript configuration
• Enhanced error handling and response formatting
• Improved development experience with hot reloading

1.1.0

• Migrated from STDIO to Streamable HTTP transport
• Added support for both transport types
• Added smithery.yaml configuration
• Improved session management
• Enhanced error handling

1.0.0

• Initial release
• Support for all major Keywords Everywhere API endpoints
• Comprehensive error handling and retry logic
• MCP protocol compliance
• Cross-platform compatibility

Related

• Model Context Protocol
• Keywords Everywhere
• Claude Desktop