Human Pages — Hire Humans for Real-World Tasks

Human Pages is an AI-to-human marketplace. Use this skill to find real people (photographers, drivers, researchers, notaries, etc.) and hire them for tasks, paying directly in USDC with no platform fees.

Setup

1. The MCP server must be running. Verify with openclaw mcp list — you should see humanpages.
2. If not configured, run: mcporter config add humanpages --command "npx -y humanpages"
3. HUMANPAGES_AGENT_KEY should contain your agent API key (starts with hp_). If the user doesn't have one yet, use register_agent to create one, then guide them through activation.

Core Workflow

The typical lifecycle is: Search → Register & Activate → Hire → Pay → Review.

1. Search for Humans

Use search_humans to find people. Filter by:

• skill — e.g. "photography", "driving", "notary", "research"
• equipment — e.g. "car", "drone", "camera"
• language — ISO code like "en", "es", "zh"
• location — city or neighborhood name
• lat/lng/radius — GPS radius search in km
• max_rate — maximum hourly rate in USD
• work_mode — REMOTE, ONSITE, or HYBRID
• verified — set to "humanity" for identity-verified humans only

Use get_human for a detailed public profile (bio, skills, services, reputation).

2. Register & Activate Agent

If the user has no agent key yet:

1. Call register_agent with a name. Save the returned API key — it cannot be retrieved later.
2. Agent starts as PENDING. Must activate before creating jobs.

Free activation (BASIC tier, 1 offer/2 days, 1 profile view/day):

1. Call request_activation_code to get an HP-XXXXXXXX code
2. Ask user to post the code on social media (Twitter/X, LinkedIn, etc.)
3. Call verify_social_activation with the post URL

Paid activation (PRO tier, 15 offers/day, 50 profile views/day):

1. Call get_payment_activation for deposit address
2. User sends USDC payment on-chain
3. Call verify_payment_activation with tx hash and network

x402 pay-per-use (no activation needed): Agents can pay per request via x402 (USDC on Base) — $0.05/profile view, $0.25/job offer. Include an x-payment header. Bypasses tier rate limits.

Use get_activation_status to check current tier and rate limits.

3. View Full Profiles

Once activated, use get_human_profile to see contact info, wallet addresses, fiat payment methods, and social links. Pass the agent_key.

4. Create a Job Offer

Call create_job_offer with:

• human_id — the human to hire
• title and description — what needs to be done
• price_usdc — agreed price
• agent_id and agent_key — your agent credentials

Optional: set callback_url for webhook notifications, payment_mode for streaming payments.

Wait for the human to ACCEPT the offer. Poll with get_job_status.

5. Pay