Tool

List my posts

Use to review a connected account's published posts, engagement and performance against its own baseline. Reads stored data only.

POSTtools.readFree

POST/openapi/v1/tools/list_my_posts

Call it

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

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

Arguments

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

Name	Type	Required
`channel_id`	`string`	Required
`cursor`	`string`	Optional
`from`	`string`	Optional
`limit`	`integer`	Optional
`sort`	`string`	Optional
`to`	`string`	Optional

Response

Name	Type	Required
`items`	`object[] \| null`	Required
`items[].caption`	`string`	Required
`items[].engagement_rate`	`number \| null`	Required
`items[].format`	`string`	Required
`items[].metrics`	`object`	Required
`items[].metrics.comments`	`integer \| null`	Required
`items[].metrics.likes`	`integer \| null`	Required
`items[].metrics.saves`	`integer \| null`	Required
`items[].metrics.shares`	`integer \| null`	Required
`items[].metrics.views`	`integer \| null`	Required
`items[].multiple`	`number \| null`	Required
`items[].post_id`	`string`	Required
`items[].published_at`	`string`	Required
`items[].url`	`string`	Required
`next_cursor`	`string`	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.