Skip to main content
Glama

Course materials

schoology_course
Read-only

Read a Schoology course's materials page as text, including folders, assignments, files, and posts. Provide part of the course name to retrieve its contents read-only.

Instructions

A course's materials page (folders, assignments, files, posts) as text. Give part of the course name. Read-only.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "course": "<course>"
    },
    "name": "schoology_course"
  }
}

Input Schema

NameRequiredDescriptionDefault
courseYesPart of the course name

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv1.0.0

TDQS

A3.5/5.0
Behavior3/5

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

The annotations already declare readOnlyHint=true, and the description's 'Read-only' merely repeats that. It does add that the page contents come back as text, but says nothing about pagination, size limits, nesting depth, or what happens when the partial course name matches multiple courses.

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

Conciseness5/5

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

Two short sentences, front-loaded with what the tool returns, followed by the one input hint. Nothing is padded or redundant beyond the mild restatement of 'Read-only' already covered by annotations.

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

Completeness3/5

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

For a one-parameter read tool with no output schema, the definition covers the essentials: what is returned and how to identify the course. The notable gap is the partial-name matching behavior — an agent cannot tell how ambiguity or no-match is handled, which matters since the sole parameter is a fuzzy string.

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% and there is a single parameter, so the schema already documents 'Part of the course name'. The description repeats that phrase verbatim and adds no matching semantics such as case sensitivity, substring behavior, or ambiguity handling; baseline 3 applies.

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

Purpose4/5

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

Names the specific resource ('a course's materials page') and enumerates its contents (folders, assignments, files, posts) plus the return form ('as text'), so an agent knows exactly what is fetched. It does not explicitly distinguish itself from schoology_courses or schoology_upcoming, but the resource is concrete enough to separate them in practice.

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

Usage Guidelines3/5

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

Usage is implied rather than stated: fetch this when you need the materials/content of a known course. The line 'Give part of the course name' is a hint about acceptable input rather than when-to-use guidance, and no alternatives or exclusions are named.

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