HALPII
Directorio público de profesionales de oficios en Latinoamérica: buscar, ver perfiles y oficios.
Should I use this
Quality & Safety
Findings (2)
- HIGH
- MEDIUMin ver_perfil
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"directorio": {
"url": "https://mcp.halpii.com/mcp"
}
}
}Remote endpoints
https://mcp.halpii.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢buscar_profesionales(necesidad, oficio, ciudad, pais, limite)
Busca profesionales de oficios en una ciudad o distrito de Latinoamérica (Perú, Colombia, México, Chile y más) en el directorio público de HALPII. Recibe la necesidad en palabras de la persona («se rompió el caño de la cocina») o el oficio («gasfitero»), deduce el oficio y devuelve hasta 6 profesionales con nombre público, oficios, zona, calificación, número de reseñas, si está verificado, actividad reciente, señales reales de HALPII (pedidos respondidos, veces elegido, mes de alta, años de experiencia), una breve descripción y el enlace a su perfil, más oficios relacionados y un enlace para ver más. Vienen ordenados: activos hace poco, verificados, con reseñas o pedidos respondidos; quien lleva más de 45 días sin actividad solo aparece si no hay suficientes. No devuelve teléfonos ni correos: el contacto se hace desde el perfil. La ciudad es obligatoria. Los enlaces incluyen parámetros de origen (via, utm_source, utm_medium). EN: Search tradespeople in Latin America by need or trade and city; returns up to 6 public profiles with links, no contact data.
Input Schema
{
"type": "object",
"properties": {
"necesidad": {
"description": "Lo que necesita, en sus palabras: «se fue la luz en la cocina», «pintar dos cuartos»",
"type": "string",
"minLength": 2,
"maxLength": 300
},
"oficio": {
"description": "Oficio si ya se conoce: «gasfitero», «electricista». Opcional si hay necesidad",
"type": "string",
"minLength": 2,
"maxLength": 80
},
"ciudad": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "Ciudad o distrito que dijo la persona: «Lima», «Miraflores», «Arequipa», «Cali»"
},
"pais": {
"description": "País en español: «Perú», «Colombia». Opcional; ayuda si la ciudad existe en varios países",
"type": "string",
"minLength": 2,
"maxLength": 40
},
"limite": {
"default": 6,
"description": "Cuántos profesionales devolver (1-6)",
"type": "integer",
"minimum": 1,
"maximum": 6
}
},
"required": [
"ciudad"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"necesidad": {
"type": [
"string",
"null"
]
},
"oficio": {
"anyOf": [
{
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"nombre": {
"type": "string"
}
},
"required": [
"slug",
"nombre"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Oficio que HALPII dedujo de la necesidad; null si no lo reconoció"
},
"oficios_relacionados": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"nombre": {
"type": "string"
}
},
"required": [
"slug",
"nombre"
],
"additionalProperties": false
},
"description": "Otros oficios que podrían servir"
},
"ciudad": {
"type": "string"
},
"pais": {
"type": [
"string",
"null"
]
},
"total": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Profesionales que coinciden en HALPII (puede ser mayor que los devueltos)"
},
"profesionales": {
"type": "array",
"items": {
"type": "object",
"properties": {
"nombre": {
"type": "string"
},
"oficios": {
"type": "array",
"items": {
"type": "string"
}
},
"zona": {
"type": "object",
"properties": {
"ciudad": {
"type": [
"string",
"null"
]
},
"pais": {
"type": [
"string",
"null"
]
}
},
"required": [
"ciudad",
"pais"
],
"additionalProperties": false
},
"calificacion": {
"description": "Promedio 1-5; null si aún no tiene reseñas",
"type": [
"number",
"null"
]
},
"numero_resenas": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"verificado": {
"type": "boolean"
},
"descripcion": {
"type": [
"string",
"null"
]
},
"precio_desde": {
"description": "Tarifa de referencia que publicó el profesional, si la hay",
"type": [
"string",
"null"
]
},
"actividad": {
"description": "Última actividad aproximada: hoy, semana, mes o inactivo (más de 30 días)",
"type": [
"string",
"null"
]
},
"activo_ultimos_45_dias": {
"description": "true si se conectó en los últimos 45 días; false si lleva más; null si no se sabe. Si es false, dilo al mostrarlo",
"type": [
"boolean",
"null"
]
},
"confianza": {
"anyOf": [
{
"type": "object",
"properties": {
"pedidos_respondidos": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Pedidos de clientes a los que respondió en HALPII"
},
"veces_elegido": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Pedidos en los que el cliente dijo haberlo elegido"
},
"en_halpii_desde": {
"description": "Mes de alta en HALPII (AAAA-MM)",
"type": [
"string",
"null"
]
},
"anios_experiencia": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Años de experiencia que declaró el profesional; null si no los declaró"
}
},
"required": [
"pedidos_respondidos",
"veces_elegido",
"en_halpii_desde",
"anios_experiencia"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"nombre",
"oficios",
"zona",
"calificacion",
"numero_resenas",
"verificado",
"descripcion",
"precio_desde",
"actividad",
"activo_ultimos_45_dias",
"confianza",
"url"
],
"additionalProperties": false
},
"description": "Hasta 6; muestra los 3 primeros"
},
"ver_mas_url": {
"type": "string",
"description": "Página web con la lista completa del oficio en la ciudad"
},
"enlace_pedido": {
"type": "string",
"description": "Enlace para publicar un pedido y recibir hasta 3 propuestas"
},
"mensaje": {
"type": "string"
}
},
"required": [
"necesidad",
"oficio",
"oficios_relacionados",
"ciudad",
"pais",
"total",
"profesionales",
"ver_mas_url",
"enlace_pedido",
"mensaje"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢ver_perfil(perfil, slug, url)
Devuelve la ficha pública de un profesional de HALPII (lo mismo que ve cualquiera en portal.halpii.com sin iniciar sesión): descripción, oficios, zona y distritos que atiende, calificación, reseñas recientes, trabajos del portafolio con imágenes, servicios con la tarifa de referencia que publicó y el enlace al perfil. No incluye teléfono ni correo. Entrada: el enlace de un perfil de HALPII (https://portal.halpii.com/perfil/…) o su slug. Los enlaces incluyen parámetros de origen (via, utm_source, utm_medium). EN: Get a HALPII professional's public profile (reviews, portfolio, services) by profile link or slug.
Input Schema
{
"type": "object",
"properties": {
"perfil": {
"description": "Enlace https://portal.halpii.com/perfil/<slug> o el slug",
"type": "string",
"minLength": 3,
"maxLength": 400
},
"slug": {
"description": "Alternativa: el slug del perfil",
"type": "string",
"minLength": 3,
"maxLength": 400
},
"url": {
"description": "Alternativa: el enlace del perfil",
"type": "string",
"minLength": 3,
"maxLength": 400
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Output Schema
{
"type": "object",
"properties": {
"nombre": {
"type": "string"
},
"titulo": {
"type": [
"string",
"null"
]
},
"descripcion": {
"type": [
"string",
"null"
]
},
"oficios": {
"type": "array",
"items": {
"type": "string"
}
},
"zona": {
"type": "object",
"properties": {
"ciudad": {
"type": [
"string",
"null"
]
},
"pais": {
"type": [
"string",
"null"
]
},
"distritos": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"ciudad",
"pais",
"distritos"
],
"additionalProperties": false
},
"anios_experiencia": {
"type": [
"number",
"null"
]
},
"verificado": {
"type": "boolean"
},
"atiende_emergencias": {
"type": "boolean"
},
"calificacion": {
"type": [
"number",
"null"
]
},
"numero_resenas": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"idiomas": {
"type": "array",
"items": {
"type": "string"
}
},
"servicios": {
"type": "array",
"items": {
"type": "object",
"properties": {
"servicio": {
"type": "string"
},
"oficio": {
"type": [
"string",
"null"
]
},
"precio_desde": {
"type": "string"
}
},
"required": [
"servicio",
"oficio",
"precio_desde"
],
"additionalProperties": false
}
},
"resenas_recientes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"nota": {
"type": "number"
},
"texto": {
"type": [
"string",
"null"
]
},
"fecha": {
"type": [
"string",
"null"
]
}
},
"required": [
"nota",
"texto",
"fecha"
],
"additionalProperties": false
}
},
"portafolio": {
"type": "array",
"items": {
"type": "object",
"properties": {
"titulo": {
"type": "string"
},
"descripcion": {
"type": [
"string",
"null"
]
},
"fecha": {
"type": [
"string",
"null"
]
},
"distrito": {
"type": [
"string",
"null"
]
},
"imagenes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"titulo",
"descripcion",
"fecha",
"distrito",
"imagenes"
],
"additionalProperties": false
}
},
"miembro_desde": {
"type": [
"string",
"null"
]
},
"confianza": {
"anyOf": [
{
"type": "object",
"properties": {
"pedidos_respondidos": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Pedidos de clientes a los que respondió en HALPII"
},
"veces_elegido": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Pedidos en los que el cliente dijo haberlo elegido"
},
"en_halpii_desde": {
"description": "Mes de alta en HALPII (AAAA-MM)",
"type": [
"string",
"null"
]
},
"anios_experiencia": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Años de experiencia que declaró el profesional; null si no los declaró"
}
},
"required": [
"pedidos_respondidos",
"veces_elegido",
"en_halpii_desde",
"anios_experiencia"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"url": {
"type": "string"
}
},
"required": [
"nombre",
"titulo",
"descripcion",
"oficios",
"zona",
"anios_experiencia",
"verificado",
"atiende_emergencias",
"calificacion",
"numero_resenas",
"idiomas",
"servicios",
"resenas_recientes",
"portafolio",
"miembro_desde",
"confianza",
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢listar_oficios(buscar, ciudad, pais, limite)
Lista los oficios que existen en HALPII (nombre oficial, plural y otros nombres: «gasfitero» = plomero, fontanero…). Si se indica ciudad o país, incluye cuántos profesionales hay de cada oficio y ordena por ese número. EN: List the trades available on HALPII, optionally with professional counts for a city or country.
Input Schema
{
"type": "object",
"properties": {
"buscar": {
"description": "Filtra por texto: «techo», «aire», «limpieza»",
"type": "string",
"minLength": 2,
"maxLength": 60
},
"ciudad": {
"description": "Ciudad para contar profesionales: «Lima»",
"type": "string",
"minLength": 2,
"maxLength": 80
},
"pais": {
"description": "País para contar profesionales: «Perú»",
"type": "string",
"minLength": 2,
"maxLength": 40
},
"limite": {
"default": 40,
"description": "Máximo de oficios a devolver",
"type": "integer",
"minimum": 1,
"maximum": 200
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"total_oficios": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"devueltos": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"ambito_conteo": {
"anyOf": [
{
"type": "object",
"properties": {
"pais": {
"type": [
"string",
"null"
]
},
"ciudad": {
"type": [
"string",
"null"
]
}
},
"required": [
"pais",
"ciudad"
],
"additionalProperties": false
},
{
"type": "null"
}
],
"description": "Ámbito real de los conteos. Si ciudad es null, el conteo es del país entero."
},
"oficios": {
"type": "array",
"items": {
"type": "object",
"properties": {
"slug": {
"type": "string"
},
"nombre": {
"type": "string"
},
"plural": {
"type": "string"
},
"tambien_llamado": {
"type": "array",
"items": {
"type": "string"
}
},
"profesionales": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
{
"type": "null"
}
],
"description": "Cuántos hay en el ámbito indicado; null si no se pidió conteo"
}
},
"required": [
"slug",
"nombre",
"plural",
"tambien_llamado",
"profesionales"
],
"additionalProperties": false
}
},
"mensaje": {
"type": "string"
}
},
"required": [
"total_oficios",
"devueltos",
"ambito_conteo",
"oficios",
"mensaje"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢crear_enlace_pedido(oficio, ciudad, descripcion, cuando)
Arma un enlace a portal.halpii.com/solicitar con el oficio y la ciudad ya llenos. No publica nada, no envía datos y no recibe datos personales. La persona abre el enlace, confirma su pedido en el portal (ahí deja su contacto) y recibe hasta 3 propuestas de profesionales de su zona. El enlace incluye parámetros de origen (via, utm_source, utm_medium). EN: Only builds a prefilled link to HALPII's request form; nothing is submitted and no personal data is collected.
Input Schema
{
"type": "object",
"properties": {
"oficio": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "Oficio o necesidad: «gasfitero», «arreglar una fuga»"
},
"ciudad": {
"type": "string",
"minLength": 2,
"maxLength": 80,
"description": "Ciudad o distrito que dijo la persona: «Surco»"
},
"descripcion": {
"description": "Qué necesita (no se envía; se devuelve para que la persona lo escriba en el formulario)",
"type": "string",
"maxLength": 500
},
"cuando": {
"description": "Para cuándo: «hoy», «esta semana» (no se envía)",
"type": "string",
"maxLength": 80
}
},
"required": [
"oficio",
"ciudad"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"url": {
"type": "string"
},
"oficio": {
"type": "string"
},
"ciudad": {
"type": "string"
},
"oficio_reconocido": {
"type": "boolean"
},
"prellenado": {
"type": "array",
"items": {
"type": "string"
},
"description": "Campos que el formulario recibe ya llenos"
},
"para_copiar": {
"description": "Detalles que la persona debe escribir ella misma en el formulario",
"type": [
"string",
"null"
]
},
"mensaje": {
"type": "string"
}
},
"required": [
"url",
"oficio",
"ciudad",
"oficio_reconocido",
"prellenado",
"para_copiar",
"mensaje"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Community
Evidence