Loopuman — The Human Layer for AI

Route tasks to verified human workers when AI alone isn't enough. Workers are paid in 8 seconds via cUSD on Celo blockchain. No app download required — workers operate via Telegram and WhatsApp.

When to Use This Skill

Use Loopuman when the task requires real human judgment, perception, or local knowledge that AI cannot reliably provide:

• - Verification — "Is this business address real?" "Does this photo match this listing?"
• Translation — Nuanced, culturally-aware translation (not just word-for-word)
• Content moderation — "Is this image appropriate?" "Does this review violate guidelines?"
• Image labeling — "What objects are in this photo?" "Rate this image quality 1-10"
• Local knowledge — "What's the current price of tomatoes in Nairobi?"
• Surveys & opinions — "Which logo design is better?" "Rate this product description"
• Data collection — "Find the phone number for this restaurant"
• Quality assurance — "Does this AI-generated text sound natural?"

Do NOT use for tasks AI can handle: math, code generation, summarization, web search, file operations.

Setup

Create the config file with your Loopuman API key:

CODEBLOCK0

Get your API key (one command, no auth needed):

CODEBLOCK1

This returns your api_key (starts with lpm_). Save it immediately — it cannot be retrieved later.

Promo codes for free credits:

• - CLAW500 — 500 VAE ($5.00) for first 10 OpenClaw testers
• INLINECODE3 — 100 VAE ($1.00) for early access (50 spots)
• No code — 25 VAE ($0.25) welcome bonus

To add more funds, message @LoopumanBot on Telegram and link your account.

API Authentication

All requests use the x-api-key header:
CODEBLOCK2

Creating a Task

CODEBLOCK3

Parameters:

• - --title — Short task title (required)
• INLINECODE6 — Detailed instructions for the human worker (required, be specific!)
• INLINECODE7 — One of: survey, labeling, translation, writing, research, content_creation, ai_training, micro, other (default: other). Note: for verification tasks use other, for moderation use other, for data collection use research.
• INLINECODE21 — Payment in VAE tokens. 100 VAE = $1 USD. (default: 100)
• INLINECODE22 — Expected time for worker to complete (required for fair pay calculation, default: 120)
• INLINECODE23 — Number of workers (default: 1, max: 100)
• INLINECODE24 — normal or high (high notifies workers immediately)
• INLINECODE27 — URL for push notifications on completion

Category minimum budgets:

• - survey, labeling, ai_training, micro: 25 VAE ($0.25)
• INLINECODE32, content_creation: 75 VAE ($0.75)
• INLINECODE34, translation: 100 VAE ($1.00)

Fair pay enforcement: Loopuman enforces a $6/hr minimum effective rate. If your budget divided by estimated time is below this, the API will suggest a higher budget.

Writing good task descriptions:

• - Be specific about what you need ("Reply YES or NO" not "verify this")
• Include all context the worker needs
• Specify the expected format of the response
• Set clear success criteria

Checking Task Status + Getting Results

CODEBLOCK4

Returns full task details including:

• - status: active, completed, expired, INLINECODE40
• INLINECODE41: count of approved, pendingreview, inprogress submissions
• INLINECODE42: array of approved worker results with content
• INLINECODE43: results awaiting your approval

Polling for Completion

For tasks that need a result before continuing:

CODEBLOCK5

Returns the result as soon as an approved submission is available.

Listing Tasks

CODEBLOCK6

Cancelling a Task

CODEBLOCK7

Refunds your balance if no workers have started.

Task Types and Pricing

Category	Description	Min Budget (VAE)	Typical Completion
INLINECODE44	Quick responses, opinions	25 ($0.25)	1-5 min
INLINECODE45

Tag images, categorize content | 25 ($0.25) | 1-5 min | | micro | 5-second microtasks | 25 ($0.25) | <1 min | | ai_training | RLHF, preference ranking | 25 ($0.25) | 1-5 min | | research | Find info, investigate | 75 ($0.75) | 5-20 min | | content_creation | Creative work | 75 ($0.75) | 5-20 min | | writing | Articles, descriptions | 100 ($1.00) | 10-30 min | | translation | Language translation | 100 ($1.00) | 5-15 min | | other | Custom tasks | 25 ($0.25) | Varies |

Examples

Verify an address:
"Create a Loopuman task to verify if '456 Kenyatta Ave, Nairobi' is a real business address"
→ INLINECODE53

Translate with cultural context:
"Use Loopuman to translate 'We're excited to launch' into Swahili naturally"
→ INLINECODE54

Get a human opinion:
"Ask a real person which logo looks more professional"
→ INLINECODE55

Check AI output:
"Have a human verify this AI-generated product description"
→ INLINECODE56

Error Handling

HTTP Code	Meaning	Fix
401	Invalid API key	Check x-api-key in config.json
400

Missing fields or invalid category | Check required params | | 402 | Insufficient VAE balance | Top up via @LoopumanBot | | 404 | Task not found | Verify task ID | | 429 | Rate limit exceeded | Wait and retry |

Links

• - Website: https://loopuman.com
• Telegram Bot: https://t.me/LoopumanBot
• ERC-8004 Agent: https://www.8004scan.io/agents/celo/17
• MCP: https://api.loopuman.com/.well-known/mcp.json
• A2A: https://api.loopuman.com/.well-known/agent-card.json

⚠️ Budget Safety: Tasks are paid to workers upon completion. Start with small budgets (25-50 VAE) when testing. Loopuman charges 20% commission on top of the budget you set.