mcpField
H
hacesfalta-mcp

hacesfalta-mcp

Remote
github.com/HazloPosibleSearch0Updated 14w ago
Repository

About hacesfalta-mcp

hacesfalta-mcp lets AI agents search volunteer opportunities listed on hacesfalta.org in Spain. It supports filters, paginated results, opportunity details, and direct signup links.

Key features

  1. 01Search by province and category
  2. 02Filter by schedule and participant criteria
  3. 03Paginated opportunity results
  4. 04Retrieve full opportunity details
  5. 05List categories and provinces

Use cases

  1. 01Finding weekend volunteering in Madrid
  2. 02Checking opportunities suitable for families or groups
  3. 03Reviewing roles before following signup links

MCP support

The MCP server exposes search, opportunity-detail, category-listing, and province-listing tools. It can be connected remotely through its MCP URL or locally through Claude Desktop configuration.

#voluntariado#volunteering#spain#nonprofit#social-impact#hacesfalta

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "hacesfalta": {
      "command": "npx",
      "args": [
        "-y",
        "@hacesfalta/mcp-server"
      ],
      "env": {
        "HACESFALTA_API_URL": "<HACESFALTA_API_URL>",
        "HACESFALTA_API_KEY": "<HACESFALTA_API_KEY>"
      }
    }
  }
}
Run commandnpx -y @hacesfalta/mcp-server
Environment variables to set
HACESFALTA_API_URLBase URL of the HaceFalta API
HACESFALTA_API_KEYSecretAPI key for authenticating with the HaceFalta API

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@hacesfalta/mcp-server1.0.1

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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:

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

Comments

Markdown supported

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.