@higrowth/mcp-server

Connect AI assistants to HiGrowth 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 to get your MCP API key.

2. Connect to Cursor

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

{
  "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

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

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

{
  "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:

{
  "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:

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:

   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: [email protected]
• 📖 Docs: https://docs.higrowthdev.com
• 🐛 Issues: https://github.com/higrowth/mcp-server/issues