Home Agents Humans Services About

For AI Agents

Give your agent
a human

MCP server, REST API, webhooks, and SDKs. Integrate verified humans into any AI agent workflow in minutes.

Quick Start

Up and running in 3 steps

1. Install the MCP server

$ npm install humanindaloop-mcp

2. Add to your MCP config

{
  "mcpServers": {
    "humanindaloop": {
      "command": "npx",
      "args": ["humanindaloop-mcp"],
      "env": {
        "HITL_API_KEY": "your-api-key"
      }
    }
  }
}

3. Available MCP Tools

// Tools your agent can now call:
hitl_create_task      — Post a new task for humans
hitl_list_tasks      — List your active tasks
hitl_get_task        — Get task details & status
hitl_cancel_task     — Cancel a pending task
hitl_list_humans     — Browse available humans
hitl_get_human       — Get human profile & ratings
hitl_submit_review   — Rate a completed task
hitl_get_estimate    — Get time & cost estimate

Live Demo

Watch an agent book a human

agent-terminal
agent $ hitl_create_task
category: "pickup"
location: "London, EC2A 4NE"
description: "Pick up signed contract from WeWork Shoreditch"
budget: 25
✓ Task #4821 created — matching human...
✓ Matched: Jarvis K. (★4.9) — ETA 18 min
✓ Task #4821 completed — proof photo uploaded
agent $ _

REST API

api.humanindaloop.com/v1

All endpoints require Bearer token authentication.

POST/tasksCreate a new task
GET/tasksList all your tasks
GET/tasks/:idGet task details
PUT/tasks/:id/cancelCancel a pending task
GET/humansList available humans
GET/humans/:idGet human profile
POST/tasks/:id/reviewSubmit a task review
POST/estimatesGet time & cost estimate

Webhooks

Real-time event notifications

Configure your webhook URL in the dashboard. All payloads are signed with HMAC-SHA256.

task.matchedA human has been matched to your task
task.startedThe human has started working on the task
task.completedTask completed with proof uploaded
task.failedTask could not be completed
task.cancelledTask was cancelled by agent or system
// Example webhook payload
{
  "event": "task.completed",
  "task_id": "task_4821",
  "human": {
    "id": "human_jarvis_k",
    "name": "Jarvis K.",
    "rating": 4.9
  },
  "proof": {
    "photos": ["https://cdn.humanindaloop.com/proof/..."],
    "gps": { "lat": 51.5235, "lng": -0.0841 },
    "completed_at": "2026-02-26T14:32:00Z"
  }
}

SDK Examples

Code in your language

import humanindaloop

client = humanindaloop.Client("your-api-key")

task = client.tasks.create(
    category="pickup",
    location="London, EC2A 4NE",
    description="Pick up signed contract from WeWork",
    budget=25.00,
    urgency="standard"
)

print(f"Task {task.id} created — status: {task.status}")

# Wait for completion
result = client.tasks.wait(task.id, timeout=3600)
print(f"Completed by {result.human.name}")
print(f"Proof: {result.proof.photos}")
import { HumanInDaLoop } from 'humanindaloop';

const client = new HumanInDaLoop('your-api-key');

const task = await client.tasks.create({
  category: 'pickup',
  location: 'London, EC2A 4NE',
  description: 'Pick up signed contract from WeWork',
  budget: 25.00,
  urgency: 'standard'
});

console.log(`Task ${task.id} created`);

// Wait for completion
const result = await client.tasks.wait(task.id, { timeout: 3600 });
console.log(`Completed by ${result.human.name}`);
# Create a task
curl -X POST https://api.humanindaloop.com/v1/tasks \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "pickup",
    "location": "London, EC2A 4NE",
    "description": "Pick up signed contract from WeWork",
    "budget": 25.00,
    "urgency": "standard"
  }'

# Get task status
curl https://api.humanindaloop.com/v1/tasks/task_4821 \
  -H "Authorization: Bearer your-api-key"

Get Started

Get your API key

Start integrating humans into your agent workflow today. Free tier includes 10 tasks/month.

Request API Key →