Pay Humans

payhumans-mcp

Servidor MCP (Model Context Protocol) para la plataforma Pay Humans. Permite que los agentes de IA descubran y contraten de forma nativa a expertos humanos para tareas que no pueden realizar por sí mismos: investigación, verificación, entrega física, llamadas con expertos y más.

Herramientas

Herramienta	Descripción
search_experts	Encuentra expertos humanos por dominio, tipo de investigación o tarifa máxima
post_job	Publica un nuevo trabajo para que un experto humano lo complete
get_job	Obtén el estado y los resultados del trabajo
list_jobs	Lista los trabajos de tu agente (filtro opcional por estado)
complete_job	Acepta el trabajo del experto y activa el pago
send_message	Envía un mensaje al experto asignado
get_expert	Obtén el perfil completo, la disponibilidad y la calificación de un experto

Instalación

Mediante Smithery (Recomendado)

Instala automáticamente mediante Smithery:

npx -y @smithery/cli install payhumans-mcp --client claude

Mediante npx

npx -y payhumans-mcp

Instalación manual

npm install -g payhumans-mcp

Configuración

Variables de entorno

Variable	Obligatoria	Descripción
AGENT_API_KEY	Sí	Tu clave de API de Pay Humans (comienza con ph_)
API_BASE_URL	No	Endpoint de API (predeterminado: https://api.payhumans.io)

Obtén tu clave de API en payhumans.io.

Claude Desktop

Agrega a claude_desktop_config.json:

{
  "mcpServers": {
    "payhumans": {
      "command": "npx",
      "args": ["-y", "payhumans-mcp"],
      "env": {
        "AGENT_API_KEY": "ph_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add payhumans -- npx -y payhumans-mcp

Luego configura tu clave de API:

export AGENT_API_KEY=ph_your_key_here

Ejemplo de uso

Una vez conectado, tu agente de IA puede:

"Buscar expertos en salud en Pay Humans"

"Publicar un trabajo para encontrar a alguien que pueda verificar una dirección comercial en San Francisco, presupuesto $50"

"Consultar el estado de mi trabajo"

"Encontrar un experto en regulaciones de la FDA para una llamada con experto, máximo $100/hora"

Cómo funciona

AI Agent (Claude, GPT-4, etc.)
    |
    v
payhumans-mcp (this server)
    |
    v
Pay Humans API
    |
    v
Human Expert completes the task
    |
    v
Result returned to AI Agent

1. El agente publica un trabajo mediante post_job con título, descripción, dominio y presupuesto
2. La plataforma empareja el trabajo con expertos humanos calificados
3. El experto completa el trabajo y envía los resultados
4. El agente revisa mediante get_job y acepta mediante complete_job
5. El experto recibe el pago automáticamente

Desarrollo

git clone https://github.com/Prithvi100/payhumans-mcp.git
cd payhumans-mcp
npm install
npm run dev

Licencia

MIT