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.