Title100/100
List posts
The title clearly communicates the tool’s action and subject. Keep it concise.
Description69/100
List posts filtered by status, social accounts, or tags, with pagination
Describe the returned information so the agent knows whether it will answer the request.
Inputs65/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
status
Filter by post status
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
limit
Number of posts to return (1-100, default 100)
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
page
Page number for pagination
Explain what happens when this optional value is omitted.
tagIds
Filter by tag IDs
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
socialAccountIds
Filter by social account IDs
Clarify units, where to obtain this value, or conventions not already expressed in the schema.
Annotations75/100
Declare idempotentHint based on the tool’s actual behavior.
{
"title": "List posts",
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}Output schema52/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"required": [
"posts"
],
"properties": {
"page": {
"type": "number"
},
"posts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"caption",
"status",
"socialAccountId"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
]
},
"tags": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"color"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"color": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"updatedAt": {
"type": "string"
}
},
"additionalProperties": true
}
},
"media": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": true
}
},
"status": {
"type": "string"
},
"caption": {
"type": "string"
},
"createdAt": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"externalId": {
"type": [
"string",
"null"
]
},
"scheduledAt": {
"type": [
"string",
"null"
]
},
"socialAccount": {
"type": "object",
"additionalProperties": true
},
"approvalStatus": {
"type": "string"
},
"socialAccountId": {
"type": "string"
},
"platformConfiguration": {
"type": [
"object",
"null"
],
"additionalProperties": true
}
},
"additionalProperties": true
}
},
"total": {
"type": "number"
},
"totalPages": {
"type": "number"
}
},
"additionalProperties": true
}