Tool

List Inspo

List the posts the workspace saved to Inspo, newest first, optionally one collection or the posts in none. Numbers are as of the day each post was saved.

POSTtools.readFree

POST/openapi/v1/tools/list_inspo

Call it

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

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

Arguments

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

Name	Type	Required	Description
`collection_id`	`string`	Optional	Only this collection
`cursor`	`string`	Optional
`limit`	`integer`	Optional	1 to 50, default 20
`uncollected`	`boolean`	Optional	Only posts in no collection

Response

Name	Type	Required	Description
`items`	`object[] \| null`	Required
`items[].caption`	`string`	Required
`items[].collection_id`	`string \| null`	Required
`items[].comments`	`integer \| null`	Required
`items[].cover_url`	`string`	Required
`items[].creator_handle`	`string`	Required
`items[].id`	`string`	Required
`items[].likes`	`integer \| null`	Required
`items[].outlier_score`	`number \| null`	Required
`items[].platform`	`string`	Required
`items[].pool_post_id`	`string \| null`	Required
`items[].post_id`	`string`	Required
`items[].published_at`	`string \| null`	Required
`items[].saved_at`	`string`	Required
`items[].source`	`string`	Required
`items[].url`	`string`	Required
`items[].views`	`integer \| null`	Required	At save; never refreshed
`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.