list_standards

Use list_standards to find CASE standards or related framework items for planning, alignment, and agent retrieval. The tool can run a semantic text search and then narrow results by framework, grade, subject, CASE item type, or human coding scheme prefix. For example, an agent can fetch grade 4 fraction standards from a specific framework before drafting a lesson or rubric.

Parameters

  • Name
    query
    Type
    string
    Description
    Optional semantic search text. Use natural language, a standard statement fragment, or a skill description; omit it when you want a filter-only lookup.
  • Name
    framework_guids
    Type
    string[]
    Description
    Optional list of CASE framework document GUIDs to search within. Use this to keep results inside one or more known standards frameworks.
  • Name
    grades
    Type
    string[]
    Description
    Optional list of grade or education-level values to match, such as "4", "Grade 4", or framework-specific grade labels. Values are matched against the item education level metadata.
  • Name
    subjects
    Type
    string[]
    Description
    Optional list of subject names to match, such as "Mathematics", "Science", or "English Language Arts". Subject labels must match the framework metadata closely.
  • Name
    cf_item_types
    Type
    string[]
    Description
    Optional list of CASE item types to include, such as "Standard", "Cluster", "Domain", or "Strand". Use this when you need only leaf standards or only organizing nodes.
  • Name
    human_coding_scheme_prefix
    Type
    string
    Description
    Optional prefix filter for the CASE humanCodingScheme field, such as "4.NF" or "MS-PS1". This is a prefix match, not a semantic query.
  • Name
    limit
    Type
    number
    Description
    Maximum number of results to return. Defaults to 25; use a smaller value for agent context windows and pagination.
  • Name
    offset
    Type
    number
    Description
    Number of matching results to skip before returning items. Defaults to 0 and is used with limit for pagination.

Example

{
  "query": "equivalent fractions and comparing fractions",
  "framework_guids": ["d676e7e0-0c5c-11e6-a6c7-1803733ee7f5"],
  "grades": ["4"],
  "subjects": ["Mathematics"],
  "cf_item_types": ["Standard"],
  "human_coding_scheme_prefix": "4.NF",
  "limit": 5,
  "offset": 0
}

Common pitfalls

  • Filters are combined, so a narrow prefix plus grade, subject, and framework can return no results even when each filter works alone.
  • Do not use human_coding_scheme_prefix for free text; put skill descriptions in query and codes like "4.NF" in the prefix field.
  • Grade and subject labels come from the framework metadata. If results are missing, retry with fewer filters or the exact labels used by that framework.