Tool

Update competitors

Use to add creators to or remove them from the workspace's competitor list in one call. Add by profile link or platform and handle; new competitors are on the list as soon as the call returns, get their first check within minutes, and are checked daily after that. Each successful check costs credits: 10 for the first, then 2 per check, and nothing for creators the workspace already tracks in Creator Tracking. Removing stops its checks, so nothing more is charged for it.

POSTtools.writeFree

POST/openapi/v1/tools/update_competitors

Call it

curl -X POST https://api.cuekoo.com/openapi/v1/tools/update_competitors \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"add":[],"remove":[]}'

The MCP tool is named cuekoo_update_competitors. Arguments and results are identical to the REST call.

Arguments

Send a JSON object with these fields. Scope: tools.write.

Name	Type	Required
`add`	`object[] \| null`	Required
`add[].account`	`string`	Required
`add[].platform`	`string`	Optional
`remove`	`string[] \| null`	Required

Response

Name	Type	Required
`added`	`object[] \| null`	Required
`added[].handle`	`string`	Required
`added[].platform`	`string`	Required
`already_listed`	`object[] \| null`	Required
`already_listed[].handle`	`string`	Required
`already_listed[].platform`	`string`	Required
`credits`	`object`	Required
`credits.first_check`	`integer`	Required
`credits.monthly_estimate`	`integer`	Required
`credits.per_check`	`integer`	Required
`credits.remaining`	`integer`	Required
`removed`	`string[] \| null`	Required

A call returns the Tool's output object at HTTP 200. Failures use the error envelope.

Credits

This Tool is free. It does not reserve or spend credits.