Server description (copied; language not verified)
Search published research posts associated with one or more research entities.
This tool requires research entity UUIDs. If only entity names are known, first call search_research_entities to obtain candidate research entities and their UUIDs.
Use only entity_uuid values copied exactly from search_research_entities results. Never infer, guess, construct, or transform UUIDs from entity names.
Use this tool only after selecting the most appropriate research entity from the search_research_entities results.
Examples:
- To find research about "United States", first call search_research_entities with "United States", review the returned matches, select the most appropriate entity, and then call this tool with the selected entity_uuid.
- To find recent research about multiple entities, pass all selected entity_uuid values in research_entity_uuids.
- To retrieve the next page of results, pass the previous response's next_cursor as cursor.
Results can be filtered by publication date and retrieved using cursor-based pagination.
Input schema (server-provided preview — do not copy)
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"research_entity_uuids"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Maximum number of posts to return. Minimum 1, maximum 50, default 25."
},
"order": {
"enum": [
"published_descending",
"published_ascending"
],
"type": "string",
"description": "Sort results by publication time. Use 'published_descending' for newest first or 'published_ascending' for oldest first. Default is published_descending."
},
"cursor": {
"type": "string",
"description": "Pagination cursor returned by a previous response. Use this to retrieve the next page of results."
},
"published_after": {
"type": "string",
"format": "date-time",
"description": "Only return posts published after this timestamp. Provide a complete RFC 3339 timestamp including a timezone, for example 2026-08-01T00:00:00Z. Date-only values such as 2026-08-01 are not accepted."
},
"published_before": {
"type": "string",
"format": "date-time",
"description": "Only return posts published before this timestamp. Provide a complete RFC 3339 timestamp including a timezone, for example 2026-08-01T00:00:00Z. Date-only values such as 2026-08-01 are not accepted."
},
"count_total_results": {
"type": "boolean",
"description": "Whether to include the total number of matching posts. Use false unless the total count is specifically needed. Calculating the total count may increase response time for large result sets."
},
"research_entity_uuids": {
"type": "array",
"items": {
"type": "string"
},
"description": "One or more research entity UUIDs to search against.\n\nThis field is required.\n\nAt least one research entity UUID must be supplied.\n\nDo not pass entity names.\n\nIf the user provides entity names rather than UUIDs, first call the \"search_research_entities\" tool and use the returned UUIDs from that tool.\n"
}
}
}