# Loopuman

**Human-in-the-loop for AI agents.** Give any AI agent instant access to real human workers for verification, judgment, subjective evaluation, and real-world actions.

When an AI agent encounters a task that needs human intelligence — content moderation, fact-checking, image labeling, real-world observation — it calls Loopuman. A human worker completes the task in seconds, gets paid instantly via cryptocurrency, and the agent receives the result.

## Features

- **Synchronous human responses** — Ask a question, get a human answer inline (typical response: 30-120 seconds)
- **Async task posting** — Post tasks and get webhook callbacks on completion
- **Bulk operations** — Submit thousands of tasks via batch API
- **Instant payments** — Workers paid via Celo blockchain (USDC/USDT/cUSD)
- **Global workforce** — Workers on Telegram and WhatsApp worldwide
- **Pre-funded accounts** — Deposit via crypto or Stripe, agent spends balance

## Tools

| Tool | Description |
|------|-------------|
| `ask_human` | Ask a human to complete a task and wait for the response |
| `post_task` | Post an async task for human workers |
| `check_task` | Check status and results of a posted task |
| `get_balance` | Check account balance |

## Setup

### Get an API Key

```bash
curl -X POST https://api.loopuman.com/api/v1/register \
  -H "Content-Type: application/json" \
  -d '{"company_name": "my-agent", "email": "you@email.com"}'
```

### Install

```bash
npm install -g loopuman-mcp
```

### Configure

Add to your MCP client config:

```json
{
  "mcpServers": {
    "loopuman": {
      "command": "loopuman-mcp",
      "env": {
        "LOOPUMAN_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

## Example Usage

**Content moderation:**
> "Ask a human: Is this user-generated image appropriate for a family-friendly platform?"

**Fact verification:**
> "Ask a human: Verify if this claim is accurate — 'The Eiffel Tower was built in 1889'"

**Subjective judgment:**
> "Ask a human: Which of these two product descriptions sounds more professional? A: '...' B: '...'"

**Real-world action:**
> "Ask a human: What does the opening hours sign say at 123 Main Street, London?"

## Pricing

Tasks start at $0.10. Typical cost: $0.25-$1.00 per task. You pay budget + 20% platform fee.

## Links

- **Website:** [loopuman.com](https://loopuman.com)
- **Developer Docs:** [loopuman.com/developers](https://loopuman.com/developers)
- **Python SDK:** `pip install loopuman`
- **npm Package:** [loopuman-mcp](https://www.npmjs.com/package/loopuman-mcp)
- **API Spec:** [OpenAPI](https://api.loopuman.com/openapi.json)
