MCP Server Installation

The Rampify MCP server brings SEO intelligence directly into your AI coding tools (Cursor, Claude Code, and any MCP-compatible client).

Prerequisites

  • Node.js 18+ installed
  • An active Rampify account
  • Your Rampify API key (generate one here)

Installation

Global Installation (Recommended)

Install the MCP server globally using npm:

npm install -g @rampify/mcp-server

Local Installation

Alternatively, install it locally in your project:

npm install --save-dev @rampify/mcp-server

Configuration

For Cursor

Add the following to your Cursor MCP settings (~/.cursor/config.json):

{
  "mcpServers": {
    "rampify": {
      "command": "npx",
      "args": ["-y", "@rampify/mcp-server"],
      "env": {
        "BACKEND_API_URL": "https://www.rampify.dev",
        "API_KEY": "sk_live_your_api_key_here",
        "SEO_CLIENT_DOMAIN": "your-domain.com"
      }
    }
  }
}

For Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "rampify": {
      "command": "npx",
      "args": ["-y", "@rampify/mcp-server"],
      "env": {
        "BACKEND_API_URL": "https://www.rampify.dev",
        "API_KEY": "sk_live_your_api_key_here",
        "SEO_CLIENT_DOMAIN": "your-domain.com"
      }
    }
  }
}

Get Your API Key

  1. Log in to your Rampify dashboard
  2. Navigate to Settings → API Keys
  3. Click "Generate New Key"
  4. Give it a descriptive name (e.g., "MacBook Pro")
  5. Copy the key immediately (it won't be shown again)

Verify Installation

To verify the MCP server is working:

  1. Restart your editor
  2. Open a new chat/session
  3. Try using a Rampify tool:
What SEO issues does my site have?
Check this page's SEO

You should see real-time SEO data returned from your Rampify account.

Troubleshooting

"Command not found" error

If you get a "command not found" error, ensure the npm global bin directory is in your PATH:

npm config get prefix

Add /bin to the returned path and ensure it's in your $PATH environment variable.

"Authentication failed" error

Double-check that:

  • Your API key is correct (starts with sk_live_)
  • The key hasn't been revoked
  • You're using the correct environment variable names (API_KEY and BACKEND_API_URL)
  • The BACKEND_API_URL is set to https://www.rampify.dev

"Connection timeout" error

Ensure you have a stable internet connection and that Rampify's servers are accessible from your network.

Next Steps