Hacesfalta Mcp

io.github.HazloPosiblePublished by GitHub account HazloPosiblev1.0.1Updated Oct 24, 2026

Search volunteer opportunities across Spain via hacesfalta.org

VerifiedSTDIODesktop onlyLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

Searches volunteer opportunities across Spain on hacesfalta.org, letting an assistant find and detail listings by province, category and schedule.

What you can do
  • Search volunteer opportunities by province, category, frequency, schedule, age, weekend, family or group, with paginated results and sign-up links
  • Read the full detail of one opportunity: description, sought profile, dates, hours, skills, SDGs and sign-up link
  • List all volunteering categories with the number of opportunities in each
  • List all Spanish provinces that have volunteer opportunities
When to use it
Useful when someone wants conversational help finding volunteering in Spain, for example matching a city, cause and weekend availability to real listings with sign-up links.
Requirements
Runs as a local Node.js process from the npm package, or as a remote MCP endpoint. Requires the HACESFALTA_API_URL base URL and the HACESFALTA_API_KEY secret, both set as environment variables. Network access to the HaceFalta API.
Before you install
An API key (HACESFALTA_API_KEY) must be supplied; keep it out of shared config files. The server is read-only toward the catalog, but sign-up happens on the external hacesfalta.org site, and queries are sent to the HaceFalta API.

Installation

In SourceWeft

  1. Open Hacesfalta Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

HaceFalta MCP Server

Servidor MCP (Model Context Protocol) que expone el catálogo de oportunidades de voluntariado de hacesfalta.org — la principal plataforma de voluntariado en España — para que agentes de IA puedan ayudar a las personas a encontrar oportunidades de voluntariado mediante conversación natural.

Herramientas disponibles

HerramientaDescripción
buscar_oportunidadesBusca oportunidades por provincia, categoría, frecuencia, horario, edad, fin de semana, en familia o en grupo. Devuelve resultados paginados con enlaces de inscripción.
detalle_oportunidadObtiene el detalle completo de una oportunidad: descripción, perfil buscado, fechas, horarios, competencias, ODS y enlace de inscripción.
listar_categoriasLista todas las categorías de voluntariado disponibles con el número de oportunidades en cada una.
listar_provinciasLista todas las provincias españolas con oportunidades de voluntariado.

Conexión remota (Claude, ChatGPT, Gemini)

URL del servidor MCP:

https://hacesfalta-mcp.hacesfalta.workers.dev/mcp

Claude (web y móvil)

  1. Ve a Settings → Connectors → Add MCP Server
  2. Introduce la URL: https://hacesfalta-mcp.hacesfalta.workers.dev/mcp

ChatGPT

  1. Ve a Settings → Developer Mode → Add MCP Server
  2. Introduce la URL: https://hacesfalta-mcp.hacesfalta.workers.dev/mcp

Conexión local (Claude Desktop)

Añade a tu claude_desktop_config.json:

json
{  "mcpServers": {    "hacesfalta": {      "command": "node",      "args": ["path/to/hacesfalta-mcp/dist/index.js"],      "env": {        "HACESFALTA_API_URL": "https://api.hacesfalta.org",        "HACESFALTA_API_KEY": "YOUR_API_KEY"      }    }  }}

Ejemplo de uso

Un usuario le dice a su agente de IA:

"Quiero hacer voluntariado con personas mayores en Madrid los fines de semana"

El agente usa buscar_oportunidades con los filtros provincia: "Madrid", categoria: "Mayores", fin_de_semana: true y devuelve oportunidades relevantes con enlaces directos a hacesfalta.org para inscribirse.

Sobre hacesfalta.org

hacesfalta.org es la plataforma de referencia de voluntariado en España, gestionada por la Fundación HazloPosible. Conecta a personas con ganas de ayudar con organizaciones que necesitan voluntarios.

Licencia

MIT

Source: README.md at commit bc4374c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

40% 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 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.