Skip to main content
Glama

anuncios

Retrieve Moodle teacher announcements and recent forum discussions by course and age, defaulting to announcement/avisos forums only.

Instructions

Anuncios de profesores y discusiones de foros recientes. Por defecto solo los foros de Avisos/Anuncios.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "anuncios"
  }
}

Input Schema

NameRequiredDescriptionDefault
diasNoAntigüedad máxima en días
cursoNoId o parte del nombre del curso (opcional)
incluir_foros_generalesNoIncluir también los foros de discusión normales

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.2.0

TDQS

A3.6/5.0
Behavior3/5

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

No annotations are supplied, so the description carries the full burden. It does disclose one meaningful behavioral trait beyond the schema: the default result set is limited to announcement forums rather than all forums. It does not say whether results are chronological, capped in count, or read-only, which leaves gaps for a no-annotation tool.

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 with zero filler, and the scope constraint is front-loaded immediately after the resource statement. Nothing is repeated or padded.

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?

For a three-optional-parameter read tool with no output schema and no annotations, the description covers the resource and its default scope adequately. Ordering, result volume, and returned fields are unspecified, but those are modest gaps for a simple listing tool.

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 coverage is 100%, so dias, curso, and incluir_foros_generales are already documented, and the description's default-scope statement largely restates the schema default for incluir_foros_generales. Baseline 3 applies; the description adds no syntax or interpretation beyond the schema.

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?

The description names the resource precisely: teacher announcements plus recent forum discussions, with a stated default scope restricted to Avisos/Anuncios forums. This lets an agent distinguish it from discussion-oriented siblings like ver_discusion, though it does so implicitly rather than by naming alternatives. It is a noun phrase with no verb, which costs a bit of action clarity.

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 only implied: the default-scope sentence hints that incluir_foros_generales widens the search, but there is no explicit when-to-use, when-not-to-use, or named alternative among siblings such as notificaciones, mensajes, or ver_discusion. An agent must infer selection from the noun phrase alone.

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