# Rivals (`clickd_rivals`)

Updated November 12, 2026.

## What does clickd_rivals do?

Sets a site against its rivals from reads already kept: the sites near it doing similar work, the sites closest in meaning, its market rule by rule, or two sites side by side. A key may make this call on the sites it has claimed.

Listed at /mcp and /mcp/all. Its name answers a call at either address.

Who may call it: Your claimed sites.

## When to use it

- You want to know who a site is up against before choosing which fixes to make.
- You want two sites side by side, rule by rule or by what they write about.

## What you ask

You might say: “Who are example.com’s rivals, and where is it behind them?”

```
clickd_rivals({ site: "example.com" })
```

| Argument | Type | Needed | What it is |
| --- | --- | --- | --- |
| `site` | Text | Yes | The site, as a domain such as example.com. |
| `view` | One of these: competitors, near, market, rules, content | No | competitors (the default), near, market, rules or content. |
| `with` | Text | No | The other site, already read. |
| `limit` | Number | No | For near only: how many sites. 10 if left out. |

## What comes back

- By default, where the site is and its rivals near it doing similar work, each with score and pages.
- Or the sites closest in meaning, the site against its market rule by rule, or two sites rule by rule or by content.

A sample, with made-up sites and figures:

| Site | Score | Pages | Linked from |
| --- | --- | --- | --- |
| example.com | 72 | 100 | 4 sites |
| rival.example | 66 | 58 | 9 sites |
| north.example | 48 | 37 | 1 site |

A score says pages are well formed. It does not say an assistant cites the site.

## Over HTTP

```
curl "https://clickd.com/api/v1/sites/example.com/competitors" \
  -H "Authorization: Bearer $CLICKD_KEY"
```

## When it fails

| When | Status | What to do |
| --- | --- | --- |
| Your assistant has no key yet | isError over MCP | Sign up with `clickd_signup`, then connect again with the key it gives. |
| The key has not claimed the site | 404 | Claim it with `clickd_claim`, then `clickd_claim` with step check. |

## Sources

- [Model Context Protocol: tools](https://modelcontextprotocol.io/specification/2025-06-18/server/tools), Model Context Protocol: How an assistant calls a tool.

The call in full: [clickd_rivals in the API reference](https://clickd.com/docs/reference#clickd_rivals).

## Goes with

- [Leaderboard](https://clickd.com/docs/tools/leaderboard.md)
- [One site](https://clickd.com/docs/tools/site.md)