Skip to main content
Glama

rottentomatoes_editorial_terms

Read-only

List paginated Rotten Tomatoes editorial taxonomy-term records with search/order/assignment filters. Discover taxonomy names through rottentomatoes_editorial_taxonomies; parent applies only to categories, while offset works for other taxonomies. Use rottentomatoes_editorial_search for content search.

Input Schema

NameRequiredDescriptionDefault
pageNoOne-based page, default 1
postNoFilter to terms assigned to this content record
slugNoOptional term slug or comma-separated slugs
limitNoTerms per page, default 20, range 1 to 100
orderNoTerm sort direction. Documented values: asc, desc.
offsetNoZero-based offset; accepted except for categories
parentNoCategory parent ID; accepted only for categories
searchNoOptional term search; maximum 200 bytes
excludeNoComma-separated positive term IDs to exclude
includeNoComma-separated positive term IDs to include
orderbyNoTerm sort key. Documented values: id, include, name, slug, include_slugs, term_group, description, count.
taxonomyYesEditorial taxonomy value. Documented values: categories, tags, related-movie-id, related-tv-season-id, related-tv-series-id, related-tv-episode-id, related-celebrity-id, publication, franchise, coauthors.
hide_emptyNoWhen true, omit terms with no assigned content

Output Schema

NameRequiredDescriptionDefault
dataYesThe tool result payload (shape varies per tool; see each tool's docs resource).

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed13 schema fields changed
    • addedInput schema / properties / exclude / description
      Added value: +"Comma-separated positive term IDs to exclude"
    • addedInput schema / properties / hide_empty / description
      Added value: +"When true, omit terms with no assigned content"
    • addedInput schema / properties / include / description
      Added value: +"Comma-separated positive term IDs to include"
    • addedInput schema / properties / limit / description
      Added value: +"Terms per page, default 20, range 1 to 100"
    • addedInput schema / properties / offset / description
      Added value: +"Zero-based offset; accepted except for categories"
    • addedInput schema / properties / order / description
      Added value: +"Term sort direction. Documented values: asc, desc."
    • addedInput schema / properties / orderby / description
      Added value: +"Term sort key. Documented values: id, include, name, slug, include_slugs, term_group, description, count."
    • addedInput schema / properties / page / description
      Added value: +"One-based page, default 1"
    • addedInput schema / properties / parent / description
      Added value: +"Category parent ID; accepted only for categories"
    • addedInput schema / properties / post / description
      Added value: +"Filter to terms assigned to this content record"
    • addedInput schema / properties / search / description
      Added value: +"Optional term search; maximum 200 bytes"
    • addedInput schema / properties / slug / description
      Added value: +"Optional term slug or comma-separated slugs"
    • addedInput schema / properties / taxonomy / description
      Added value: +"Editorial taxonomy value. Documented values: categories, tags, related-movie-id, related-tv-season-id, related-tv-series-id, related-tv-episode-id, related-celebrity-id, publication, franchise, coauthors."
  2. First observed

TDQS

A3.9/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and openWorldHint=true, so the safety profile is covered. The description adds the cross-field applicability constraints on `parent` and `offset`, which is genuinely useful, but it duplicates what the schema descriptions already state rather than disclosing new behavior like pagination limits or return shape.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tightly written sentences with no filler, front-loading the core purpose before the sibling routing and parameter caveats. Efficient, though the parent/offset sentence slightly overlaps schema content.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only list tool with a 100%-covered schema, existing annotations, and an output schema, the description covers purpose, routing, and key constraints. Return values need not be explained given the output schema; only minor pagination/behavioral detail is absent.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all 13 parameters are already documented in the schema (including the categories-only `parent` and offset-except-categories notes). The description restates those constraints rather than adding syntax, defaults, or format detail beyond the schema. Baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (List) and resource (paginated Rotten Tomatoes editorial taxonomy-term records) with scope (search/order/assignment filters). It names the two sibling tools it is distinct from (rottentomatoes_editorial_taxonomies, rottentomatoes_editorial_search), so an agent can route between them without opening schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly routes the agent: discover taxonomy names via rottentomatoes_editorial_taxonomies and use rottentomatoes_editorial_search for content search. It also flags applicability of `parent` and `offset`. Lacks an explicit when-not-to-use statement for this tool itself, hence not a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.