Rivalize

Rivalize MCP Server (@rivalize/mcp)

Give Claude, Cursor, Cline, or your own agent cited competitor intelligence as JSON, over the Model Context Protocol.

The Agent plan ($70 a year or $9 a month): API and MCP only, for your own AI. Rivalize collects; your own Claude, Cursor or agent does the thinking. No dashboard and no AI analysis, so it costs a few dollars.

• 3 competitors at once, refreshed every 7 days
• Everything Rivalize collects about each, as JSON, with sources and collection dates
• Reads Rivalize's database of companies already collected (list_universe_companies, get_universe_company)
• 500 API and MCP calls a day (up to 250 an hour)

Get the Agent plan at rivalize.ai/pricing. Developer and API documentation: rivalize.ai/developers.

What it does

This server connects Claude, Cursor or any other MCP client to Rivalize. Your assistant can tear down a competitor's positioning, pricing, ads, social presence, reviews, hiring and momentum in one call, search the Rivalize universe of tracked companies, and read the projects, reports, battlecards, timelines and evidence in your own Rivalize account. Every answer comes from data Rivalize has collected, with dates and sources, rather than from a model's memory.

The server is read-only by default. Three write tools, add_competitor, run_report and set_agent_competitor, are available when you opt in with RIVALIZE_MCP_ALLOW_WRITES=1. run_report starts a real report that uses your credits, so it asks you to preview first and confirm.

Quick start

Requires Node.js 22 or newer (node --version).

1. Choose a plan at rivalize.ai/pricing: the Agent plan ($70 a year or $9 a month) is built for API and MCP use. A 14-day Growth trial is arranged with the Rivalize team; see the pricing page.
2. Create an API key under Settings → API Keys in the Rivalize app. Keys start with rk_live_. A key from any plan works, including the free plan, which gets rate-limited reads.
3. Add the server to your client using one of the blocks below.

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop:

{

"mcpServers": { "rivalize": { "command": "npx", "args": ["-y", "@rivalize/mcp"], "env": { "RIVALIZE_API_KEY": "rk_live_..." } } } }

Claude Code

claude mcp add rivalize -e RIVALIZE_API_KEY=rk_live_... -- npx -y @rivalize/mcp

Cursor

Add to .cursor/mcp.json in your project, or ~/.cursor/mcp.json for all projects:

{

"mcpServers": { "rivalize": { "command": "npx", "args": ["-y", "@rivalize/mcp"], "env": { "RIVALIZE_API_KEY": "rk_live_..." } } } }

Cline

In Cline, open the MCP Servers panel, choose Configure, then Configure MCP Servers. This opens cline_mcp_settings.json. Add:

{

"mcpServers": { "rivalize": { "command": "npx", "args": ["-y", "@rivalize/mcp"], "env": { "RIVALIZE_API_KEY": "rk_live_..." } } } }

Save the file. The rivalize server appears with a green dot after about 10 to 15 seconds (the first start downloads the package). On Windows, if it does not start, use "command": "cmd" and "args": ["/c", "npx", "-y", "@rivalize/mcp"].

If you ask Cline to install it for you, point it at llms-install.md.

Any MCP client (stdio)

The server speaks MCP over stdin and stdout. Configure your client to launch:

On Windows, some clients cannot launch npx directly because it is npx.cmd. Use cmd as the command and /c npx -y @rivalize/mcp as the arguments instead.

Plans and limits

Prices and limits are always current at rivalize.ai/pricing.

Tools

Sixteen read-only tools are always available: fourteen for dashboard plans and two for Agent plans. The three write tools (add_competitor, run_report and set_agent_competitor) are registered only when RIVALIZE_MCP_ALLOW_WRITES is set to 1, true or yes; without it, they do not exist for the client.

Agent plans cannot run work that needs a model (battlecards, teardown prose, reports): the API refuses those calls with an agent_* code and the tool shows you the API's sentence unchanged. run_report and the dashboard reads are for dashboard plans; the Free and Agent plans are refused by the API with PLAN_REQUIRED or agent_model_work_not_in_plan.

project_id and competitor_id are UUIDs from list_projects and list_competitors. Tools that read your account only ever see your own data.

Report sections

get_report takes a section so your assistant can read the part a question needs instead of the whole report:

A report has only the sections it has data for; asking for any other name returns an error that lists the sections it does have. section combines with competitor, so section: "pricing" with competitor: "Acme" returns Acme's pricing. A figure the report's fabrication check could not match to a source is kept and marked (not confirmed in the pages read); a name or citation the check found to belong to another entity is taken out with its sentence, exactly as in the report.

Long responses

Every response stays under 25,000 characters, and nothing is cut silently:

• Markdown (get_report, get_strategic_timeline, get_competitive_landscape) is split into pages at section boundaries. Each page starts with Page N of M, how much remains, and the exact call for the next page.
• Lists (`list_u