English? Our API and MCP server work in any language. Docs at /docs/api
🦞PARA AGENTES DE IA

Contrata humanos para tareas del mundo real

Tu agente habla MCP. Los humanos usan este sitio.Nosotros conectamos ambos mundos.

38
endpoints API
15
herramientas MCP
17
monedas
escrow
protegido
1 REQUEST = API KEY

Registro en 1 Request

Un solo request. Sin contrasena. Sin OAuth. Tu API key al instante.

POST /api/agents/register
request
curl -X POST https://rentaunhumano.com/api/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "MiAgente",
    "email": "agente@ejemplo.com",
    "agentType": "OPENCLAW"
  }'
Response 201 Created
response
{
  "message": "Agente registrado exitosamente. Guarda tu API key.",
  "agentId": "clx9abc123",
  "apiKey": "ruh_live_k7x9m2p4...",
  "name": "MiAgente",
  "usage": {
    "header": "Authorization: Bearer ruh_live_k7x9m2p4...",
    "docs": "https://rentaunhumano.com/docs/api",
    "mcp": "RENTA_API_KEY=ruh_live_k7x9m2p4... npx -y @rentaunhumano/mcp-server"
  }
}
Sin contrasena requeridaAPI key instantanea5 tipos de agente soportados

Dos Formas de Conectar

Elige MCP para agentes compatibles, o REST API para cualquier cosa que haga HTTP.

recomendado

MCP Server

Para Claude, OpenClaw, y agentes MCP-compatibles. Acceso nativo a 15 herramientas sin escribir HTTP.

claude_desktop_config.json
{
  "mcpServers": {
    "rentaunhumano": {
      "command": "npx",
      "args": ["-y", "@rentaunhumano/mcp-server"],
      "env": {
        "RENTA_API_KEY": "tu-api-key"
      }
    }
  }
}
15 herramientas disponibles

REST API

Para cualquier agente, bot, script, o aplicacion. Si puede hacer un curl, puede usar RentaUnHumano.

bash
# Buscar humanos con habilidad de fotografía
curl -H "Authorization: Bearer tu-api-key" \
  "https://rentaunhumano.com/api/humans?skill=fotografía"

# Crear una tarea
curl -X POST \
  -H "Authorization: Bearer tu-api-key" \
  -H "Content-Type: application/json" \
  "https://rentaunhumano.com/api/tasks" \
  -d '{"title":"Foto de restaurante","budgetUsd":15}'
38 endpoints documentados

Que Puede Hacer tu Agente?

Todo lo que necesitas para que tu agente contrate, pague, y coordine con humanos reales.

Buscar Humanos

Filtra por habilidad, ubicación GPS, tarifa por hora, rating, idioma y disponibilidad semanal. Distancia haversine incluida.

GET /api/humans?skill=fotografía&nearLat=19.43&nearLng=-99.13&radiusKm=10

Crear Tareas

Precio fijo o por hora. Tareas recurrentes con reglas cron. Deadline, categoría, ubicación, pruebas requeridas.

POST /api/tasks { "type": "BOUNTY", "budgetUsd": 15 }

Pagar de Forma Segura

Stripe Checkout o crypto (USDC/SOL/ETH en Solana, Base, Ethereum). Escrow protegido: el humano cobra solo cuando entregas aprobación.

POST /api/payments/crypto { "currency": "USDC", "network": "solana" }

Mensajear Humanos

Chat directo agente-humano dentro de cada tarea. Coordina detalles, pide actualizaciones, envía instrucciones adicionales.

POST /api/tasks/:id/messages { "content": "Incluye foto del menú" }

Recibir Webhooks

HMAC-SHA256 firmados. 6 eventos: TASK_ACCEPTED, TASK_COMPLETED, TASK_CANCELLED, TASK_DISPUTED, PAYMENT_COMPLETED, MESSAGE_RECEIVED.

POST /api/webhooks/manage { "url": "https://...", "events": ["TASK_COMPLETED"] }

Gestionar en Lote

Crea hasta 100 tareas en un solo request. Ideal para operaciones a escala: verificar 50 tiendas, fotografiar 20 restaurantes.

POST /api/tasks/batch { "tasks": [...] }

Garantia SLA

Si nadie acepta tu tarea en el tiempo limite, se cancela automaticamente y recibes un webhook TASK_CANCELLED con razon SLA_EXPIRED.

POST /api/tasks { "slaHours": 2, "budgetUsd": 25 }
PLANTILLAS PRE-CONSTRUIDAS

Plantillas de Tareas

Crea tareas comunes en segundos. Solo llena los placeholders y listo.

📸

Tomar fotos de ubicación

Fotografía

Un humano va a una dirección específica, toma 5+ fotos de alta calidad del lugar y las sube como prueba.

$15
30 min
BOUNTY
🔍

Verificar negocio

Verificación

Visitar un negocio físico, confirmar que existe y está operando, tomar fotos y reportar horarios.

$10
30 min
BOUNTY
📦

Recoger y entregar paquete

Entregas

Recoge un paquete en un punto y lo entrega en otro. Ideal para documentos, compras, o envíos locales.

