Catalunya 2022

by cat.2022

Document structure and citation

get_document_metadata

Read-onlyIdempotent

Get the complete structure of the policy document "Catalunya 2022 - RESET: Crida per reactivar el país": 3 spheres, 12 goals, 91 actions written by the Grup de Treball Catalunya 2022 (30 civil-society experts). Returns the hierarchy with canonical slugs for navigation via get_section, plus the formal citation with DOI.

Input Schema

Name	Required	Description	Default
`locale`	No	Content language. Defaults to 'ca' (Catalan), the original language of the document. (ca=Catalan, en=English, es=Spanish)	ca

Output Schema

Name	Required	Description	Default
`date`	Yes
`title`	Yes
`citation`	Yes
`hierarchy`	Yes
`languages`	Yes
`structure`	Yes
`staticPages`	Yes
`contributors`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedAug 17, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

removedInput schema / additionalProperties
```
Removed value: -false
```

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": false,
+  "properties": {
+    "citation": {
+      "additionalProperties": false,
+      "properties": {
+        "author": {
+          "type": "string"
+        },
+        "doi": {
+          "type": "string"
+        },
+        "doiUrl": {
+          "type": "string"
+        },
+        "title": {
+          "type": "string"
+        },
+        "year": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "title",
+        "author",
+        "year",
+        "doi",
+        "doiUrl"
+      ],
+      "type": "object"
+    },
+    "contributors": {
+      "additionalProperties": false,
+      "properties": {
+        "count": {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        },
+        "members": {
+          "items": {
+            "additionalProperties": false,
+            "properties": {
+              "name": {
+                "type": "string"
+              },
+              "role": {
+                "type": "string"
+              },
+              "slug": {
+                "type": "string"
+              },
+              "url": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "name",
+              "slug",
+              "role",
+              "url"
+            ],
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "names": {
+          "items": {
+            "type": "string"
+          },
+          "type": "array"
+        }
+      },
+      "required": [
+        "count",
+        "names",
+        "members"
+      ],
+      "type": "object"
+    },
+    "date": {
+      "type": "string"
+    },
+    "hierarchy": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "goals": {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "actionCount": {
+                  "maximum": 9007199254740991,
+                  "minimum": -9007199254740991,
+                  "type": "integer"
+                },
+                "actions": {
+                  "items": {
+                    "additionalProperties": false,
+                    "properties": {
+                      "id": {
+                        "type": "string"
+                      },
+                      "slug": {
+                        "type": "string"
+                      },
+                      "title": {
+                        "type": "string"
+                      }
+                    },
+                    "required": [
+                      "title",
+                      "slug",
+                      "id"
+                    ],
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "id": {
+                  "maximum": 9007199254740991,
+                  "minimum": -9007199254740991,
+                  "type": "integer"
+                },
+                "slug": {
+                  "type": "string"
+                },
+                "title": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "title",
+                "slug",
+                "id",
+                "actionCount",
+                "actions"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "id": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          "slug": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "title",
+          "slug",
+          "id",
+          "goals"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "languages": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "staticPages": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "slug": {
+            "type": "string"
+          },
+          "title": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "title",
+          "slug"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "structure": {
+      "additionalProperties": false,
+      "properties": {
+        "actions": {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        },
+        "contributors": {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        },
+        "goals": {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        },
+        "spheres": {
+          "maximum": 9007199254740991,
+          "minimum": -9007199254740991,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "spheres",
+        "goals",
+        "actions",
+        "contributors"
+      ],
+      "type": "object"
+    },
+    "title": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "title",
+    "date",
+    "languages",
+    "structure",
+    "citation",
+    "hierarchy",
+    "staticPages",
+    "contributors"
+  ],
+  "type": "object"
+}

First observedApr 10, 2026

TDQS

A4.1/5.0

Behavior4/5

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

Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), so the description's added value is the affordance that returned slugs are canonical and feed get_section, plus the DOI citation. It does not discuss caching, document versioning, or locale effects on output, but for a static metadata read that is minor.

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?

Two sentences, front-loaded with the return payload and ending on the navigation/citation purpose; nothing is redundant. The enumerated counts and author detail are informative rather than filler, though the sentence runs long.

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 a rich output schema, complete annotations, and one optional parameter, the description only needs to frame the tool's role. It does that well as the document entry point, though it never addresses the locale parameter or what happens if a non-original language is requested.

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 the single locale parameter is fully documented in the schema with its enum and default, so baseline 3 applies. The description mentions language only indirectly via the Catalan document title and adds no syntax or fallback behavior 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?

Names a specific verb (Get) and resource (complete structure of the named policy document), and quantifies the payload (3 spheres, 12 goals, 91 actions). It explicitly distinguishes itself from the sibling get_section by positioning itself as the source of canonical slugs used for navigation.

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?

The phrase 'canonical slugs for navigation via get_section' establishes this tool as the entry point before drilling down, which is clear contextual guidance. However, it never states when NOT to use it or how it relates to search_document and list_proposals, so exclusion guidance is absent.

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

All Catalunya 2022 tools Inspect

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.