Skip to main content
Glama
Sign In

Convoca

by com.convocaliteraria
OverviewDiscussionsAdmin

Ver un premio

ver_premio
Read-onlyIdempotent

Todo lo que sabemos de un premio literario: la convocatoria abierta o la última, cuándo vuelve, las ediciones vistas, el palmarés y los libros premiados, con un resumen en una frase. Acepta el identificador del premio (slug, de buscar_premios o de la dirección de su página) o su nombre.

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": {
      "premio": "<premio>"
    },
    "name": "ver_premio"
  }
}

Input Schema

NameRequiredDescriptionDefault
premioYesEl slug (p. ej. premi-carles-riba-de-poesia) o el nombre del premio.

Output Schema

NameRequiredDescriptionDefault
slugNo
avisoNo
cierreNo
estadoNo
librosNo
nombreNo
paginaNo
abiertaNo
entidadNo
generosNo
lenguasNo
mensajeNo
proximaNo
resumenNo
datos_deNo
palmaresNo
edicionesNo
pagina_caNo
candidatosNo
encontradoYesfalse si encajan varios: van en candidatos, para volver con el slug.
web_oficialNo
convocatoriaNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • addedOutput schema / properties / convocatoria / properties / ia
      Added value: +{
+  "description": "Lo que dicen las bases de la IA. null: aún no se han leído para eso. menciona false: no dicen nada. crear y ayuda: «prohibido»/«permitido» y «prohibida»/«permitida»; declarar, detector y descalifica, true si lo dicen. Lo que no dicen, ausente: no se deduce.",
+  "properties": {
+    "ayuda": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "crear": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "declarar": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "descalifica": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "detector": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "menciona": {
+      "type": "boolean"
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}
  2. Changed1 schema field changed
    • addedOutput schema / properties / convocatoria / properties / tema
      Added value: +{
+  "description": "El tema en palabras cuando las bases lo acotan, en castellano (es) y en catalán (ca). null: no lo acotan, o no consta.",
+  "properties": {
+    "ca": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "es": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "type": [
+    "object",
+    "null"
+  ]
+}
  3. Changed1 schema field changed
    • changedOutput schema / properties / convocatoria / properties / tematicas / description
      Previous value: -"Etiquetas; «infantil» es literatura para niños y jóvenes."New value: +"Etiquetas; «infantil» es literatura para niños y jóvenes; «tema_libre», si las bases lo dicen. Sin etiquetas no significa tema libre."
  4. Changed1 schema field changed
    • addedOutput schema / properties / convocatoria / properties / tematicas
      Added value: +{
+  "description": "Etiquetas; «infantil» es literatura para niños y jóvenes.",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}
  5. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "properties": {
+    "abierta": {
+      "type": [
+        "boolean",
+        "null"
+      ]
+    },
+    "aviso": {
+      "type": "string"
+    },
+    "candidatos": {
+      "items": {
+        "properties": {
+          "abierta": {
+            "type": [
+              "boolean",
+              "null"
+            ]
+          },
+          "entidad": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "nombre": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "slug": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "cierre": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "convocatoria": {
+      "properties": {
+        "ambito": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "bases": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "cierre": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "condiciones": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "cuota": {
+          "type": "string"
+        },
+        "dias_restantes": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "entidad": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "extension": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "extension_max": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "extension_min": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "extension_unidad": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "fuente": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "generos": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "id": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "lectura_de_bases": {
+          "description": "Cómo leyó Convoca las bases; null si no las leyó.",
+          "properties": {
+            "comprobadas": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "documento": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "leidas": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "parcial": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            }
+          },
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "lenguas": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "pagina": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "plazo_calculado": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "plazo_sin_fecha": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "por_comprobar": {
+          "description": "Los filtros que pasa solo porque el dato no consta: compruébalo en las bases.",
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        },
+        "premio": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "premio_cambio_de": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "premio_eur": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "premio_eur_aproximado": {
+          "type": "boolean"
+        },
+        "premio_importe": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "premio_moneda": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "presupuesto_eur": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "quien_puede": {
+          "properties": {
+            "edad_max": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "edad_min": {
+              "type": [
+                "integer",
+                "null"
+              ]
+            },
+            "nacionalidad": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "obra_inedita": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "obra_ya_publicada": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "por_designacion": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "residencia": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "sexo": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "sin_restricciones": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "solo_noveles": {
+              "type": [
+                "boolean",
+                "null"
+              ]
+            },
+            "texto": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "registro_oficial": {
+          "type": [
+            "object",
+            "null"
+          ]
+        },
+        "slug_premio": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "titulo": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "titulo",
+        "pagina",
+        "bases",
+        "cierre"
+      ],
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "datos_de": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "ediciones": {
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "encontrado": {
+      "description": "false si encajan varios: van en candidatos, para volver con el slug.",
+      "type": "boolean"
+    },
+    "entidad": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "estado": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "generos": {
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "lenguas": {
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "libros": {
+      "type": [
+        "array",
+        "null"
+      ]
+    },
+    "mensaje": {
+      "type": "string"
+    },
+    "nombre": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "pagina": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "pagina_ca": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "palmares": {
+      "items": {
+        "properties": {
+          "anyo": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "autor": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "fuentes": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "libro": {
+            "properties": {
+              "editorial": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "ficha": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "isbn": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "lengua": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "publicado": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "titulo": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": [
+              "object",
+              "null"
+            ]
+          },
+          "obra": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "proxima": {
+      "type": [
+        "object",
+        "null"
+      ]
+    },
+    "resumen": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "slug": {
+      "type": "string"
+    },
+    "web_oficial": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "required": [
+    "encontrado"
+  ],
+  "type": "object"
+}
  6. First observed

TDQS

A3.8/5.0
Behavior4/5

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

Annotations already declare readOnlyHint, idempotentHint, non-destructive and closed-world, so safety is covered. The description adds real behavioral context by disclosing that a single call aggregates several datasets (open/latest call, cadence, editions, palmarés, awarded books) plus a one-sentence summary. It omits what happens when the prize is not found or the name is ambiguous, which keeps it from a 5.

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 sentences, front-loaded with the scope of returned data and followed by the accepted input formats. Every clause carries information about what the agent will get back or what it must supply; there is no filler.

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?

With an output schema present, the description need not detail return shapes, and annotations cover the safety profile; the description still goes further by summarizing the content categories. The only meaningful gap is failure/ambiguity behavior for an unknown or fuzzy prize name.

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% and the single 'premio' parameter already documents slug-or-name with an example. The description adds modest value by stating provenance of the slug (buscar_premios or the prize page URL) and reiterating the name alternative, but nothing about matching behavior or slug normalization. Baseline 3 is appropriate.

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?

States a specific verb+resource (ver un premio) and then enumerates exactly what the call returns: convocatoria, editions, palmarés, awarded books and a one-sentence summary. That enumeration implicitly distinguishes it from siblings like palmares, libros_premiados and buscar_premios, though it never names them explicitly.

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?

The mention that the slug can come 'de buscar_premios o de la dirección de su página' gives a useful workflow hint for obtaining the identifier, implying buscar_premios is the search counterpart. However, there is no explicit statement of when to use this tool versus ver_convocatoria, palmares or libros_premiados, and no when-not guidance.

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

All Convoca toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources