Tool

List competitors

Use to see the workspace's competitor list: each competitor's platform, handle, display name, bio, avatar, check cadence, state and last check, plus what the list costs in credits per month and how many credits are left. Reads saved workspace data only.

POSTtools.readFree

POST/openapi/v1/tools/list_competitors

Call it

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

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

Arguments

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

Name	Type	Required
`platform`	`string`	Optional

Response

Name	Type	Required
`credits`	`object`	Required
`credits.first_check`	`integer`	Required
`credits.monthly_estimate`	`integer`	Required
`credits.per_check`	`integer`	Required
`credits.remaining`	`integer`	Required
`items`	`object[] \| null`	Required
`items[].added_at`	`string`	Required
`items[].avatar_url`	`string`	Optional
`items[].billed`	`boolean`	Required
`items[].bio`	`string`	Optional
`items[].cadence`	`string`	Required
`items[].display_name`	`string`	Optional
`items[].followers`	`integer \| null`	Required
`items[].handle`	`string`	Required
`items[].id`	`string`	Required
`items[].last_checked_at`	`string \| null`	Required
`items[].platform`	`string`	Required
`items[].state`	`string`	Required
`max_competitors`	`integer`	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.