# kwrds.ai MCP Server

<img src="claude_mcp_kwrdds_ai_client.png" alt="Claude MCP kwrds.ai Client" width="70%" />

Model Context Protocol server for [kwrds.ai](https://www.kwrds.ai) keyword research and SEO tools. You can read more about the MCP protocol [in this blog post](https://www.kwrds.ai/blog/kwrds-ai-mcp).

## Setup

**Requires Python 3.11+**

1. **Get API key** from [kwrds.ai](https://www.kwrds.ai/api/documentation/API_Key_Setup)

2. **Clone and setup**:
   ```bash
   git clone https://github.com/yourusername/kwrds-ai-mcp
   cd kwrds-ai-mcp
   python3 -m venv venv
   source venv/bin/activate
   pip install -r requirements.txt
   ```

3. **Add to Claude Desktop config** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
   ```json
   {
     "mcpServers": {
       "kwrds-ai": {
         "command": "/ABSOLUTE/PATH/TO/kwrds-ai-mcp/venv/bin/python",
         "args": ["/ABSOLUTE/PATH/TO/kwrds-ai-mcp/run_server.py"],
         "env": {
           "KWRDS_AI_API_KEY": "your-api-key-here"
         }
       }
     }
   }
   ```

   **Replace `/ABSOLUTE/PATH/TO/kwrds-ai-mcp/` with your actual project path** (use `pwd` to get it)

4. **Restart Claude Desktop**

## Usage

Ask your MCP Client:
- Find keywords for 'digital marketing' in the US
- Get People Also Ask questions for 'SEO tools'
- Generate an SEO outline for 'best laptops'
- Get best keywords for 'best laptops 2025'
- Get 7W1H for 'best AI tools'
- What does example.com rank for?

## Tools Available

- Keyword research with volumes & competition
- Topic research
- SERP analysis & ranking data
- People Also Ask questions
- AI content generation
- URL ranking analysis
- Usage statistics

## Support

Visit [kwrds.ai](https://www.kwrds.ai) for documentation, support, and more.