# propose_competitor

Proposes a change. Propose adding a competitor domain to this asset's tracked set. QUEUES A REQUEST FOR HUMAN APPROVAL; it does not add the competitor. Returns applied:false and a change-request id.

## When to use it

- Use it when: The user asked to track a specific competitor domain, and list_competitors shows it is not tracked yet.
- Not when: You are guessing who the competitors might be.

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| assetId | string | yes | The Visibility Asset UUID this concerns. |
| domain | string | yes | The competitor hostname, e.g. example.com. |
| reason | string | no | Why this competitor is relevant. Shown to the approver. |

## What comes back

| Field | Meaning |
| --- | --- |
| dataStatus | Always queued. A person decides; nothing has changed. |
| status | Always pending_human_approval. Nothing has happened yet. |
| applied | Always false. This is the field an agent would have to lie about to misreport the call. |
| changeRequestId | The queued request, which get_measurement_status lists under pendingChangeRequests until a person decides. |
| hostname | The site the request concerns. |
| proposed | What was proposed, in one phrase. |
| message | Where a person approves it. Repeat this to the user rather than saying the change was made. |

## This does not change anything

It queues a change request for a human on the account to approve. Nothing is added, removed or measured until someone says yes, and the request records which credential asked. An agent cannot act on your account by itself.

## Example request

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "propose_competitor",
    "arguments": {
      "assetId": "<assetId from list_assets>",
      "domain": "<domain>",
      "reason": "<reason>"
    }
  }
}
```

Every result carries `dataStatus: queued`: a person decides, nothing has changed.

## Example prompt

> Propose tracking example.com as a competitor of my site, and tell me it is waiting for my approval.

## Calling it

Connect the MCP server at `https://app.seoaio.ai/api/mcp` over the Streamable HTTP transport. Per-customer
authentication is required, so nothing is exposed without it. Call `list_assets` first:
every other tool needs an `assetId` from it. A proposal is approved or rejected by a
person at `https://app.seoaio.ai/dashboard/requests`.

## Next

- [get_measurement_status](https://seoaio.ai/docs/tools/get_measurement_status/md)
- [list_competitors](https://seoaio.ai/docs/tools/list_competitors/md)

## More

- The skill, which carries the call order and the rules for quoting a number: https://seoaio.ai/SKILL.md
- Troubleshooting: https://seoaio.ai/docs/troubleshooting
- This page as HTML: https://seoaio.ai/docs/tools/propose_competitor