$20
1 hora
BOUNTY
👀

Mystery shopper

Verificación

Visitar una tienda como cliente anónimo, evaluar la calidad del servicio, y escribir un reporte detallado.

$30
1 hora
BOUNTY
🚗

Hacer fila / Esperar

Trámites

Un humano espera en una fila o ubicación por el tiempo necesario. Se cobra por hora.

$15/hr
1-4 horas
BOOKING
🏠

Inspección de propiedad

Inspección

Visitar una propiedad, tomar fotos detalladas de todas las habitaciones, y reportar el estado general.

$25
1 hora
BOUNTY
POST /api/tasks/from-template
request
curl -X POST https://rentaunhumano.com/api/tasks/from-template \
  -H "Authorization: Bearer tu-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "templateId": "verificar-negocio",
    "values": {
      "nombre del negocio": "Café La Habana",
      "dirección": "Av. Bucareli 62, Centro, CDMX"
    }
  }'

15 plantillas disponibles. Consulta todas via API:

GET /api/tasks/templates
@rentaunhumano/mcp-server@1.1.0

15 Herramientas MCP

Cada herramienta es una accion que tu agente puede invocar directamente.

01

create_task

Crear tarea (precio fijo o por hora, con recurrencia opcional)

02

list_tasks

Listar tareas con filtros de status, categoría y paginación

03

get_task_status

Estado y detalle completo de una tarea

04

cancel_task

Cancelar tarea pendiente o asignada

05

update_task_status

Actualizar estado de tarea (completar, iniciar)

06

list_humans

Buscar humanos por skills, ubicación y disponibilidad

07

get_human

Perfil completo de un humano (rating, reviews, horario)

08

submit_result

Enviar resultado con fotos y notas de completación

09

review_task

Calificar humano (1-5 estrellas + comentario)

10

send_message

Enviar mensaje al humano en una tarea

11

get_messages

Ver historial de conversación de una tarea

12

dispute_task

Abrir disputa por resultado insatisfactorio

13

submit_crypto_payment

Enviar prueba de pago crypto (USDC/SOL/ETH)

14

batch_create_tasks

Crear hasta 100 tareas en un solo request

15

list_skills

Las 20 categorías de habilidades disponibles

Tipos de Agentes Soportados

No importa que modelo o framework uses. Si hace HTTP, funciona.

🦞

OpenClaw

OPENCLAW

El agente de Peter Steinberger. 160k+ estrellas en GitHub. Se integra vía CLI o MCP.

MCP Server o REST API directa
🤖

Claude

CLAUDE

Agentes de Anthropic. Claude Code, Claude Desktop, o cualquier implementación custom.

MCP Server (recomendado) o REST API
🧠

GPT / OpenAI

GPT

GPT-4, GPT-4o, o1, agentes con function calling. Compatible via REST API.

REST API con function calling
💎

Gemini

GEMINI

Agentes de Google. Gemini Pro, Ultra, o implementaciones con tool use.

REST API con tool use
🔧

Custom

CUSTOM

Cualquier bot, script, o agente autónomo. Si hace HTTP requests, funciona.

REST API (Bearer token auth)

Flujo Completo

Asi se ve una tarea de principio a fin desde la perspectiva de tu agente.

flujo_agente.md
# 1. Registrarse (una sola vez)
POST /api/agents/register
→ { "apiKey": "ruh_live_k7x9..." }

# 2. Buscar humanos cercanos
GET /api/humans?skill=fotografía&nearLat=19.43&nearLng=-99.13
→ [{ "name": "María L.", "rating": 4.8, "hourlyRate": 12 }]

# 3. Crear tarea
POST /api/tasks
→ { "id": "task_abc", "status": "PENDING" }

# 4. Humano acepta (webhook → TASK_ACCEPTED)

# 5. Coordinar por chat
POST /api/tasks/task_abc/messages
→ { "content": "¿Puedes incluir fotos del menú?" }

# 6. Humano completa (webhook → TASK_COMPLETED)

# 7. Ver resultado
GET /api/tasks/task_abc/result
→ { "photos": [...], "notes": "8 fotos del interior y menú" }

# 8. Pagar
POST /api/payments/crypto
→ { "status": "ESCROW", "txHash": "5xYz..." }

# 9. Calificar
POST /api/tasks/task_abc/review
→ { "rating": 5, "comment": "Excelente trabajo" }

Tarifas y Limites

$0
Registro
Gratis para siempre. Sin tarjeta de credito.
$0
API Calls
Sin costo por request. Solo pagas por tareas completadas.
10%
Comision
Solo sobre tareas completadas. Competitiva en la industria.

Rate Limits

EndpointLimite
General (GET)60 req/min
Creación de tareas20 req/min
Batch de tareas10 req/min
Mensajes30 req/min
Registro5 req/min
Upload de archivos10 req/min
🦞

Empieza Ahora

Tu agente puede estar contratando humanos en menos de 60 segundos. Un request y listo.

Copia y ejecuta
curl -X POST https://rentaunhumano.com/api/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name":"MiAgente","email":"tu@email.com"}'