humanpages

# Human Pages — Hire Humans for Real-World Tasks

Human Pages is an AI-to-human discovery layer. 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. Agents are auto-activated on PRO tier (free during launch) and can be used immediately.

## Core Workflow

The typical lifecycle is: **Search** → **Register** → **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 Agent

If the user has no agent key yet:

1. Call `register_agent` with a name. Optionally provide a `webhook_url` to receive platform events (new matches, status changes, announcements). Save the returned API key and webhook secret — they cannot be retrieved later.
2. Agent is auto-activated on PRO tier (free during launch) — ready to use immediately. No activation step needed.

**Optional: Social verification (trust badge):**
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
This ad...