Surt de Casa (surtdecasa.cat)

io.github.pmontp19Published by GitHub account pmontp19v0.1.1Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

MCP server for surtdecasa.cat that lets an assistant search Catalan cultural events, weekly cinema listings and town names.

What you can do
  • Search the cultural agenda by region, category, type, town, day or date range
  • Fetch full details of one event, including dates, venue, price, description and links
  • List the week's cinema screenings with links and posters
  • Look up exact town names accepted by the town filter
When to use it
Useful when you want an assistant to find things to do in Catalonia: local cultural events, weekend plans, or what is showing at the cinema, with details pulled from surtdecasa.cat.
Requirements
A remote Streamable HTTP endpoint is available and needs no account or key. A local stdio mode can be run from the source with Node 20 or later. Network access to surtdecasa.cat is required.
Before you install
The remote endpoint is public and unauthenticated, so anyone with the URL can use it; the README suggests adding a token if you deploy your own. The site has no public API, so the server scrapes its HTML, and results depend on that page structure. All tools are read-only.

Installation

In SourceWeft

  1. Open Surt de Casa (surtdecasa.cat) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.pmontp19%2Fsurtdecasa-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "surt-de-casa-surtdecasa-cat": {
      "type": "http",
      "url": "https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"
    }
  }
}

README

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)

json
{  "mcp": {    "surtdecasa": {      "type": "remote",      "url": "https://surtdecasa-mcp.peremontpeo.workers.dev/mcp"    }  }}

Client local (stdio)

json
{  "mcp": {    "surtdecasa": {      "type": "local",      "command": ["node", "/ruta/a/surtdecasa-mcp/dist/index.js"]    }  }}

Desenvolupament

Requereix Node 20+.

bash
npm installnpm run build      # typecheck (stdio + workers) i compilar dist/npm run dev:cf     # wrangler dev local a http://localhost:8787/mcpnpm 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

Source: README.md at commit 8b726ce

Tools

4

cercar_agenda

Cercar a l'agenda

Cerca esdeveniments a l'agenda de surtdecasa.cat. Es pot filtrar per zona territorial, categoria, tipus (aire lliure, gratuït, nocturn), població, dies concrets (avui, dema, cap-de-setmana) o un rang de dates en format dd/mm/yyyy.

Parametersfizonainicitipuspoblaciocalendaricategoria

detall_esdeveniment

Detall d'un esdeveniment

Retorna tota la informació d'un esdeveniment de l'agenda (dates, lloc, poblacions, preu, descripció, enllaços). Requereix la URL o ruta que retorna cercar_agenda.

Parametersurlrequired

cartellera

Cartellera de cinema

Retorna les pel·lícules de la setmana a surtdecasa.cat amb el seu enllaç i cartell.

Takes no parameters.

poblacions

Cercar poblacions

Autocomplete de poblacions de surtdecasa.cat. Passa-hi un prefix o fragment de nom i retorna els noms exactes acceptats pel filtre poblacio de cercar_agenda.

Parameterstermerequired

Version history

2
  1. v0.1.1LatestSep 21, 2026
  2. v0.1.0Sep 19, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.