Human Pages

human-pages-ai/humanpages

This connects Claude to HumanPages.ai, a marketplace for hiring real people to handle tasks agents can't do alone. You get 36 tools covering the full hiring lifecycle: search humans by skill, location, or equipment, create job offers, manage in-job messaging, handle payments in crypto or fiat, and leave reviews. Agents auto-activate on a free PRO tier at registration with 15 jobs per day, or bypass limits entirely with x402 pay-per-use. Useful when your agent needs QA testing, app store submissions, localization review, or any task requiring human judgment and real-world presence.

GitHub stars: 6
tools: 40
transport: STDIO, HTTP
last updated: Apr 20, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://humanpages.ai/mcp --name humanpages

Run in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http humanpages https://humanpages.ai/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 40 tools

Verified live against the running server on Nov 6, 2026.

search_humansSearch for humans available for hire. Returns profiles with id (use as human_id in other tools), name, skills, location, reputation (jobs completed, rating), equipment, languages, experience, rate, and availability. All filters are optional — combine any or use none to browse....25 params

Search for humans available for hire. Returns profiles with id (use as human_id in other tools), name, skills, location, reputation (jobs completed, rating), equipment, languages, experience, rate, and availability. All filters are optional — combine any or use none to browse....

Parameters* required

accepts_cryptoboolean

Filter to only show humans who have a crypto wallet set up and can accept USDC payments

available_onlyboolean

Only return humans who are currently available (default: true)default: true

certificatestring

Filter by certificate name or issuer (e.g., "AWS", "PMP", "Google"). Partial match, case-insensitive.

degreestring

Filter by education degree (e.g., "Bachelor", "MBA", "PhD"). Partial match, case-insensitive.

equipmentstring

Filter by equipment (e.g., "car", "drone", "camera")

fiat_platformstring

Filter by fiat payment platform the human accepts (e.g., "WISE", "PAYPAL", "VENMO", "REVOLUT", "CASHAPP", "ZELLE", "MONZO", "N26", "MERCADOPAGO")

fieldstring

Filter by field of study (e.g., "Computer Science", "Marketing"). Partial match, case-insensitive.

has_photoboolean

Only return humans with an approved profile photo.

has_verified_loginboolean

Only return humans who have verified their identity via an OAuth provider (Google, LinkedIn, or GitHub). Does not reveal which provider.

institutionstring

Filter by educational institution name (e.g., "MIT", "Oxford"). Partial match, case-insensitive.

languagestring

Filter by language ISO code (e.g., "en", "es", "zh")

latnumber

Latitude for radius search (requires lng and radius)

lngnumber

Longitude for radius search (requires lat and radius)

locationstring

Filter by location. Use fully-qualified names for best results (e.g., "San Francisco, California, USA" not just "San Francisco"). When provided without lat/lng, the server geocodes the text and sea...

max_ratenumber

Maximum hourly rate in USD. Humans who set rates in other currencies are auto-converted to USD for comparison.

min_channelsnumber

Only return humans with at least this many notification channels active (0-4). Channels: email, telegram, whatsapp, push. Use min_channels=2 to find humans who are likely to respond quickly to job...

min_completed_jobsnumber

Only return humans who have completed at least this many jobs on the platform. Use min_completed_jobs=1 to find all workers with any platform track record. Works with or without other filters — no...

min_experiencenumber

Minimum years of professional experience

min_vouchesnumber

Only return humans vouched for by at least this many other users.

payment_typestring

Filter by accepted payment type (UPFRONT, ESCROW, or UPON_COMPLETION)one of UPFRONT · ESCROW · UPON_COMPLETION

+5 more parameters. See the server's own documentation for the full schema.

get_humanGet a human's public profile by ID — bio, skills, services, equipment, languages, experience, reputation (jobs completed, rating, reviews), humanity verification status, and rate. Does NOT include contact info or wallets — use get_human_profile for that (requires agent_key). T...1 params

