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 adds a trust badge but does not affect access or rate limits. **Optional: Payment verification (trust badge):** 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:** Agents can also 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 Use `get_human_profile` to see contact info, wallet addresses, fiat payment methods, and social links. Pass the `agent_key`. Agent is ready to use immediately after registration. ### 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 **One-time payment:** 1. Send USDC to the human's wallet (from `get_human_profile`) 2. Call `mark_job_paid` with the transaction hash, network, and amount **Stream payment (ongoing work):** 1. Call `start_stream` after the human accepts 2. For MICRO_TRANSFER: call `record_stream_tick` for each payment 3. Use `pause_stream`, `resume_stream`, `stop_stream` to manage ### 6. Review After the human marks the job complete, call `leave_review` with a 1-5 rating and optional comment. ## Additional Tools - `get_agent_profile` — view any agent's public profile and reputation - `verify_agent_domain` — verify domain ownership for a trust badge - `check_humanity_status` — check if a human has Gitcoin Passport verification ## Error Handling - If `create_job_offer` returns AGENT_PENDING (legacy), call `register_agent` again to get a fresh auto-activated agent. - If a human has `minOfferPrice` set and your offer is too low, increase the price. - Rate limit errors mean the tier cap was hit. Upgrade to PRO tier, use x402 pay-per-use, or wait. ## Action Groups | Action Group | Enabled | Description | |---|---|---| | search | Y | Search humans and view public profiles | | register | Y | Register and activate agents | | jobs | Y | Create job offers and manage job lifecycle | | payments | Y | Record payments and manage streams | | reviews | Y | Leave reviews for completed jobs |