English Français العربية

Surt de Casa (surtdecasa.cat)

Official registry Other

Servidor MCP per surtdecasa.cat: agenda cultural de Catalunya, cartellera de cinema i poblacions.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http surt-de-casa-surtdecasa-cat 'https://surtdecasa-mcp.peremontpeo.workers.dev/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "surt-de-casa-surtdecasa-cat": {
            "type": "http",
            "url": "https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. surtdecasa-mcp
  2. Eines
  3. Configuració
  4. Desenvolupament
  5. Notes
  6. Llicència

surtdecasa-mcp

Servidor MCP per surtdecasa.cat, el digital de cultura de proximitat. Dona accés a l'agenda cultural, la cartellera de cinema i el cercador de poblacions directament des de qualsevol client MCP.

Disponible en dos modes:

  • Remot: Streamable HTTP a https://surtdecasa-mcp.peremontpeo.workers.dev/mcp (Cloudflare Workers, gratis)
  • Local: stdio, per executar-lo al teu ordinador

Eines

EinaDescripció
cercar_agendaCerca esdeveniments amb filtres: zona territorial, categoria, tipus (aire lliure, gratuït, nocturn), població, dies (avui/dema/cap de setmana) i rang de dates
detall_esdevenimentTota la informació d'un esdeveniment: dates, lloc, poblacions, preu, organitzador, descripció i enllaços
cartelleraPel·lícules de la setmana amb enllaç i cartell
poblacionsAutocomplete de poblacions: retorna els noms exactes que accepta el filtre poblacio

Configuració

Client remot (recomanat)
{
  "mcp": {
    "surtdecasa": {
      "type": "remote",
      "url": "https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"
    }
  }
}
Client local (stdio)
{
  "mcp": {
    "surtdecasa": {
      "type": "local",
      "command": ["node", "/ruta/a/surtdecasa-mcp/dist/index.js"]
    }
  }
}

Desenvolupament

Requereix Node 20+.

npm install
npm run build      # typecheck (stdio + workers) i compilar dist/
npm run dev:cf     # wrangler dev local a http://localhost:8787/mcp
npm run deploy     # desplegar a Cloudflare Workers

Estructura:

  • src/scraper.ts: client HTTP i parsers HTML de surtdecasa.cat (Drupal 7 renderitzat al servidor)
  • src/tools.ts: registre de les eines MCP (compartit entre els dos transports)
  • src/index.ts: entrada stdio local
  • src/worker.ts: entrada Cloudflare Workers (Durable Object amb Streamable HTTP)

Notes

  • El site no té API pública: el servidor fa scraping respectuós del HTML (poques peticions on-demand, User-Agent identificatiu).
  • Sense auth: l'endpoint remot és públic. Si el desplegues per al teu ús, considera afegir-hi un token.
  • Zones disponibles: ebre, penedes, camp, emporda, ponent, girona, centre, pirineus, barcelona.

Llicència

MIT

Frequently asked questions

What is Surt de Casa (surtdecasa.cat)?

Servidor MCP per surtdecasa.cat: agenda cultural de Catalunya, cartellera de cinema i poblacions.

How do I install Surt de Casa (surtdecasa.cat)?

It runs as a remote server. In Claude Code: claude mcp add --transport http surt-de-casa-surtdecasa-cat 'https://surtdecasa-mcp.peremontpeo.workers.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Surt de Casa (surtdecasa.cat) need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Surt de Casa (surtdecasa.cat) open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Surt de Casa (surtdecasa.cat)?

It is published by pmontp19. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.