# Rivalize MCP server

> Provides AI agents with cited competitor intelligence including pricing, ads, reviews, and market momentum via JSON data.

- Repository: https://github.com/Downshift/rivalize-mcp
- Page: https://hostedmcp.org/servers/downshift/rivalize-mcp
- Transport: stdio
- Stars: 0
- License: MIT
- Latest version: 0.3.2

## Install

### Claude Code

```sh
claude mcp add --env 'RIVALIZE_API_KEY=<YOUR_RIVALIZE_API_KEY>' rivalize-mcp -- npx -y @rivalize/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "rivalize-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@rivalize/mcp"
      ],
      "env": {
        "RIVALIZE_API_KEY": "<YOUR_RIVALIZE_API_KEY>"
      }
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "rivalize-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@rivalize/mcp"
      ],
      "env": {
        "RIVALIZE_API_KEY": "<YOUR_RIVALIZE_API_KEY>"
      }
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"rivalize-mcp","type":"stdio","command":"npx","args":["-y","@rivalize/mcp"],"env":{"RIVALIZE_API_KEY":"<YOUR_RIVALIZE_API_KEY>"}}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "rivalize-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@rivalize/mcp"
      ],
      "env": {
        "RIVALIZE_API_KEY": "<YOUR_RIVALIZE_API_KEY>"
      }
    }
  }
}
```

### Codex

```sh
codex mcp add rivalize-mcp --env 'RIVALIZE_API_KEY=<YOUR_RIVALIZE_API_KEY>' -- npx -y @rivalize/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.rivalize-mcp]
command = "npx"
args = ["-y", "@rivalize/mcp"]

[mcp_servers.rivalize-mcp.env]
RIVALIZE_API_KEY = "<YOUR_RIVALIZE_API_KEY>"
```

### Gemini CLI

```sh
gemini mcp add -s user -e 'RIVALIZE_API_KEY=<YOUR_RIVALIZE_API_KEY>' rivalize-mcp npx -- -y @rivalize/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "rivalize-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@rivalize/mcp"
      ],
      "env": {
        "RIVALIZE_API_KEY": "<YOUR_RIVALIZE_API_KEY>"
      }
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `RIVALIZE_API_KEY` | yes | yes | Your Rivalize API key (rk_live_...). Create one at rivalize.ai under Settings, API Keys. Free plans get rate-limited reads. |
| `RIVALIZE_API_URL` | no | no | Origin of the Rivalize API that issued your key. Leave unset for rivalize.ai. |
| `RIVALIZE_MCP_ALLOW_WRITES` | no | no | Set to 1, true or yes to register add_competitor, which spends credits. Read-only when unset. |

## Tools (21)

- `teardown_competitor`
- `list_universe_companies`
- `get_universe_company`
- `list_projects`
- `list_reports`
- `get_report`
- `list_competitors`
- `get_competitor_intelligence`
- `get_battlecard`
- `get_strategic_timeline`
- `get_competitive_landscape`
- `get_freshness`
- `get_evidence`
- `add_competitor`
- `run_report`
- `get_report_status`
- `list_agent_competitors`
- `get_agent_competitor`
- `set_agent_competitor`
- `battlecards`
- `competitors`

## FAQ

### What information does Rivalize provide to agents?

The server provides data on competitor positioning, pricing, ads, social presence, reviews, hiring, and momentum.

### How much can I use the Agent plan?

The Agent plan includes 500 API and MCP calls per day, with a limit of 250 calls per hour.

### Is the server read-only?

Yes, the server is read-only by default, but you can enable write tools like adding competitors or running reports by setting the RIVALIZE_MCP_ALLOW_WRITES environment variable.

### Does the Agent plan include AI analysis?

No, the Agent plan provides raw data for your own AI to process; it does not include a dashboard or built-in AI analysis.