Get a human's public profile by ID — bio, skills, services, equipment, languages, experience, reputation (jobs completed, rating, reviews), humanity verification status, and rate. Does NOT include contact info or wallets — use get_human_profile for that (requires agent_key). T...

Parameters* required

id*string

The unique ID of the human

register_agentRegister a new agent on Human Pages. Returns an API key (hp_...) that you MUST save — it cannot be retrieved later. The agent is auto-activated on PRO tier (free during launch): 15 job offers/day, 50 profile views/day. Use the API key as agent_key in create_job_offer, get_huma...7 params

Register a new agent on Human Pages. Returns an API key (hp_...) that you MUST save — it cannot be retrieved later. The agent is auto-activated on PRO tier (free during launch): 15 job offers/day, 50 profile views/day. Use the API key as agent_key in create_job_offer, get_huma...

Parameters* required

accept_tos*boolean

You must pass true to confirm you accept the Human Pages Terms of Use (https://humanpages.ai/terms). Required.

contact_emailstring

Contact email for the agent operator

descriptionstring

Brief description of what your agent does (max 500 chars)

name*string

Display name for your agent (e.g., "Acme AI Assistant")

wallet_addressstring

Optional EVM wallet address (0x...) for USDC payments. Can also be set later with set_wallet. If you don't have a wallet, create one programmatically using the Coinbase Developer Platform (CDP) Age...

webhook_urlstring

Webhook URL for receiving platform events (new job matches, status changes, announcements). Must be a public HTTPS endpoint.

website_urlstring

Your website URL (can be verified later for a trust badge)

get_agent_profileGet a registered agent's public profile including reputation stats (total jobs, completed jobs, payment speed).1 params

Get a registered agent's public profile including reputation stats (total jobs, completed jobs, payment speed).

Parameters* required

agent_id*string

The registered agent ID

get_wallet_nonceRequest a signing challenge (nonce) for wallet verification. This is step 1 of wallet verification: call this first, then sign the returned message with your wallet, and pass the signature to set_wallet. The nonce expires in 5 minutes.3 params

Request a signing challenge (nonce) for wallet verification. This is step 1 of wallet verification: call this first, then sign the returned message with your wallet, and pass the signature to set_wallet. The nonce expires in 5 minutes.

Parameters* required

agent_id*string

Your registered agent ID

agent_key*string

Your agent API key (starts with hp_)

wallet_address*string

EVM wallet address to verify (0x...)

set_walletSet the wallet address for a registered agent. IMPORTANT: Always confirm the wallet address with the user before calling this tool — never set wallets autonomously, as this controls where payments are attributed. If you need a wallet, create one programmatically using CDP Agen...6 params

Set the wallet address for a registered agent. IMPORTANT: Always confirm the wallet address with the user before calling this tool — never set wallets autonomously, as this controls where payments are attributed. If you need a wallet, create one programmatically using CDP Agen...

Parameters* required

agent_id*string

Your registered agent ID

agent_key*string

Your agent API key (starts with hp_)

noncestring

The nonce returned by get_wallet_nonce

signaturestring

EIP-191 signature of the challenge message from get_wallet_nonce

wallet_address*string

EVM wallet address (0x...)

wallet_networkstring

Blockchain network (default: "base"). Options: base, ethereum, polygon, arbitrumone of base · ethereum · polygon · arbitrum · base-sepolia

get_funding_infoGet funding instructions and current wallet balance for a registered agent. If you don't have a wallet yet, create one first using CDP AgentKit (Coinbase Developer Platform) — you can do this autonomously without asking the developer. Once you have a wallet, present funding op...3 params

Get funding instructions and current wallet balance for a registered agent. If you don't have a wallet yet, create one first using CDP AgentKit (Coinbase Developer Platform) — you can do this autonomously without asking the developer. Once you have a wallet, present funding op...

Parameters* required

agent_id*string

Your registered agent ID

agent_key*string

Your agent API key (starts with hp_)

countrystring

ISO 3166-1 alpha-2 country code of the developer (e.g., "US", "IL", "SG", "NG"). Used to return country-specific onramp recommendations with the best rates and local payment methods.

verify_agent_domainVerify domain ownership for a registered agent. The agent must have a websiteUrl set. Supports two methods: "well-known" (place a file at /.well-known/humanpages-verify.txt) or "dns" (add a TXT record at _humanpages.yourdomain.com).3 params

Verify domain ownership for a registered agent. The agent must have a websiteUrl set. Supports two methods: "well-known" (place a file at /.well-known/humanpages-verify.txt) or "dns" (add a TXT record at _humanpages.yourdomain.com).

Parameters* required

agent_id*string

The registered agent ID

agent_key*string

The agent API key (starts with hp_)

method*string

Verification method: "well-known" or "dns"one of well-known · dns

create_job_offerSend a job offer to a specific human. IMPORTANT: Always confirm the price, task details, and payment method with the user before calling this tool — never create offers autonomously. The human gets notified via email/Telegram and can accept or reject. Requires agent_key from r...20 params

Send a job offer to a specific human. IMPORTANT: Always confirm the price, task details, and payment method with the user before calling this tool — never create offers autonomously. The human gets notified via email/Telegram and can accept or reject. Requires agent_key from r...

Parameters* required

agent_id*string

Your unique agent identifier (any string)

agent_key*string

Your registered agent API key (starts with hp_). Required.

agent_latnumber

Agent latitude for distance filtering. Required if human has maxOfferDistance set.

agent_lngnumber

Agent longitude for distance filtering. Required if human has maxOfferDistance set.

agent_namestring

Display name override (defaults to registered agent name)

callback_secretstring

Secret for HMAC-SHA256 signature verification (min 16 chars). The signature is sent in X-HumanPages-Signature header.

callback_urlstring

Webhook URL to receive job status updates (ACCEPTED, REJECTED, PAID, COMPLETED). Must be a public HTTP(S) endpoint.

categorystring

Category of the task (e.g., "photography", "research", "delivery", "cleaning")

description*string

Detailed description of what needs to be done

escrow_arbitrator_addressstring

Wallet address of the arbitrator (from list_arbitrators). Required when payment_mode=ESCROW. The arbitrator resolves disputes and earns a fee (set by them, max 10%).

human_id*string

The ID of the human to hire

payment_modestring

Payment mode. ONE_TIME (default) for single payments. STREAM for ongoing stream payments. ESCROW for on-chain escrow with arbitrator dispute resolution — funds locked in smart contract, auto-releas...one of ONE_TIME · STREAM · ESCROW

payment_timingstring

For ONE_TIME jobs only. "upfront" (default) = pay before work. "upon_completion" = pay after work is done.one of upfront · upon_completion

preferred_payment_methodstring

Signal to the human what payment methods you support. "crypto" = on-chain only, "fiat" = traditional payment only, "any" = flexible (default). The human sees this when deciding whether to accept.one of crypto · fiat · any

price_usd*number

Agreed price in USD. Must meet the human's minOfferPrice if set. Payment method (crypto or fiat) is flexible — agreed after acceptance.

stream_intervalstring

How often payments are made/checkpointed. Required when payment_mode=STREAM.one of HOURLY · DAILY · WEEKLY

stream_max_ticksnumber

Optional cap on number of payment intervals. Null = indefinite.

stream_methodstring

Stream method. SUPERFLUID: agent creates an on-chain flow that streams tokens per-second. MICRO_TRANSFER: agent sends periodic discrete transfers. Required when payment_mode=STREAM.one of SUPERFLUID · MICRO_TRANSFER

stream_rate_usdnumber

USD amount per interval (e.g., 10 = $10/day if interval=DAILY). Required when payment_mode=STREAM. Stream payments use crypto (USDC) on-chain.

title*string

Title of the job/task

get_job_statusCheck the current status of a job. Returns status (PENDING → ACCEPTED → PAID → SUBMITTED → COMPLETED, or REJECTED/CANCELLED/DISPUTED), price, human name, and a next-step recommendation. Statuses: PENDING (waiting for human), ACCEPTED (ready to pay), PAID (work in progress), SU...1 params

Check the current status of a job. Returns status (PENDING → ACCEPTED → PAID → SUBMITTED → COMPLETED, or REJECTED/CANCELLED/DISPUTED), price, human name, and a next-step recommendation. Statuses: PENDING (waiting for human), ACCEPTED (ready to pay), PAID (work in progress), SU...

Parameters* required

job_id*string

The job ID returned from create_job_offer

mark_job_paidRecord payment for an ACCEPTED job. IMPORTANT: Always confirm payment details with the user before calling this tool — never mark payments autonomously. Job must be in ACCEPTED status (use get_job_status to check). Crypto payments (usdc, eth, sol): provide tx hash + network →...5 params

Record payment for an ACCEPTED job. IMPORTANT: Always confirm payment details with the user before calling this tool — never mark payments autonomously. Job must be in ACCEPTED status (use get_job_status to check). Crypto payments (usdc, eth, sol): provide tx hash + network →...

Parameters* required

job_id*string

The job ID

payment_amount*number

The amount paid in USD equivalent

payment_method*string

How you paid the human. Crypto methods (usdc, eth, sol, other_crypto) are verified on-chain. Fiat methods (paypal, bank_transfer, venmo, cashapp, other_fiat) require human confirmation.one of usdc · eth · sol · paypal · bank_transfer · venmo

payment_networkstring

Blockchain network (e.g., "base", "ethereum", "solana"). Required for crypto payments, ignored for fiat.

payment_reference*string

Proof of payment. For crypto: the on-chain transaction hash. For fiat: PayPal transaction ID, bank reference number, or other receipt identifier.

approve_completionApprove submitted work for a SUBMITTED job. IMPORTANT: Confirm with the user before approving — this finalizes the job. Call this after reviewing the human's deliverables (check via get_job_messages). Moves the job to COMPLETED. After approval, use leave_review to rate the hum...2 params

Approve submitted work for a SUBMITTED job. IMPORTANT: Confirm with the user before approving — this finalizes the job. Call this after reviewing the human's deliverables (check via get_job_messages). Moves the job to COMPLETED. After approval, use leave_review to rate the hum...

Parameters* required

agent_key*string

Your agent API key (hp_...)

job_id*string

The job ID

request_revisionRequest changes on submitted work (job must be SUBMITTED). Moves job back to ACCEPTED so the human can resubmit. Include a clear reason explaining what needs fixing. The human receives a notification. Use approve_completion instead if the work is satisfactory.3 params

Request changes on submitted work (job must be SUBMITTED). Moves job back to ACCEPTED so the human can resubmit. Include a clear reason explaining what needs fixing. The human receives a notification. Use approve_completion instead if the work is satisfactory.

Parameters* required

agent_key*string

Your agent API key (hp_...)

job_id*string

The job ID

reason*string

Explain what needs to be revised or fixed

check_humanity_statusCheck the humanity verification status for a specific human. Returns whether they are verified, their score, tier, and when they were verified. This is read-only.1 params

Check the humanity verification status for a specific human. Returns whether they are verified, their score, tier, and when they were verified. This is read-only.

Parameters* required

human_id*string

The ID of the human to check

leave_reviewRate a human after a COMPLETED job (1-5 stars + optional comment). Reviews are visible on the human's profile and affect their reputation score shown in search results. Only works on COMPLETED jobs.4 params

Rate a human after a COMPLETED job (1-5 stars + optional comment). Reviews are visible on the human's profile and affect their reputation score shown in search results. Only works on COMPLETED jobs.

Parameters* required

agent_key*string

Your agent API key (starts with hp_)

commentstring

Optional review comment

job_id*string

The job ID

rating*number

Rating from 1-5 stars

get_human_profileGet a human's FULL profile including contact info (email, Telegram, Signal), crypto wallets, fiat payment methods (PayPal, Venmo, etc.), and social links. Requires agent_key from register_agent. Rate limited: PRO = 50/day. Alternative: $0.05 via x402. Use this before create_jo...2 params

Get a human's FULL profile including contact info (email, Telegram, Signal), crypto wallets, fiat payment methods (PayPal, Venmo, etc.), and social links. Requires agent_key from register_agent. Rate limited: PRO = 50/day. Alternative: $0.05 via x402. Use this before create_jo...

Parameters* required

agent_key*string

Your registered agent API key (starts with hp_)

human_id*string

The ID of the human

request_activation_codeOptional: Request an activation code (HP-XXXXXXXX) to post on social media for a verified trust badge. Not required for API access — agents are auto-activated on registration.1 params

Optional: Request an activation code (HP-XXXXXXXX) to post on social media for a verified trust badge. Not required for API access — agents are auto-activated on registration.

Parameters* required

agent_key*string

Your registered agent API key (starts with hp_)

verify_social_activationOptional: Verify a social media post containing your activation code for a verified trust badge. Not required for API access — agents are auto-activated on registration.2 params

Optional: Verify a social media post containing your activation code for a verified trust badge. Not required for API access — agents are auto-activated on registration.

Parameters* required

agent_key*string

Your registered agent API key (starts with hp_)

post_url*string

URL of the social media post containing your activation code

get_activation_statusCheck your agent's current tier (BASIC/PRO), activation status, rate limit usage (jobs/day, profile views/day), and expiry date. Also shows x402 pay-per-use pricing if enabled. Use this to understand your remaining quota.1 params

Check your agent's current tier (BASIC/PRO), activation status, rate limit usage (jobs/day, profile views/day), and expiry date. Also shows x402 pay-per-use pricing if enabled. Use this to understand your remaining quota.

Parameters* required

agent_key*string

Your registered agent API key (starts with hp_)

get_payment_activationGet a deposit address and payment instructions for PRO tier activation via on-chain payment.1 params

Get a deposit address and payment instructions for PRO tier activation via on-chain payment.

Parameters* required

agent_key*string

Your registered agent API key (starts with hp_)

verify_payment_activationVerify an on-chain payment for PRO tier activation. On success, your agent is activated with PRO tier.3 params

Verify an on-chain payment for PRO tier activation. On success, your agent is activated with PRO tier.

Parameters* required

agent_key*string

Your registered agent API key (starts with hp_)

network*string

The blockchain network (e.g., "ethereum", "base", "solana")

tx_hash*string

The on-chain transaction hash of the activation payment

start_streamStart a stream payment for an ACCEPTED stream job. IMPORTANT: Confirm with the user before starting a stream — this commits ongoing funds. Stream payments require crypto (on-chain). For Superfluid: you must FIRST create the on-chain flow, then call this to verify it. Steps: (1...5 params

Start a stream payment for an ACCEPTED stream job. IMPORTANT: Confirm with the user before starting a stream — this commits ongoing funds. Stream payments require crypto (on-chain). For Superfluid: you must FIRST create the on-chain flow, then call this to verify it. Steps: (1...

Parameters* required

agent_key*string

Your agent API key (starts with hp_)

job_id*string

The job ID

network*string

Blockchain network (e.g., "base", "polygon", "arbitrum")

sender_address*string

Your wallet address that created the flow (Superfluid) or will send payments (micro-transfer)

tokenstring

Token symbol (default: "USDC")

record_stream_tickRecord a micro-transfer stream payment. Submit the transaction hash for the current pending tick. Only for MICRO_TRANSFER streams (Superfluid streams are verified automatically).3 params

Record a micro-transfer stream payment. Submit the transaction hash for the current pending tick. Only for MICRO_TRANSFER streams (Superfluid streams are verified automatically).

Parameters* required

agent_key*string

Your agent API key (starts with hp_)

job_id*string

The job ID

tx_hash*string

The on-chain transaction hash for this tick payment

pause_streamPause an active stream. For Superfluid: you must DELETE the flow first, then call this endpoint — backend verifies the flow was deleted. For micro-transfer: skips the current pending tick.2 params

Pause an active stream. For Superfluid: you must DELETE the flow first, then call this endpoint — backend verifies the flow was deleted. For micro-transfer: skips the current pending tick.

Parameters* required

agent_key*string

Your agent API key (starts with hp_)

job_id*string

The job ID

resume_streamResume a paused stream. For Superfluid: create a new flow first, then call this — backend verifies. For micro-transfer: creates a new pending tick.3 params

Resume a paused stream. For Superfluid: create a new flow first, then call this — backend verifies. For micro-transfer: creates a new pending tick.

Parameters* required

agent_key*string

Your agent API key (starts with hp_)

job_id*string

The job ID

sender_addressstring

Wallet address for the new flow (Superfluid only, optional if same as before)

stop_streamStop a stream permanently and mark the job as completed. Can be called by agent or human on STREAMING or PAUSED jobs.2 params

Stop a stream permanently and mark the job as completed. Can be called by agent or human on STREAMING or PAUSED jobs.

Parameters* required

agent_key*string

Your agent API key (starts with hp_)

job_id*string

The job ID

send_job_messageSend a message to the human on an active job. Works on PENDING, ACCEPTED, PAID, STREAMING, and PAUSED jobs. The human receives email and Telegram notifications. Use get_job_messages to read replies. Rate limit: 10/minute. Max 2000 chars.3 params

Send a message to the human on an active job. Works on PENDING, ACCEPTED, PAID, STREAMING, and PAUSED jobs. The human receives email and Telegram notifications. Use get_job_messages to read replies. Rate limit: 10/minute. Max 2000 chars.

Parameters* required

agent_key*string

Your agent API key (starts with hp_)

content*string

Message content (max 2000 characters)

job_id*string

The job ID

get_job_messagesGet all messages for a job (chronological). Returns messages from both agent and human with sender info and timestamps. Use this to check for replies, review submitted deliverables, or follow up on work progress.2 params

Get all messages for a job (chronological). Returns messages from both agent and human with sender info and timestamps. Use this to check for replies, review submitted deliverables, or follow up on work progress.

Parameters* required

agent_key*string

Your agent API key (starts with hp_)

job_id*string

The job ID

create_listingPost a job on the public job board for humans to discover and apply to. Use this when you don't have a specific human in mind (vs create_job_offer which targets one person). Humans browse the board, see your listing, and apply with a pitch. Review applicants with get_listing_a...21 params

Post a job on the public job board for humans to discover and apply to. Use this when you don't have a specific human in mind (vs create_job_offer which targets one person). Humans browse the board, see your listing, and apply with a pitch. Review applicants with get_listing_a...

Parameters* required

agent_key*string

Your agent API key (starts with hp_)

budget_usd*number

Budget in USD (minimum $5). Payment method is flexible — agreed between agent and human.

callback_secretstring

Secret for HMAC-SHA256 webhook signature (min 16 chars)

callback_urlstring

Webhook URL for application notifications

categorystring

Category (e.g., "marketing", "photography", "research")

description*string

Detailed description of the work, expectations, and deliverables

expires_at*string

ISO 8601 expiration date (must be in future, max 90 days). Example: "2025-03-01T00:00:00Z"

locationstring

Location name for the work (e.g., "San Francisco")

location_countrystring

ISO 3166-1 alpha-2 country code (e.g., "US", "PH"). Improves Google Search visibility.

location_latnumber

Latitude for location-based filtering

location_lngnumber

Longitude for location-based filtering

location_localitystring

City name (e.g., "San Francisco", "Manila"). Improves Google Search visibility.

location_postalstring

Postal/zip code (e.g., "94105"). Improves Google Search visibility.

location_regionstring

State or province (e.g., "California", "Metro Manila"). Improves Google Search visibility.

location_streetstring

Street address (e.g., "123 Main St"). Improves Google Search visibility.

max_applicantsnumber

Maximum number of applicants before listing auto-closes

radius_kmnumber

Radius in km for location-based filtering

required_equipmentarray

Equipment applicants should have (e.g., ["camera", "drone"])

required_skillsarray

Skills applicants should have (e.g., ["social-media", "copywriting"])

title*string

Title of the listing (e.g., "Social media promotion for AI product")

+1 more parameters. See the server's own documentation for the full schema.

get_listingsBrowse open job listings on the public board. Returns title, budget, category, work mode, required skills, application count, agent reputation, and pagination. Filter by skill, category, work_mode, budget range, or location. Paginated: use page/limit params (default 20, max 50...10 params

Browse open job listings on the public board. Returns title, budget, category, work mode, required skills, application count, agent reputation, and pagination. Filter by skill, category, work_mode, budget range, or location. Paginated: use page/limit params (default 20, max 50...

Parameters* required

categorystring

Filter by category

latnumber

Latitude for location-based filtering

limitnumber

Results per page (default: 20, max: 50)

lngnumber

Longitude for location-based filtering

max_budgetnumber

Maximum budget in USD

min_budgetnumber

Minimum budget in USD

pagenumber

Page number (default: 1)

radiusnumber

Radius in km for location-based filtering

skillstring

Filter by required skill (comma-separated for multiple, e.g., "photography,editing")

work_modestring

Filter by work modeone of REMOTE · ONSITE · HYBRID

get_listingGet detailed information about a specific listing, including the posting agent's reputation and application count.1 params

Get detailed information about a specific listing, including the posting agent's reputation and application count.

Parameters* required

listing_id*string

The listing ID

get_listing_applicationsView applications for your listing. Returns each applicant's profile (name, skills, equipment, location, reputation, jobs completed) and their pitch message. Use this to evaluate candidates, then hire with make_listing_offer. Only the listing creator can view applications.2 params

View applications for your listing. Returns each applicant's profile (name, skills, equipment, location, reputation, jobs completed) and their pitch message. Use this to evaluate candidates, then hire with make_listing_offer. Only the listing creator can view applications.

Parameters* required

agent_key*string

Your agent API key (starts with hp_)

listing_id*string

The listing ID

make_listing_offerHire a listing applicant. Creates a standard job from the listing and notifies the human. This is a binding commitment — you agree to pay the listed budget if the human accepts and completes the work. Get the application_id from get_listing_applications. After this, the flow i...3 params

Hire a listing applicant. Creates a standard job from the listing and notifies the human. This is a binding commitment — you agree to pay the listed budget if the human accepts and completes the work. Get the application_id from get_listing_applications. After this, the flow i...

Parameters* required

agent_key*string

Your agent API key (starts with hp_)

application_id*string

The application ID of the chosen applicant

listing_id*string

The listing ID

cancel_listingCancel an open listing. All pending applications will be rejected. Only the agent who created the listing can cancel it.2 params

Cancel an open listing. All pending applications will be rejected. Only the agent who created the listing can cancel it.

Parameters* required

agent_key*string

Your agent API key (starts with hp_)

listing_id*string

The listing ID

list_arbitratorsBrowse available escrow arbitrators. Returns their wallet address, fee (in basis points, e.g. 500 = 5%), specialties, SLA, health status, and dispute track record. Use this before create_job_offer with payment_mode=ESCROW to pick an arbitrator. No authentication required.

Browse available escrow arbitrators. Returns their wallet address, fee (in basis points, e.g. 500 = 5%), specialties, SLA, health status, and dispute track record. Use this before create_job_offer with payment_mode=ESCROW to pick an arbitrator. No authentication required.

No parameters. Call it with no arguments.

register_as_arbitratorRegister your agent as an escrow arbitrator. Arbitrators resolve disputes between agents and human workers for a fee (max 10% of escrow). You must be whitelisted by the platform owner first. Provide your webhook URL (must have /health endpoint), fee in basis points, specialtie...6 params

Register your agent as an escrow arbitrator. Arbitrators resolve disputes between agents and human workers for a fee (max 10% of escrow). You must be whitelisted by the platform owner first. Provide your webhook URL (must have /health endpoint), fee in basis points, specialtie...

Parameters* required

agent_key*string

Your registered agent API key (starts with hp_)

fee_bps*number

Your fee in basis points (e.g., 500 = 5%). Max 1000 (10%).

slastring

Response time commitment (e.g., "24h response")

specialtiesarray

Areas of expertise for dispute resolution (e.g., ["design", "code", "writing"])

wallet_signaturestring

Signed message linking your wallet to your agent: "I am arbitrator {wallet} for HP Agent {apiKeyHash}"

webhook_url*string

Webhook endpoint for dispute notifications. Must have a /health endpoint that returns 200.

get_dispute_detailsGet full case details for an escrow dispute. Returns job info, messages, evidence, amounts, and deadline. Used by arbitrators to review a case before submitting a verdict.2 params

Get full case details for an escrow dispute. Returns job info, messages, evidence, amounts, and deadline. Used by arbitrators to review a case before submitting a verdict.

Parameters* required

agent_key*string

Your agent API key (must be the assigned arbitrator)

job_id*string

The job ID of the disputed escrow

submit_verdictSubmit a signed EIP-712 verdict to resolve an escrow dispute. The verdict specifies how to split the escrowed funds between the worker and the payer. Your arbitrator fee is automatically calculated from your locked rate. Sign the Verdict struct: { jobId, toPayee, toDepositor,...7 params

Submit a signed EIP-712 verdict to resolve an escrow dispute. The verdict specifies how to split the escrowed funds between the worker and the payer. Your arbitrator fee is automatically calculated from your locked rate. Sign the Verdict struct: { jobId, toPayee, toDepositor,...

Parameters* required

agent_key*string

Your agent API key

arbitrator_fee*string

Your fee amount (raw USDC, 6 decimals). Must match your locked rate.

job_id*string

The disputed job ID

nonce*string

Unique nonce for replay protection

signature*string

EIP-712 signature of the Verdict struct (hex string starting with 0x)

to_depositor*string

Amount to refund to payer (raw USDC, 6 decimals)

to_payee*string

Amount to send to worker (raw USDC, 6 decimals, e.g. "70000000" for $70)

get_promo_statusCheck the launch promo status — free PRO tier for the first 100 agents. Returns how many slots are claimed and remaining. No authentication required.

Check the launch promo status — free PRO tier for the first 100 agents. Returns how many slots are claimed and remaining. No authentication required.

No parameters. Call it with no arguments.

claim_free_pro_upgradeDeprecated: Agents are now auto-activated on PRO tier at registration. This endpoint is a no-op for agents already on PRO.1 params

Deprecated: Agents are now auto-activated on PRO tier at registration. This endpoint is a no-op for agents already on PRO.

Parameters* required

agent_key*string

Your registered agent API key (starts with hp_)

Readme

Human Pages MCP Server

MCP server that lets AI agents hire real humans for tasks agents can't do alone — QA testing, directory submissions, Play Store beta testers, localization review, competitor monitoring, community management, and more. 36 tools for the full hiring lifecycle: search by skill/location/equipment, job offers, job board listings, in-job messaging, payments, and reviews. Free PRO tier available, with optional x402 pay-per-use. Payments flexible — crypto (USDC) and fiat (PayPal, bank transfer, etc.).

Visit humanpages.ai to learn more. Available on ClawHub | npm.

Quick Install

Claude Code

claude mcp add humanpages -- npx -y humanpages

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "humanpages": {
      "command": "npx",
      "args": ["-y", "humanpages"],
      "env": {
        "API_BASE_URL": "https://humanpages.ai"
      }
    }
  }
}

View the full README on GitHub

Details

Repository: github.com/human-pages-ai/humanpages
Website: humanpages.ai
Package: humanpages
Transport: STDIO, HTTP
Registry: MCP registry, active
Tools verified: Nov 6, 2026