Tools Reference

Complete reference for every tool and resource exposed by the StudyPlug MCP server.

Tools

`browse_curriculum`

Browse the K-5 educational curriculum with progressive drill-down. Call with no parameters to see grades, then add parameters to go deeper.

Parameters

Name	Type	Required	Description
`grade`	string	No	Grade slug: `kindergarten`, `grade-1` through `grade-5`
`subject`	string	No	Subject slug: `math`, `reading`, `vocabulary`, `spelling`, `science`
`topic`	string	No	Topic slug, e.g., `addition`, `comprehension`, `life-science`

Drill-down behavior

Parameters provided	Returns
None	List of all grades with skill counts
`grade`	Subjects available at that grade
`grade` + `subject`	Topics within that subject
`grade` + `subject` + `topic`	Individual skills with descriptions

Example conversation

User: What can I generate for grade 3 math?

Agent calls: browse_curriculum(grade="grade-3", subject="math")
→ Topics: Addition (6 skills), Subtraction (5 skills), Multiplication (8 skills), ...

User: Show me the multiplication skills.

Agent calls: browse_curriculum(grade="grade-3", subject="math", topic="multiplication")
→ Skills: multiply-by-2 (Multiply by 2), multiply-by-3 (Multiply by 3), ...

`generate_problems`

Generate practice problems for a specific skill. Returns formatted text with questions and answers.

Parameters

Name	Type	Required	Description
`skill`	string	Yes	Skill slug, e.g., `add-within-20`, `main-idea-details`
`grade`	string	Yes	Grade slug where this skill is available
`count`	number	No	Number of problems, 1-20 (default: 5)
`seed`	number	No	Seed for deterministic output. Same seed = same problems

Example conversation

User: Give me 3 addition problems for a kindergartener.

Agent calls: generate_problems(skill="add-within-10", grade="kindergarten", count=3)
→ Problem 1:
    Expression: 4 + 3
    Answer: 7
  Problem 2:
    Expression: 8 + 2
    Answer: 10
  Problem 3:
    Expression: 5 + 1
    Answer: 6

Notes

Use browse_curriculum first to discover valid skill slugs for a grade.
The seed parameter is useful for reproducibility. Pass the same seed to get identical output.
If a skill is not found at the specified grade, the tool returns an error message suggesting you use browse_curriculum.

`find_by_standard`

Find skills aligned to a specific educational standard code. Supports CCSS-Math, CCSS-ELA, and NGSS.

Parameters

Name	Type	Required	Description
`standardCode`	string	Yes	Standard code, e.g., `3.OA.C.7`, `RL.4.2`, `3-LS1-1`

Example conversation

User: What skills align to Common Core standard 3.OA.C.7?

Agent calls: find_by_standard(standardCode="3.OA.C.7")
→ Standard: 3.OA.C.7
  Framework: CCSS-Math
  Label: Fluently multiply and divide within 100
  Mapped Skills (4):
  - Multiply by 2 (multiply-by-2) — Grade 3, Math > Multiplication
  - Multiply by 3 (multiply-by-3) — Grade 3, Math > Multiplication
  - ...

Valid code formats

CCSS Math: K.CC.A.1, 3.OA.C.7, 5.NF.A.1
CCSS ELA: RL.3.1, RI.4.2, RF.K.1
NGSS: K-PS2-1, 3-LS1-1, 5-ESS1-1

`get_skill_info`

Get detailed metadata about a skill including its description, subject, topic, grade availability, and standards alignment.

Parameters

Name	Type	Required	Description
`skill`	string	Yes	Skill slug, e.g., `add-within-10`, `equivalent-fractions`

Example conversation

User: Tell me about the "equivalent-fractions" skill.

Agent calls: get_skill_info(skill="equivalent-fractions")
→ Skill: Equivalent Fractions
  Slug: equivalent-fractions
  Description: Identify and generate equivalent fractions
  Subject: Math
  Topic: Fractions
  Available at 2 grade level(s):
  - Grade 3 (Standards: 3.NF.A.3)
  - Grade 4 (Standards: 4.NF.A.1)

Resources

MCP resources are read-only data that agents can fetch for context. Unlike tools, resources do not accept parameters — they return a fixed dataset.

`studyplug://curriculum`

The full curriculum tree as JSON. Contains every grade, subject, topic, and skill with names and slugs.

Format: application/json

[
  {
    "slug": "kindergarten",
    "name": "Kindergarten",
    "order": 0,
    "subjects": [
      {
        "slug": "math",
        "name": "Math",
        "topics": [
          {
            "slug": "counting",
            "name": "Counting",
            "skills": [
              { "slug": "count-to-10", "name": "Count to 10" },
              { "slug": "count-to-20", "name": "Count to 20" }
            ]
          }
        ]
      }
    ]
  }
]

Use case: An agent can read this resource at the start of a session to understand the full scope of available content without making multiple browse_curriculum calls.

`studyplug://standards`

All educational standards (CCSS-Math, CCSS-ELA, NGSS) with their mapped skills as JSON.

Format: application/json

[
  {
    "code": "CCSS.Math.Content.3.OA.C.7",
    "shortCode": "3.OA.C.7",
    "framework": "CCSS-Math",
    "label": "Fluently multiply and divide within 100",
    "description": "...",
    "skillCount": 4,
    "skills": [
      { "slug": "multiply-by-2", "name": "Multiply by 2", "grade": "Grade 3" }
    ]
  }
]

Use case: An agent building a standards-aligned lesson plan can read the full standards map and cross-reference it with curriculum data.

Next Steps

Installation — set up the server with Claude Desktop
Overview — understand how MCP fits into the StudyPlug ecosystem
Skills and Standards — learn about the curriculum data model