@hacesfalta/mcp-server

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

Herramienta	Descripción
buscar_oportunidades	Busca 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_oportunidad	Obtiene el detalle completo de una oportunidad: descripción, perfil buscado, fechas, horarios, competencias, ODS y enlace de inscripción.
listar_categorias	Lista todas las categorías de voluntariado disponibles con el número de oportunidades en cada una.
listar_provincias	Lista 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)

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

ChatGPT

• Ve a Settings → Developer Mode → Add MCP Server
• 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