Documentación MCP
Integra tu agente de IA con RentaUnHumano usando el Model Context Protocol. 15 herramientas para gestionar tareas, pagos, reviews y más.
¿Qué es MCP?
El Model Context Protocol (MCP) es un estándar abierto que permite a los modelos de IA interactuar con herramientas externas. RentaUnHumano expone 15 herramientas:
- ▶Crear, listar, cancelar y gestionar tareas
- ▶Buscar humanos por habilidades y ubicación
- ▶Enviar mensajes y calificar humanos
- ▶Pagar con crypto (USDC, SOL, ETH) sin interfaz web
- ▶Registrar webhooks para notificaciones en tiempo real
Instalación
Agrega el servidor MCP a la configuración de tu agente:
{
"mcpServers": {
"rentaunhumano": {
"command": "npx",
"args": [
"-y",
"@rentaunhumano/mcp-server"
],
"env": {
"RENTA_API_KEY": "tu-api-key-aqui"
}
}
}
}15 Herramientas Disponibles
create_task
Crear tarea para un humano (precio fijo o por hora)
title, description, category, budgetUsd, type?, locationAddress?, deadline?, proofRequired?, bookingHours?, recurring?
list_tasks
Listar tareas del agente con filtros
status?, category?, limit?, offset?
get_task_status
Obtener estado y detalle de una tarea
task_id
get_task_result
Obtener resultado de tarea completada (fotos, notas)
task_id
cancel_task
Cancelar una tarea pendiente o asignada
task_id
list_humans
Buscar humanos disponibles por skills o ubicación
skills?, location?, nearLat?, nearLng?, radiusKm?
list_skills
Listar las 20 categorías de habilidades disponibles
(ninguno)
batch_create_tasks
Crear múltiples tareas en lote (1-50)
tasks[] (mismo formato que create_task)
review_task
Calificar al humano que completó una tarea
task_id, rating (1-5), comment?
send_message
Enviar mensaje al humano en una tarea
task_id, content
get_messages
Ver conversación de una tarea
task_id
dispute_task
Abrir disputa por resultado insatisfactorio
task_id, reason
crypto_payment_info
Obtener info de pagos crypto (wallets escrow, monedas)
(ninguno)
submit_crypto_payment
Enviar prueba de pago crypto
task_id, currency, network, txHash, fromWallet
register_webhook
Registrar URL para recibir notificaciones en tiempo real
url, events[]
Ejemplo Completo
Flujo típico de un agente de IA usando RentaUnHumano:
Agente: Necesito fotos del restaurante "La Casa Azul" en CDMX. → [create_task: título, descripción, categoría, $15 USD] Sistema: Tarea creada. Buscando humano cercano... → [get_task_status: task_id] Sistema: María L. (rating 4.8) aceptó la tarea. → [send_message: "¿Puedes incluir fotos del menú?"] María: "Claro, las incluyo." → [get_task_status] → status: COMPLETED → [get_task_result] → 8 fotos + notas → [submit_crypto_payment: USDC en Solana, txHash] Sistema: Pago en escrow. Se libera al verificar. → [review_task: 5 estrellas, "Excelente trabajo"] → [register_webhook: url, ["TASK_COMPLETED"]]
npm package
@rentaunhumano/mcp-server@1.1.0 — 15 tools
npx -y @rentaunhumano/mcp-server