MCP Server for Catalunya 2022

Remote MCP server for the document "Catalunya 2022 - RESET: Call to reactivate Catalonia", the strategic plan written in 2021 by a working group of 30 experts from Catalan civil society. It exposes the document's 3 spheres, 12 goals, 91 actions, and contributor profiles in Catalan, English, and Spanish through MCP tools, resources, and prompts.

Connection

Public endpoint: https://mcp.2022.cat (Streamable HTTP transport, no authentication or API keys). The server speaks both generations of the protocol from a single endpoint: revision 2026-07-28 (without handshake, with server/discover) and the 2025-xx revisions for clients that still perform initialize.

{ "url": "https://mcp.2022.cat" }

• Per-client setup instructions (Claude, ChatGPT, Cursor, VS Code, Cline, Continue…): 2022.cat/mcp

• Official MCP Registry: cat.2022/catalunya-2022

• Document website: 2022.cat · repository

Related MCP server: Datos.gob.es-MCP

Public MCP surface

Tools

• search_document: full-text search with diacritic support

• get_section: full text of any section by canonical slug

• get_document_metadata: complete document structure

• list_proposals: list of the 91 actions

Resources

• document://catalunya2022/manifest

• document://catalunya2022/{locale}/{slug}

• document://catalunya2022/{locale}: the entire document in a single markdown file

• document://catalunya2022/contributors

Prompts

• explore-document

• summarize-sphere

• analyze-proposal

Development

Requirements: Node.js 22+ and npm.

npm install
npm run dev

npm run dev regenerates the corpus before starting the local server:

• http://localhost:3001/: MCP endpoint

• http://localhost:3001/health: health check

Quality checks

npm run lint        # format i lint amb Biome
npm run typecheck   # TypeScript estricte (inclou locals i paràmetres no usats)
npm run test        # reconstrueix corpus i dist, executa la suite de regressió
npm run verify      # validació completa local, equivalent a CI

Other commands: npm run build-corpus (regenerates data/corpus.json from the MDX), npm run start (runs the compiled server), npm run fixtures:update (regenerates the golden fixtures in tests/fixtures/; review the resulting diff), and npm run sync / npm run sync-check (see the note on synchronized content).

Run npm run verify before opening a pull request. The tests run against the compiled output in dist/: always use the npm scripts, which rebuild first.

Project structure

assets/         Icones del servidor (servides a /icon.svg i /icon.png)
content/        Fitxers MDX trilingües d'origen
data/           Constants, tipus, catàleg de rutes, contribuïdors, corpus generat
scripts/        Generació del corpus, sincronització de contingut i regeneració de fixtures
src/            Runtime del servidor MCP
tests/          Tests de contracte, regressió i utilitats
server.json     Manifest per al registre MCP oficial

Synchronized content

content/{ca,en,es}/ and data/team-members.ts are generated mirrors of the website repository, the source of truth for the document text. Do not edit them here: any change must be made in the source repository and is propagated with npm run sync (which records provenance in data/content-provenance.json). By default, the website repository is expected at ../web (cloned next to this one); the CAT22_WEBSITE_DIR environment variable allows specifying a different location. npm run sync-check detects deviations when the sibling repository is available and is cleanly skipped when it is not (for example, in CI).

Publication notes

• Canonical slugs are always in English, even when the content is localized.

• The default language is Catalan (ca).

• The generated file data/corpus.json is not versioned: npm run dev, npm run build, and npm test regenerate it from the versioned MDX, and CI validates it on every deployment.

• Public contract: the MCP tool names, resource URIs, prompt names, canonical slugs, response JSON shapes, and the default locale are public API. Do not change them without explicit, documented intent.

• If you change content/, data/, or the URL translation logic, regenerate the corpus and carefully review the regression fixtures.

English

Remote MCP server for the policy document "Catalunya 2022 - RESET: Call to reactivate Catalonia", a strategic plan written in 2021 by a 30-expert Catalan civil-society task force. It exposes the document's 3 spheres, 12 goals, 91 actions, and contributor profiles in Catalan, English, and Spanish through MCP tools, resources, and prompts.

Connect: public endpoint at https://mcp.2022.cat (Streamable HTTP, no authentication):

{ "url": "https://mcp.2022.cat" }

Per-client setup instructions: 2022.cat/mcp · Official MCP Registry: cat.2022/catalunya-2022 · Document website: 2022.cat · Website code: github.com/catalunya-2022/web · Archived document DOI: 10.5281/zenodo.19500831

Development commands are language-neutral; see Desenvolupament above.

Licenses

• Code: MIT

• Document content (content/): CC BY 4.0 - Grup de Treball Catalunya 2022. Catalunya 2022 - RESET: Crida per reactivar el país. DOI: 10.5281/zenodo.19500831