Get Category Problems
sdamgia_get_category_problemsRetrieve all problem IDs for a specific subject category to identify available problems before fetching their details or solutions.
Instructions
Retrieves all problem identifiers belonging to a specific problem category within a subject.
PURPOSE: Fetches the complete list of unique problem IDs for problems classified under a specific category. This enables you to identify exactly which problems exist in a category before retrieving their full details or solutions.
WHEN TO USE:
Use AFTER obtaining a category_id from sdamgia_get_catalog (required prerequisite)
Use when you need to see all available problems in a specific category
Use when building problem sets from particular topics
Use when you need to count how many problems exist in a category
Use when selecting specific problems before fetching their full content
Essential for batch operations on category-level problem sets
KEY PARAMETERS:
subject (required): The subject identifier (e.g., 'ege', 'oge', 'math')
category_id (required): Unique category identifier obtained from sdamgia_get_catalog
limit (optional): Maximum number of problem IDs to return (for pagination or sampling)
response_format (optional): Output format - 'json' for structured data, 'markdown' for formatted text (default: 'json')
PARAMETER CONSTRAINTS:
category_id MUST be a valid ID from the catalog - invalid IDs will return errors
If category has no problems, returns empty array
limit parameter truncates results if specified; otherwise returns all problems
Category IDs are subject-specific - same ID may exist in multiple subjects but refer to different content
RESPONSE FORMAT: Returns an array of problem ID strings/numbers:
Each ID represents a unique problem that can be fetched with other tools
IDs are typically numeric but returned as strings
Order of IDs may not be sequential or sorted
Array may be empty for new or unused categories
Total count of problems is included in response metadata
IMPORTANT NOTES:
This tool ONLY returns problem IDs, NOT problem content, statements, or solutions
You MUST call sdamgia_get_catalog first to obtain valid category_id values
category_id values are case-sensitive and must match exactly from catalog
Large categories may return hundreds or thousands of IDs
The same problem ID may appear in multiple categories (cross-categorized content)
Invalid or expired category IDs will cause the request to fail
EXAMPLE WORKFLOW:
Call sdamgia_get_catalog(subject='ege') to browse categories
Find desired category (e.g., id='12345' for "Derivatives")
Call sdamgia_get_category_problems(subject='ege', category_id='12345')
Receive array: [1001, 1002, 1005, 1102, ...]
Use individual problem IDs with sdamgia_get_problem to get full content
TYPICAL USE CASES:
"Get all problems in the 'Quadratic Equations' category for EGE"
"List first 50 problems from category ID 54321"
"How many practice problems exist for this topic?"
"Collect all problem IDs for a specific category to analyze difficulty distribution"
"Build a randomized problem set from category 67890"
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| subject | Yes | Subject code | |
| category_id | Yes | Category ID | |
| limit | No | Maximum number of results to return | |
| response_format | No | markdown |