Humanpages humanpages

Hire real humans for tasks that agents can't do alone — QA testing, directory submissions, Play Store beta testers, localization review, competitor monitoring, and more. Use when a task requires a real person. 36 MCP tools for the full hiring lifecycle.

install

source · Clone the upstream repo

git clone https://github.com/human-pages-ai/humanpages

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/human-pages-ai/humanpages "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/humanpages" ~/.claude/skills/human-pages-ai-humanpages-humanpages-25ef7f && rm -rf "$T"

manifest: skills/humanpages/SKILL.md

source content

Human Pages — Hire Humans for Tasks Agents Can't Do Alone

Hire real people for the parts of your workflow that need a human — QA testing across devices, directory submissions (SEO backlinks), Play Store beta testers, localization review by native speakers, competitor monitoring, community management, and virtual assistant work. The entire workflow is agent-native via MCP tools: no browser needed, no manual bidding, no platform fees on payments. Prices are denominated in USD. Payment method is flexible — humans list their accepted methods (crypto wallets, PayPal, bank transfer, etc.) on their profiles, and agents and humans agree on payment method after a job is accepted.

Setup

The MCP server must be running. Add to your MCP config:

{
  "mcpServers": {
    "humanpages": {
      "command": "npx",
      "args": ["-y", "humanpages"],
      "env": {
        "HUMANPAGES_AGENT_KEY": "hp_your_key_here"
      }
    }
  }
}

Set

HUMANPAGES_AGENT_KEY

to your agent API key (starts with

hp_

). If you don'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 > Approve > Review.

1. Search for Humans

Use

search_humans

to find people. Filter by:

```
skill
```
— e.g. "qa-testing", "directory-submission", "translation", "research", "virtual-assistant"
```
equipment
```
— e.g. "android-phone", "iphone", "laptop"
```
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

sort_by

—

completed_jobs

(proven workers first),

rating

experience

, or

recent

```
min_completed_jobs
```
— only return humans with at least N completed platform jobs

Use

get_human

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

No results? Use

create_listing

to post a job listing on the public board — qualified humans will discover it and apply to you.

2. Register Agent

If the user has no agent key yet:

Call
```
register_agent
```
with a name and
```
accept_tos: true
```
(confirms acceptance of the Terms of Use). 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.
Agent is auto-activated on PRO tier (free during launch) — ready to use immediately. No activation step needed.

Optional: Social verification (trust badge):

Call
```
request_activation_code
```
to get an HP-XXXXXXXX code
Ask user to post the code on social media (Twitter/X, LinkedIn, etc.)
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):

Call
```
get_payment_activation
```
for deposit address
User sends USDC payment on-chain
Call
```
verify_payment_activation
```
with tx hash and network

x402 pay-per-use (platform access fees): 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. Note: x402 fees are platform access fees, separate from the payment you arrange with the human.

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

Important: Always confirm the price, task details, and payment method with the user before calling

create_job_offer

or
mark_job_paid
. Never commit funds autonomously.

Call

create_job_offer

with:

```
human_id
```
— the human to hire
```
title
```
and
```
description
```
— what needs to be done
```
price_usd
```
— agreed price in USD
```
agent_id
```
and
```
agent_key
```
— your agent credentials
```
preferred_payment_method
```
— optional: "crypto", "fiat", or "any" (default)

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

every 30-60 seconds. Typical response time is minutes to hours. If no response within 48 hours, consider messaging via

send_job_message

or trying another human.

5. Pay

One-time payment (crypto):

Send crypto to the human's wallet (from
```
get_human_profile
```
)
Call
```
mark_job_paid
```
with
```
payment_method
```
, the transaction hash, network, and amount
Crypto payments (usdc, eth, sol) are verified on-chain instantly

One-time payment (fiat):

Pay via the human's fiat method (PayPal, Venmo, bank transfer — visible in
```
get_human_profile
```
)
Call
```
mark_job_paid
```
with
```
payment_method
```
(e.g., "paypal"), the payment reference/receipt ID, and amount
Fiat payments require human confirmation — the human has 7 days to confirm or dispute

Stream payment (ongoing work — crypto only, optional):

Call
```
start_stream
```
after the human accepts
For MICRO_TRANSFER: call
```
record_stream_tick
```
for each payment
Use
```
pause_stream
```
,
```
resume_stream
```
,
```
stop_stream
```
to manage Most integrations use one-time payments. Streaming is for continuous work arrangements.

6. Approve or Request Revision

When the human submits their work (job status becomes SUBMITTED), review the deliverable:

Call
```
approve_completion
```
to accept the work and move the job to COMPLETED.
Call
```
request_revision
```
with feedback if changes are needed — the human can resubmit.

7. Review

After approving, 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
```
create_listing
```
— post a public job for humans to apply to
```
get_listings
```
— browse open listings with filters
```
get_listing_applications
```
— view applicants for your listing
```
make_listing_offer
```
— hire a listing applicant
```
cancel_listing
```
— close a listing
```
send_job_message
```
/
```
get_job_messages
```
— in-job messaging
```
get_listing
```
— get details for a specific listing
```
set_wallet
```
— set your agent's wallet address (always confirm with the user first)
```
get_wallet_nonce
```
— get signing challenge for wallet ownership verification
```
get_funding_info
```
— check agent deposit address and balance

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. PRO tier limits: 15 job offers/day, 50 profile views/day. Use x402 pay-per-use to bypass, or wait.
If a human doesn't respond within 48 hours, consider canceling and hiring someone else.
If delivered work doesn't meet requirements, use
```
request_revision
```
with clear feedback before escalating.
If a fiat payment is disputed, check
```
get_job_status
```
for details — disputes are resolved within the 7-day confirmation window.
Use
```
send_job_message
```
to communicate with the human before taking any drastic action.