npm package: @higrowth/mcp-server
Description: MCP server for HiGrowth SEO platform - connect AI assistants to SEO tools
Author: HiGrowth
Latest version: 1.0.5

# @higrowth/mcp-server

Connect AI assistants to [HiGrowth](https://higrowthdev.com) SEO tools via the Model Context Protocol (MCP).

## Features

- 🔍 **Discover Opportunities** - Find SEO optimization opportunities
- 💡 **Keyword Ideas** - Generate keyword variations and ideas
- 📝 **Content Planning** - Create comprehensive content strategies
- ✍️ **Content Generation** - Generate SEO-optimized content
- 🔬 **Content Reviews** - Review content for SEO quality
- 📊 **Page Analysis** - Analyze page performance
- 🛠️ **Optimization Fixes** - Get specific optimization recommendations
- 📈 **Keyword Data** - Get keyword performance metrics

## Quick Start

### 1. Get Your API Key

Sign up at [higrowthdev.com](https://higrowthdev.com) to get your MCP API key.

### 2. Connect to Cursor

Add this to your `.mcp.json` file (usually in your project root or `~/.cursor/`):

```json
{
  "mcpServers": {
    "higrowth": {
      "command": "npx",
      "args": ["-y", "@higrowth/mcp-server"],
      "env": {
        "HIGROWTH_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

### 3. Restart Cursor

Restart Cursor to load the MCP server. You should see "higrowth" in your available tools.

## Usage

Once connected, you can ask your AI assistant questions like:

- "Find SEO opportunities for my site"
- "Generate keyword ideas for 'cloud computing'"
- "Create a content plan for 'kubernetes best practices'"
- "Analyze the page at https://example.com/blog/post"
- "What optimization fixes should I make?"

## Available Tools

| Tool | Description |
|------|-------------|
| `discover_opportunities` | Discover SEO optimization opportunities |
| `list_opportunities` | List existing opportunities with filters |
| `suggest_keyword_ideas` | Generate keyword variations from a seed |
| `create_content_plan` | Create content strategy and outlines |
| `generate_content` | Generate full SEO-optimized content |
| `run_content_reviews` | Run SEO and quality reviews |
| `analyze_page` | Analyze a page for SEO performance |
| `get_optimization_fixes` | Get specific optimization recommendations |
| `get_task_status` | Check status of async operations |
| `get_page_keyword_data` | Get keyword performance metrics |
| `search_page_keywords` | Semantic search for keywords |

## Configuration Options

### Command Line

```bash
npx @higrowth/mcp-server --api-key=YOUR_KEY
npx @higrowth/mcp-server --api-key=YOUR_KEY --url=https://custom.api.com/api/v1/mcp
```

### Environment Variables

```bash
export HIGROWTH_API_KEY=your_api_key
export HIGROWTH_MCP_URL=https://api.higrowthdev.com/api/v1/mcp  # optional

npx @higrowth/mcp-server
```

### Cursor Configuration with Environment Variables

```json
{
  "mcpServers": {
    "higrowth": {
      "command": "npx",
      "args": ["-y", "@higrowth/mcp-server"],
      "env": {
        "HIGROWTH_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

## Self-Hosted / Enterprise

For self-hosted HiGrowth installations, specify your custom API URL:

```json
{
  "mcpServers": {
    "higrowth": {
      "command": "npx",
      "args": ["-y", "@higrowth/mcp-server"],
      "env": {
        "HIGROWTH_API_KEY": "YOUR_API_KEY",
        "HIGROWTH_MCP_URL": "https://your-api.company.com/api/v1/mcp"
      }
    }
  }
}
```

## Programmatic Usage

You can also use the server programmatically:

```javascript
import { MCPServer } from '@higrowth/mcp-server';

const server = new MCPServer(
  'https://api.higrowthdev.com/api/v1/mcp',
  'your-api-key'
);

await server.start();
```

## Troubleshooting

### Server not appearing in Cursor

1. Ensure your `.mcp.json` is valid JSON
2. Restart Cursor completely (Cmd/Ctrl+Q, then reopen)
3. Check Cursor's developer console for errors (Help → Toggle Developer Tools)

### Authentication errors

1. Verify your API key is correct
2. Test the connection directly:
   ```bash
   curl https://api.higrowthdev.com/api/v1/mcp/tools \
     -H "X-API-Key: YOUR_KEY"
   ```

### Connection timeouts

1. Check your network connection
2. Verify the API URL is accessible
3. For enterprise installations, check firewall rules

## Requirements

- Node.js 18.0.0 or higher
- Valid HiGrowth API key

## License

MIT

## Support

- 📧 Email: support@higrowthdev.com
- 📖 Docs: https://docs.higrowthdev.com
- 🐛 Issues: https://github.com/higrowth/mcp-server/issues