English Français العربية

io.github.HazloPosible/hacesfalta-mcp

Official registry Search and web

Search volunteer opportunities across Spain via hacesfalta.org

Source code 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).

NPM package @hacesfalta/mcp-server
Claude Code 
claude mcp add hacesfalta-mcp -e 'HACESFALTA_API_URL=<HACESFALTA_API_URL>' -e 'HACESFALTA_API_KEY=<your hacesfalta_api_key>' -- npx -y @hacesfalta/mcp-server@1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hacesfalta-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@hacesfalta/mcp-server@1.0.1"
            ],
            "env": {
                "HACESFALTA_API_URL": "<HACESFALTA_API_URL>",
                "HACESFALTA_API_KEY": "<your hacesfalta_api_key>"
            }
        }
    }
}

Environment variables

  • HACESFALTA_API_URL required Base URL of the HaceFalta API
  • HACESFALTA_API_KEY required secret API key for authenticating with the HaceFalta API

Documentation

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

Contents
  1. HaceFalta MCP Server
  2. Herramientas disponibles
  3. Conexión remota (Claude, ChatGPT, Gemini)
  4. Conexión local (Claude Desktop)
  5. Ejemplo de uso
  6. Sobre hacesfalta.org
  7. Licencia

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:

{
  "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

Frequently asked questions

What is io.github.HazloPosible/hacesfalta-mcp?

Search volunteer opportunities across Spain via hacesfalta.org

How do I install io.github.HazloPosible/hacesfalta-mcp?

It runs on your machine. In Claude Code: claude mcp add hacesfalta-mcp -e 'HACESFALTA_API_URL=<HACESFALTA_API_URL>' -e 'HACESFALTA_API_KEY=<your hacesfalta_api_key>' -- npx -y @hacesfalta/mcp-server@1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.HazloPosible/hacesfalta-mcp need an API key?

Yes. It expects HACESFALTA_API_URL, HACESFALTA_API_KEY, which you set in its configuration.

Is io.github.HazloPosible/hacesfalta-mcp open source?

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

Who maintains io.github.HazloPosible/hacesfalta-mcp?

It is published by HazloPosible. 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.