Skip to main content
Glama

analyze_student_progress

Identify student performance gaps and generate a detailed progress report using assessment data and target grades.

Instructions

Analyze student performance trends and generate progress report.

Args:
    student_name: Student's name
    assessments: List of dicts with keys: subject, score (0-100), date, assessment_name (optional)
    target_grade: Target grade percentage

Behavior:
    This tool generates structured output without modifying external systems.
    Output is deterministic for identical inputs. No side effects.
    Free tier: 10/day rate limit. Pro tier: unlimited.
    No authentication required for basic usage.

When to use:
    Use this tool when you need structured analysis or classification
    of inputs against established frameworks or standards.

When NOT to use:
    Not suitable for real-time production decision-making without
    human review of results.
Behavioral Transparency:
    - Side Effects: This tool is read-only and produces no side effects. It does not modify
      any external state, databases, or files. All output is computed in-memory and returned
      directly to the caller.
    - Authentication: No authentication required for basic usage. Pro/Enterprise tiers
      require a valid MEOK API key passed via the MEOK_API_KEY environment variable.
    - Rate Limits: Free tier: 10 calls/day. Pro tier: unlimited. Rate limit headers are
      included in responses (X-RateLimit-Remaining, X-RateLimit-Reset).
    - Error Handling: Returns structured error objects with 'error' key on failure.
      Never raises unhandled exceptions. Invalid inputs return descriptive validation errors.
    - Idempotency: Fully idempotent — calling with the same inputs always produces the
      same output. Safe to retry on timeout or transient failure.
    - Data Privacy: No input data is stored, logged, or transmitted to external services.
      All processing happens locally within the MCP server process.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
student_nameYes
assessmentsYes
target_gradeNo
api_keyNo
Behavior5/5

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

With no annotations, the description fully covers behavioral traits: read-only, idempotent, no side effects, authentication requirements, rate limits (10/day free), error handling (structured errors), data privacy (no storage). Comprehensive and clear.

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

Conciseness4/5

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

Well-structured with clear sections, though there is minor redundancy between 'Behavior' and 'Behavioral Transparency'. Overall front-loaded and efficient for its detail level.

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

Completeness4/5

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

Given 4 parameters, no annotations, and no output schema, the description is quite complete. It covers purpose, usage, parameters, and behaviors. The only gap is the lack of a success output format description, but structured output is implied.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The 'Args' section adds meaning to student_name, assessments (list of dicts with specific keys), and target_grade, despite 0% schema coverage. The api_key parameter is also mentioned in behavioral transparency, providing context beyond the schema.

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

Purpose5/5

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

The description clearly states 'Analyze student performance trends and generate progress report', specifying a concrete verb and resource. It distinguishes from sibling tools like create_quiz and generate_lesson_plan by focusing on analysis and reporting.

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

Usage Guidelines4/5

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

Provides explicit 'When to use' and 'When NOT to use' sections, advising against real-time decision-making without human review. However, it does not name specific alternative tools for exclusion.

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

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/CSOAI-ORG/education-ai-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server