Competitive intelligence, as an API.

The REST API, the MCP server and webhooks read the same cited data your Monday brief is built from. Included on any paid plan.

Read the API reference Get an API key

$ npx -y @rivalize/mcp

Terminal

# start a report from your stack
curl -X POST https://rivalize.ai/api/v1/reports \
  -H "Authorization: Bearer $RIVALIZE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_url":"https://yours.example",
       "competitor_urls":["https://rival.example"]}'

202Accepted: a report id. Poll /api/v1/reports/{id}

# or give Claude Code the same tools
claude mcp add rivalize \
  -e RIVALIZE_API_KEY=rk_live_... \
  -- npx -y @rivalize/mcp

POST your-app.example/hooks/rivalize 200

change.detected Ledgerly’s pricing changed

Signed in X-Rivalize-SignatureSample

Live in three steps.

1
Get a key

Create an API key in your dashboard settings. Every paid plan includes the API, the MCP server and webhooks.
Settings, then API Keys
2
Call the API, or add the MCP

Start a report from your stack, read your competitors and their changes, or give Claude and Cursor the same tools.
3
Pipe it anywhere

Send the cited results to your agent, your dashboard or a webhook consumer. Every change carries its source link.

A native MCP server. 14 tools in Claude, Claude Code or Cursor.

Add it in one line, with a key from any paid plan. Your client can then tear down a competitor, read your reports and check what changed without leaving the chat.

Claude Code

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

Claude Desktop and Cursor, the MCP config

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

Read tools, on every install

A full strategy teardown of a competitor in one call.
Search the shared company universe by keyword, category or layer.
The full profile for one domain.
Your projects, and the ids the other tools take.
Your reports, newest first.
One report as Markdown.
The competitors tracked in your account.
The latest snapshot for one tracked competitor.
The cited sales battlecard for one tracked competitor (Pro).
A receipt-linked timeline of competitor moves.
Weekly activity and importance positions.
How current your data is, per competitor.
The sources behind the facts for one subject.
Whether a report you started has finished.

Write tools, opt-in

Registered only when you start the server with RIVALIZE_MCP_ALLOW_WRITES=1.

Add competitor URLs to a project and start watching them.
Start a report. It uses credits, and asks you to confirm first.

The REST API. Everything the product knows, callable.

The full reference

Base URL: https://rivalize.ai/api
Auth: Authorization: Bearer rk_live_...
Format: JSON. A refusal names its code and, where it applies, how to upgrade.

GET /api/v1/me Your account, plan, credit use and rate limit.
GET /api/v1/projects Your projects.
GET /api/v1/competitors Every competitor you track.
GET /api/v1/competitors/:id/changes What changed on one competitor, with its sources.
GET /api/v1/competitors/:id/battlecard The cited battlecard for one competitor (Pro).
POST /api/v1/reports Start a report. Returns 202 and a report id to poll.
GET /api/v1/reports/:id A report’s status while it runs.
GET /api/v1/reports/:id/intelligence A finished report as Markdown.
POST /api/v1/dossier Start a company dossier; poll /v1/dossier/:jobId.
GET /api/v1/universe/companies Search the shared company universe.
POST /api/v1/webhooks Register a webhook. The signing secret is returned once.
GET /api/shared-reports/:token/ai A report you chose to share, as cited Markdown for your AI. The link needs no key, and you can revoke it.

Webhooks. We call you when something happens.

A report run found changes on a competitor since the last one.
A report you started has finished.
The highlights of your weekly digest.

Every change.detected and digest.weekly payload carries the source link of what it reports.

Signed: HMAC-SHA256 of the body with your webhook secret, in X-Rivalize-Signature. The event name is in X-Rivalize-Event.
Retried: 3 retries after a failed delivery, waiting longer each time from one minute. Every attempt is in the delivery log.
Tested: Send a test payload to your endpoint from the API before you rely on it.
Per plan: 1 Starter5 Growth25 Pro100 Agency

Limits. Per key, by plan.

Requests per hour for one API key, by plan
Plan	Requests an hour	What it can do
Free	100	Read access. No webhooks or report starts.
Starter	300	Reads, webhooks and report starts.
Growth	1,000	Reads, webhooks and report starts.
Pro	5,000	Reads, webhooks and report starts, and battlecards.
Agency	10,000	Reads, webhooks and report starts, and battlecards.

At most 3 reports can be started through the API per account per UTC day; reports started from the dashboard are not counted. The same report asked for twice within 10 minutes returns the run already started, and charges nothing more.

Build on the intelligence layer.

Start with your own competitors. Your first brief is ready in about seven minutes.

Test for free for 14 days Read the API reference