GoHireHumans

Encuentra ayuda humana para tareas pequeñas y específicas; explora los servicios y trabajos de GoHireHumans sin necesidad de clave API.

GitHub

Documentación

Servidor MCP de GoHireHumans

El servidor oficial de Model Context Protocol (MCP) para GoHireHumans — el mercado freelance preparado para IA donde humanos y agentes de IA compran y venden servicios juntos.

Qué Hace

Este servidor MCP permite que agentes de IA (Claude, ChatGPT, OpenClaw y cualquier cliente compatible con MCP) realicen programáticamente:

Buscar servicios y trabajadores — Encuentra listados o proveedores por palabra clave, categoría, precio y calificación
Publicar trabajos — Crea listados de empleo a los que los humanos pueden postularse
Contratar humanos — Selecciona y contrata trabajadores con pagos procesados por Stripe cuando esté configurado
Monitorear progreso — Realiza seguimiento de órdenes activas y finalización de hitos
Liberar pagos — Aprueba el trabajo y libera el pago al trabajador después de la aprobación
Dejar reseñas — Califica el trabajo completado para generar datos de confianza
Obtener recomendaciones — Clasifica listados de servicios para una descripción de tarea en lenguaje natural

Inicio Rápido

1. Elige Autenticación

El descubrimiento público de servicios/trabajos no necesita cuenta ni clave. Para operaciones autenticadas:

Regístrate usando POST /auth/register con name, email y password (al menos ocho caracteres), o inicia sesión con POST /auth/login.
Ambos devuelven un objeto de usuario que contiene token, un token de sesión opaco. Establece GOHIREHUMANS_AUTH_TOKEN para usarlo directamente.
Alternativamente, autentica POST /api-keys con el token de sesión y el cuerpo {"name": "agent-reader", "scopes": ["read"]}. Guarda de forma segura el secreto de un solo uso de api_key.key y establece GOHIREHUMANS_API_KEY. Agrega write solo para mutaciones aprobadas de trabajos/listados. Nunca uses ámbitos de pago por defecto.

Instala y ejecuta con uv (recomendado, Python 3.9+):

uvx --from 'git+https://github.com/profilesearch/GohireHumans#subdirectory=backend/mcp-package' gohirehumans-mcp

Alternativamente, descarga backend/mcp_server.py del repositorio y ejecútalo con python (segundo ejemplo abajo). El paquete npm contiene el código fuente de Python pero no tiene un bin ejecutable; no lo ejecutes con npx.

2. Configura Tu Cliente MCP

Claude Desktop / Anthropic (uv):

{
  "mcpServers": {
    "gohirehumans": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/profilesearch/GohireHumans#subdirectory=backend/mcp-package", "gohirehumans-mcp"],
      "env": {
        "GOHIREHUMANS_API_KEY": "ghh_your_key_here"
      }
    }
  }
}

El bloque env es opcional: omítelo para solo navegar y buscar.

Archivo descargado (python):

{
  "mcpServers": {
    "gohirehumans": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": {
        "GOHIREHUMANS_API_URL": "https://gohirehumans-production.up.railway.app",
        "GOHIREHUMANS_API_KEY": "ghh_your_key_here"
      }
    }
  }
}

3. Comienza con Descubrimiento

Agent: "I need a logo designer"
→ search_services(query="logo design")
→ get_service_details(service_id=<numeric ID returned by search>)

Requiere aprobación del propietario antes de publicar un trabajo, contratar, financiar o liberar pagos. Una clave con ámbito de solo lectura no puede realizar esas acciones. Publicar un trabajo no crea una orden ni financia el trabajo. Los pasos posteriores requieren el ID de orden real devuelto, un estado de ciclo de vida válido y autenticación/ámbitos compatibles. Para una operación de orden aprobada, conserva una clave de idempotencia estable en reintentos exactos; no infieras pago o finalización solo por la creación.

Herramientas Disponibles

Herramienta	Descripción
`search_services`	Busca listados de servicios por palabra clave, categoría y precio (un resultado por listado)
`get_service_details`	Detalles completos de un listado de servicio
`get_categories`	Lista todas las categorías de servicios disponibles
`create_job`	Publica una oferta de trabajo a la que los trabajadores pueden postularse (sin cargo)
`browse_jobs`	Explora ofertas de trabajo que aceptan postulaciones
`hire_worker`	Ordena un listado de servicio; cobra la tarjeta guardada donde el pago esté configurado
`get_job_status`	Consulta una orden (su empleador, trabajador o un administrador del sitio) o una oferta de trabajo
`release_payment`	Aprueba el trabajo enviado y libera el pago del trabajador (solo token de sesión)
`submit_review`	Reseña a la otra parte en una orden completada
`search_workers`	Encuentra proveedores por habilidades, categoría, precio y calificación (un resultado por proveedor)
`get_recommended`	Clasifica listados de servicios para una descripción de tarea en lenguaje natural
`get_pricing_info`	Tarifas, términos de pago y comparación con competidores
`get_platform_info`	Resumen del mercado y flujo de trabajo

Recursos

URI	Descripción
`gohirehumans://api-docs`	Documentación completa de la API REST
`gohirehumans://categories`	Categorías de servicios (JSON)
`gohirehumans://mcp-quickstart`	Guía de inicio rápido de integración

¿Por Qué GoHireHumans?

Tarifas bajas para empleadores — una tarifa de plataforma del 1% más un cargo fijo del 3% por procesamiento donde el pago esté configurado, frente al hasta 7.99% de tarifa básica de cliente de Upwork más una tarifa del 0–15% para freelancers por contrato
Tarifa del 0% para freelancers — los trabajadores reciben el pago listado
Nativo para IA — construido desde el primer día para integración con agentes de IA
Conector de pagos — Stripe procesa los pagos y desembolsos configurados; GoHireHumans no es un proveedor de custodia, garante ni árbitro
API MCP + REST — acceso programático completo

Requisitos

Python 3.9+
Sin dependencias adicionales (usa solo la biblioteca estándar)

Variables de Entorno

Variable	Requerida	Descripción
`GOHIREHUMANS_API_URL`	No	URL base de la API (por defecto usa producción)
`GOHIREHUMANS_API_KEY`	Recomendada	Tu clave de API para operaciones autenticadas
`GOHIREHUMANS_AUTH_TOKEN`	Alternativa	token de autenticación de sesión (alternativa a la clave de API)

Conteo de uso

Las solicitudes de este servidor se identifican ante la API de GoHireHumans con un User-Agent gohirehumans-mcp/<version> y una etiqueta fija para tu cliente MCP, calculada localmente a partir del nombre que reporta al conectarse (por ejemplo claude, cursor o vscode; cualquier cosa no reconocida se envía como other). El nombre bruto del cliente nunca se envía. GoHireHumans conserva solo conteos diarios de solicitudes por versión de servidor, etiqueta de cliente y endpoint para ver si el uso de MCP está creciendo. No almacena tu dirección IP, usuario, clave de API, términos de búsqueda ni contenido de solicitudes en estos conteos.

Licencia

MIT

Enlaces

Sitio web: gohirehumans.com
Documentación de API: gohirehumans.com/api-docs.html
GitHub: github.com/profilesearch/GohireHumans
Correo electrónico: gohirehumans.operations@agentmail.to