# 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.