# HALPII

> HALPII is a free MCP server for home services. Find tradespeople across Latin America by trade and city from an AI assistant. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://portal.halpii.com/agentes
- **MCP Registry name:** com.halpii/directorio
- **Categories:** home services, local services
- **Listing updated:** 2026-11-15

## About

HALPII is a marketplace where a customer describes a job and up to three nearby professionals reply with proposals. The connector gives assistants the directory side of that: search by trade or need and city, open a public profile, list trades, and prepare a link for the user to post a request. It does not create requests or accounts and never returns phone numbers or emails.

The directory covers Peru and 12 other Latin American countries and more than 190 trades, including plumbers, electricians and painters. Professionals pay to respond to each request; customers pay nothing to ask or receive proposals.

The page is in Spanish. Adding the connector in Claude needs no login. ChatGPT and Gemini support is described as coming soon.

## Features

- **Trade and city search:** Finds professionals by trade or need, city and country.
- **Public profiles:** Shows a professional's public profile.
- **Trade catalogue:** Lists the 190+ trades available.
- **Request link:** Builds the link where the user posts a request and gets up to three proposals.
- **Read-only, no login:** Does not create anything and needs no account.

## Good for

- Ask an assistant for a plumber in a given Lima district
- Compare electricians in a city
- See which trades are available in a country
- Send a user to post a job request

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http directorio https://mcp.halpii.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.halpii.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "directorio": {
      "url": "https://mcp.halpii.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "directorio": {
      "type": "http",
      "url": "https://mcp.halpii.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "directorio": {
      "serverUrl": "https://mcp.halpii.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "directorio": {
      "type": "http",
      "url": "https://mcp.halpii.com/mcp"
    }
  }
}
```

## Tools

- `buscar_profesionales`: 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, activid
- `ver_perfil`: 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:
- `listar_oficios`: 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.
- `crear_enlace_pedido`: 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 re

## FAQ

### Does the connector place orders?

No. It is read-only and only prepares the link for the user.

### Does it reveal contact details?

No. Phone numbers and emails are never returned; contact goes through portal.halpii.com.

### Who pays?

Professionals pay to respond; the customer does not pay to ask or receive proposals.

### Which countries are covered?

Peru plus 12 other Latin American countries.

### Is HALPII free?

Yes. HALPII is free to use.

### How do I add HALPII to Claude Code?

Run this command in your terminal: claude mcp add --transport http directorio https://mcp.halpii.com/mcp

### What are the best alternatives to HALPII?

The closest alternatives to HALPII are MadMax Trade Supply parts, Later Stages, Virkly CVR, MaineMCP and Renta.

## Alternatives

- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.
- [Virkly CVR](https://ai-powered.com/mcp/virkly-cvr): Virkly CVR is a free MCP server for local services.
- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.
- [Renta](https://ai-powered.com/mcp/renta): Renta is a paid MCP server for e-commerce.
- [Tulsa Ecosystem Map](https://ai-powered.com/mcp/tulsa-ecosystem-map): Tulsa Ecosystem Map is a free MCP server for knowledge and memory.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [Agent Bookability Index](https://ai-powered.com/mcp/agent-bookability-index): Agent Bookability Index is a free MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/halpii
