MCP Server Configuration

Customize the Rampify MCP server to fit your workflow with these configuration options.

Environment Variables

The MCP server supports the following environment variables:

RAMPIFY_API_KEY (Required)

Your Rampify API key for authentication.

RAMPIFY_API_KEY=sk_live_abc123...

Generate your API key in the dashboard settings.

RAMPIFY_API_URL (Optional)

Override the default API endpoint. Useful for testing or self-hosted deployments.

RAMPIFY_API_URL=https://api.rampify.ai

Default: https://api.rampify.ai

RAMPIFY_CACHE_TTL (Optional)

Cache duration in seconds for API responses.

RAMPIFY_CACHE_TTL=300

Default: 300 (5 minutes)

Configuration File

Create a .rampify.json file in your project root for additional settings:

{
  "defaultDomain": "example.com",
  "autoScan": false,
  "notifications": {
    "criticalIssues": true,
    "warnings": false
  },
  "tools": {
    "generateMeta": {
      "maxTitleLength": 60,
      "maxDescriptionLength": 155
    }
  }
}

Configuration Options

defaultDomain

Set a default domain to use when none is specified in tool calls.

Type: string Default: null

autoScan

Automatically trigger site scans when using get_seo_context() if data is stale (> 24 hours old).

Type: boolean Default: false

notifications

Configure which types of notifications to show in your editor.

Type: object

criticalIssues (boolean) - Show alerts for critical issues
warnings (boolean) - Show alerts for warnings

tools.generateMeta

Customize meta tag generation behavior.

Type: object

maxTitleLength (number) - Maximum title length (default: 60)
maxDescriptionLength (number) - Maximum description length (default: 155)

Editor-Specific Configuration

Cursor Settings

Additional Cursor-specific settings can be added to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "rampify": {
      "command": "npx",
      "args": ["-y", "@rampify/mcp-server"],
      "env": {
        "RAMPIFY_API_KEY": "your-api-key"
      },
      "disabled": false,
      "alwaysAllow": ["get_seo_context", "scan_site"]
    }
  }
}

alwaysAllow

Tools that don't require user confirmation before execution.

Type: string[] Default: []

Claude Code Settings

For Claude Code, add to your workspace settings:

{
  "mcp": {
    "servers": {
      "rampify": {
        "command": "rampify-mcp",
        "env": {
          "RAMPIFY_API_KEY": "your-api-key"
        },
        "timeout": 30000
      }
    }
  }
}

timeout

Maximum execution time in milliseconds for MCP tool calls.

Type: number Default: 30000 (30 seconds)

Multiple Domains

If you manage multiple sites, you can configure domain-specific settings:

{
  "domains": {
    "example.com": {
      "priority": "high",
      "autoScan": true
    },
    "staging.example.com": {
      "priority": "low",
      "autoScan": false
    }
  }
}