Surt de Casa (surtdecasa.cat)
RemoteAbout Surt de Casa (surtdecasa.cat)
Surt de Casa is an MCP server for finding local cultural events, cinema listings, and towns in Catalonia. It serves people looking up regional events and screenings, with remote HTTP and local stdio connection modes.
Key features
- 01Filter events by area, category, and date
- 02View event details and links
- 03Browse weekly cinema listings
- 04Autocomplete town names
Use cases
- 01Find cultural events for a weekend or date
- 02Check event venues, prices, and organizers
- 03Look up this week's films and poster links
MCP support
The MCP server exposes tools for event search and details, cinema listings, and town lookup. It connects through remote Streamable HTTP or local stdio.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://surtdecasa-mcp.peremontpeo.workers.dev/mcpclaude mcp add --transport http pmontp19-surtdecasa https://surtdecasa-mcp.peremontpeo.workers.dev/mcp{"mcpServers":{"pmontp19-surtdecasa":{"type":"http","url":"https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"}}}Open in Cursor{"servers":{"pmontp19-surtdecasa":{"type":"http","url":"https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"}}}Open in VS Code{"mcpServers":{"pmontp19-surtdecasa":{"type":"http","url":"https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"}}}{"mcpServers":{"pmontp19-surtdecasa":{"serverUrl":"https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
4| Parameter | Type | Required | Description |
|---|---|---|---|
| fi | string | No | End date dd/mm/yyyy (if only a start date is provided, the range is one year) |
| zona | array | No | Territorial zones to include |
| inici | string | No | Start date dd/mm/yyyy (takes priority over calendar) |
| tipus | array | No | Special tags |
| poblacio | string | No | Town name (exact; query poblacions to find it) |
| calendari | enum | No | Date shortcutavui | dema | cap-de-setmana |
| categoria | array | No | Categories to include |
Details
From the project READMEsurtdecasa-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
| Eina | Descripció |
|---|---|
cercar_agenda | Cerca esdeveniments amb filtres: zona territorial, categoria, tipus (aire lliure, gratuït, nocturn), població, dies (avui/dema/cap de setmana) i rang de dates |
detall_esdeveniment | Tota la informació d'un esdeveniment: dates, lloc, poblacions, preu, organitzador, descripció i enllaços |
cartellera | Pel·lícules de la setmana amb enllaç i cartell |
poblacions | Autocomplete 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 localsrc/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-Agentidentificatiu). - 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
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.