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.

Args:
    topic: Quiz topic
    num_questions: Number of questions (max 30)
    difficulty: Difficulty level: easy, medium, hard, mixed
    question_types: Types to include: multiple_choice, true_false, short_answer, fill_blank, matching
    age_group: Target age group
    include_answers: Include answer key

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.

Args:
    subject: Subject area (e.g. "Mathematics", "Science", "English")
    topic: Specific topic (e.g. "Quadratic Equations", "Photosynthesis")
    age_group: Student age range (e.g. "11-13", "14-16", "16-18")
    duration_minutes: Lesson duration in minutes
    learning_objectives: Custom objectives (auto-generated if omitted)
    differentiation: Include differentiation strategies

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.

Args:
    assignment_title: Title of the assignment
    criteria: Custom assessment criteria (auto-generated if omitted)
    levels: Number of performance levels (3-5)
    max_score: Maximum total score
    assignment_type: Type: essay, presentation, project, lab_report, portfolio

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.

Args:
    subject: Subject area
    current_level: Current proficiency: beginner, intermediate, advanced
    learning_style: Learning style: visual, auditory, kinesthetic, reading_writing
    goals: Specific learning goals
    available_hours_per_week: Hours available for study per week

Behavior:
    This tool is read-only and stateless — it produces analysis output
    without modifying any external systems, databases, or files.
    Safe to call repeatedly with identical inputs (idempotent).
    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.