Title97/100
Browse latest stories
The title clearly communicates the tool’s action and subject. Keep it concise.
Description94/100
Browse the latest published stories on Distro. Optionally filter by publication (by slug or numeric ID). Returns a list of story objects with id, slug, url, and publication metadata so follow-up tools can address each story by any of those forms. For a premium result, call distro_story_read to receive the canonical HTTP 402/x402 payment instructions; feed results never include a paid body.
The description explains the capability, when to use it, and what to expect.
Inputs75/100
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
publication
Optional: filter to a publication by slug (e.g. "deai-news"). Mutually exclusive with publicationId.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
publicationId
Optional: filter to a publication by numeric ID. Mutually exclusive with publication.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
limit
Number of stories to return (default 10, max 50)
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
Annotations100/100
All four behavior hints are declared.
{
"title": "Browse latest stories",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema69/100
Describe the returned fields so an agent can interpret the result.
View output schema
{
"type": "object",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"details": {
"type": "object"
},
"message": {
"type": "string"
}
}
},
"total": {
"type": "number"
},
"stories": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"slug",
"url",
"title",
"cost",
"isPremium",
"author"
],
"properties": {
"id": {
"type": "number"
},
"url": {
"type": "string"
},
"cost": {
"type": "number"
},
"slug": {
"type": "string"
},
"title": {
"type": "string"
},
"author": {
"type": "string"
},
"authors": {
"type": "array",
"items": {
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"position": {
"type": "number"
}
}
}
},
"episode": {
"oneOf": [
{
"type": "object",
"required": [
"seriesSlug",
"canonicalUrl",
"audioUrl",
"listenUrl",
"videoUrl",
"transcriptUrl",
"transcriptHash",
"guests",
"sourceUrls",
"relatedStoryIds"
],
"properties": {
"guests": {
"type": "array",
"items": {
"type": "object"
}
},
"audioUrl": {
"type": [
"string",
"null"
]
},
"videoUrl": {
"type": [
"string",
"null"
]
},
"listenUrl": {
"type": [
"string",
"null"
]
},
"seriesSlug": {
"type": "string"
},
"sourceUrls": {
"type": "array",
"items": {
"type": "string"
}
},
"canonicalUrl": {
"type": "string"
},
"episodeNumber": {
"type": [
"number",
"null"
]
},
"transcriptUrl": {
"type": [
"string",
"null"
]
},
"transcriptHash": {
"type": [
"string",
"null"
]
},
"durationSeconds": {
"type": [
"number",
"null"
]
},
"relatedStoryIds": {
"type": "array",
"items": {
"type": "number"
}
}
}
},
{
"type": "null"
}
]
},
"preview": {
"type": "string"
},
"costToken": {
"type": "string"
},
"createdAt": {
"type": [
"string",
"null"
]
},
"isPremium": {
"type": "boolean"
},
"publication": {
"oneOf": [
{
"type": "object",
"required": [
"id",
"slug",
"name"
],
"properties": {
"id": {
"type": "number"
},
"url": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"feedUrl": {
"type": "string"
},
"shortName": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
}
}
},
{
"type": "null"
}
]
},
"publishedAt": {
"type": [
"string",
"null"
]
},
"costCurrency": {
"type": "string"
},
"chapterNumber": {
"type": [
"number",
"null"
],
"description": "Reading-order position within a book newslode; null for non-book stories"
}
}
}
}
}
}