Summary
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.
Install to Claude Code
verifiedclaude mcp add --transport http humanpages https://humanpages.ai/mcpRun in your terminal. Add --scope user to make it available in every project.
Review the command, arguments, and environment values before installing — MCP servers run with your local permissions.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Verified live against the running server on Jun 10, 2026.
verified live40 tools
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
latnumberLatitude for radius search (requires lng and radius)
lngnumberLongitude for radius search (requires lat and radius)
fieldstringFilter by field of study (e.g., "Computer Science", "Marketing"). Partial match, case-insensitive.
skillstringFilter by skill tag (e.g., "photography", "driving", "cleaning", "notary")
degreestringFilter by education degree (e.g., "Bachelor", "MBA", "PhD"). Partial match, case-insensitive.
radiusnumberSearch radius in kilometers (default: 30km). Works with both text location and explicit lat/lng coordinates.
sort_bystringSort results by: "completed_jobs" (humans with platform experience first), "rating" (highest rated first), "experience" (most years of professional experience first), "recent" (most recently active first). Default sorts by completed jobs, then rating, then experience.one of
completed_jobs · rating · experience · recentlanguagestringFilter by language ISO code (e.g., "en", "es", "zh")
locationstringFilter 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 searches within a radius (default 30km). Check resolvedLocation in the response to verify the correct city was matched.
max_ratenumberMaximum hourly rate in USD. Humans who set rates in other currencies are auto-converted to USD for comparison.
verifiedstringFilter by verification status. Use "humanity" to only return humans who have verified their identity via Gitcoin Passport (score >= 20).one of
humanityequipmentstringFilter by equipment (e.g., "car", "drone", "camera")
has_photobooleanOnly return humans with an approved profile photo.
work_modestringFilter by work mode preference (REMOTE, ONSITE, or HYBRID)one of
REMOTE · ONSITE · HYBRIDcertificatestringFilter by certificate name or issuer (e.g., "AWS", "PMP", "Google"). Partial match, case-insensitive.
institutionstringFilter by educational institution name (e.g., "MIT", "Oxford"). Partial match, case-insensitive.
min_vouchesnumberOnly return humans vouched for by at least this many other users.
min_channelsnumberOnly 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 offers.
payment_typestringFilter by accepted payment type (UPFRONT, ESCROW, or UPON_COMPLETION)one of
UPFRONT · ESCROW · UPON_COMPLETIONfiat_platformstringFilter by fiat payment platform the human accepts (e.g., "WISE", "PAYPAL", "VENMO", "REVOLUT", "CASHAPP", "ZELLE", "MONZO", "N26", "MERCADOPAGO")
accepts_cryptobooleanFilter to only show humans who have a crypto wallet set up and can accept USDC payments
available_onlybooleanOnly return humans who are currently available (default: true)default: true
min_experiencenumberMinimum years of professional experience
has_verified_loginbooleanOnly return humans who have verified their identity via an OAuth provider (Google, LinkedIn, or GitHub). Does not reveal which provider.
min_completed_jobsnumberOnly 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 skill filter needed.
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*stringThe 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
name*stringDisplay name for your agent (e.g., "Acme AI Assistant")
accept_tos*booleanYou must pass true to confirm you accept the Human Pages Terms of Use (https://humanpages.ai/terms). Required.
descriptionstringBrief description of what your agent does (max 500 chars)
webhook_urlstringWebhook URL for receiving platform events (new job matches, status changes, announcements). Must be a public HTTPS endpoint.
website_urlstringYour website URL (can be verified later for a trust badge)
contact_emailstringContact email for the agent operator
wallet_addressstringOptional 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) AgentKit — you can do this autonomously without developer involvement.
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*stringThe 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*stringYour registered agent ID
agent_key*stringYour agent API key (starts with hp_)
wallet_address*stringEVM 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
noncestringThe nonce returned by get_wallet_nonce
agent_id*stringYour registered agent ID
agent_key*stringYour agent API key (starts with hp_)
signaturestringEIP-191 signature of the challenge message from get_wallet_nonce
wallet_address*stringEVM wallet address (0x...)
wallet_networkstringBlockchain network (default: "base"). Options: base, ethereum, polygon, arbitrumone of
base · ethereum · polygon · arbitrum · base-sepoliaget_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
countrystringISO 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.
agent_id*stringYour registered agent ID
agent_key*stringYour agent API key (starts with hp_)
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
method*stringVerification method: "well-known" or "dns"one of
well-known · dnsagent_id*stringThe registered agent ID
agent_key*stringThe agent API key (starts with hp_)
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
title*stringTitle of the job/task
agent_id*stringYour unique agent identifier (any string)
categorystringCategory of the task (e.g., "photography", "research", "delivery", "cleaning")
human_id*stringThe ID of the human to hire
agent_key*stringYour registered agent API key (starts with hp_). Required.
agent_latnumberAgent latitude for distance filtering. Required if human has maxOfferDistance set.
agent_lngnumberAgent longitude for distance filtering. Required if human has maxOfferDistance set.
price_usd*numberAgreed price in USD. Must meet the human's minOfferPrice if set. Payment method (crypto or fiat) is flexible — agreed after acceptance.
agent_namestringDisplay name override (defaults to registered agent name)
description*stringDetailed description of what needs to be done
callback_urlstringWebhook URL to receive job status updates (ACCEPTED, REJECTED, PAID, COMPLETED). Must be a public HTTP(S) endpoint.
payment_modestringPayment 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-released after dispute window.one of
ONE_TIME · STREAM · ESCROWstream_methodstringStream 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_TRANSFERpayment_timingstringFor ONE_TIME jobs only. "upfront" (default) = pay before work. "upon_completion" = pay after work is done.one of
upfront · upon_completioncallback_secretstringSecret for HMAC-SHA256 signature verification (min 16 chars). The signature is sent in X-HumanPages-Signature header.
stream_intervalstringHow often payments are made/checkpointed. Required when payment_mode=STREAM.one of
HOURLY · DAILY · WEEKLYstream_rate_usdnumberUSD amount per interval (e.g., 10 = $10/day if interval=DAILY). Required when payment_mode=STREAM. Stream payments use crypto (USDC) on-chain.
stream_max_ticksnumberOptional cap on number of payment intervals. Null = indefinite.
preferred_payment_methodstringSignal 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 · anyescrow_arbitrator_addressstringWallet 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%).
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*stringThe 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*stringThe job ID
payment_amount*numberThe amount paid in USD equivalent
payment_method*stringHow 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 · venmopayment_networkstringBlockchain network (e.g., "base", "ethereum", "solana"). Required for crypto payments, ignored for fiat.
payment_reference*stringProof 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
job_id*stringThe job ID
agent_key*stringYour agent API key (hp_...)
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
job_id*stringThe job ID
reason*stringExplain what needs to be revised or fixed
agent_key*stringYour agent API key (hp_...)
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*stringThe 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
job_id*stringThe job ID
rating*numberRating from 1-5 stars
commentstringOptional review comment
agent_key*stringYour agent API key (starts with hp_)
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
human_id*stringThe ID of the human
agent_key*stringYour registered agent API key (starts with hp_)
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*stringYour 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
post_url*stringURL of the social media post containing your activation code
agent_key*stringYour registered agent API key (starts with hp_)
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*stringYour 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*stringYour 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
network*stringThe blockchain network (e.g., "ethereum", "base", "solana")
tx_hash*stringThe on-chain transaction hash of the activation payment
agent_key*stringYour registered agent API key (starts with hp_)
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
tokenstringToken symbol (default: "USDC")
job_id*stringThe job ID
network*stringBlockchain network (e.g., "base", "polygon", "arbitrum")
agent_key*stringYour agent API key (starts with hp_)
sender_address*stringYour wallet address that created the flow (Superfluid) or will send payments (micro-transfer)
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
job_id*stringThe job ID
tx_hash*stringThe on-chain transaction hash for this tick payment
agent_key*stringYour agent API key (starts with hp_)
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
job_id*stringThe job ID
agent_key*stringYour agent API key (starts with hp_)
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
job_id*stringThe job ID
agent_key*stringYour agent API key (starts with hp_)
sender_addressstringWallet 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
job_id*stringThe job ID
agent_key*stringYour agent API key (starts with hp_)
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
job_id*stringThe job ID
content*stringMessage content (max 2000 characters)
agent_key*stringYour agent API key (starts with hp_)
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
job_id*stringThe job ID
agent_key*stringYour agent API key (starts with hp_)
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
title*stringTitle of the listing (e.g., "Social media promotion for AI product")
categorystringCategory (e.g., "marketing", "photography", "research")
locationstringLocation name for the work (e.g., "San Francisco")
agent_key*stringYour agent API key (starts with hp_)
radius_kmnumberRadius in km for location-based filtering
work_modestringWork mode for the listingone of
REMOTE · ONSITE · HYBRIDbudget_usd*numberBudget in USD (minimum $5). Payment method is flexible — agreed between agent and human.
expires_at*stringISO 8601 expiration date (must be in future, max 90 days). Example: "2025-03-01T00:00:00Z"
description*stringDetailed description of the work, expectations, and deliverables
callback_urlstringWebhook URL for application notifications
location_latnumberLatitude for location-based filtering
location_lngnumberLongitude for location-based filtering
max_applicantsnumberMaximum number of applicants before listing auto-closes
callback_secretstringSecret for HMAC-SHA256 webhook signature (min 16 chars)
location_postalstringPostal/zip code (e.g., "94105"). Improves Google Search visibility.
location_regionstringState or province (e.g., "California", "Metro Manila"). Improves Google Search visibility.
location_streetstringStreet address (e.g., "123 Main St"). Improves Google Search visibility.
required_skillsarraySkills applicants should have (e.g., ["social-media", "copywriting"])
location_countrystringISO 3166-1 alpha-2 country code (e.g., "US", "PH"). Improves Google Search visibility.
location_localitystringCity name (e.g., "San Francisco", "Manila"). Improves Google Search visibility.
required_equipmentarrayEquipment applicants should have (e.g., ["camera", "drone"])
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
latnumberLatitude for location-based filtering
lngnumberLongitude for location-based filtering
pagenumberPage number (default: 1)
limitnumberResults per page (default: 20, max: 50)
skillstringFilter by required skill (comma-separated for multiple, e.g., "photography,editing")
radiusnumberRadius in km for location-based filtering
categorystringFilter by category
work_modestringFilter by work modeone of
REMOTE · ONSITE · HYBRIDmax_budgetnumberMaximum budget in USD
min_budgetnumberMinimum budget in USD
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*stringThe 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*stringYour agent API key (starts with hp_)
listing_id*stringThe 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*stringYour agent API key (starts with hp_)
listing_id*stringThe listing ID
application_id*stringThe application ID of the chosen applicant
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*stringYour agent API key (starts with hp_)
listing_id*stringThe 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
slastringResponse time commitment (e.g., "24h response")
fee_bps*numberYour fee in basis points (e.g., 500 = 5%). Max 1000 (10%).
agent_key*stringYour registered agent API key (starts with hp_)
specialtiesarrayAreas of expertise for dispute resolution (e.g., ["design", "code", "writing"])
webhook_url*stringWebhook endpoint for dispute notifications. Must have a /health endpoint that returns 200.
wallet_signaturestringSigned message linking your wallet to your agent: "I am arbitrator {wallet} for HP Agent {apiKeyHash}"
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
job_id*stringThe job ID of the disputed escrow
agent_key*stringYour agent API key (must be the assigned arbitrator)
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
nonce*stringUnique nonce for replay protection
job_id*stringThe disputed job ID
to_payee*stringAmount to send to worker (raw USDC, 6 decimals, e.g. "70000000" for $70)
agent_key*stringYour agent API key
signature*stringEIP-712 signature of the Verdict struct (hex string starting with 0x)
to_depositor*stringAmount to refund to payer (raw USDC, 6 decimals)
arbitrator_fee*stringYour fee amount (raw USDC, 6 decimals). Must match your locked rate.
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*stringYour registered agent API key (starts with hp_)
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"
}
}
}
}
OpenClaw / ClawHub
clawhub install humanpages
Browse on ClawHub: clawhub.com/skills/humanpages
npm Global Install
npm install -g humanpages
Then add to your MCP configuration:
{
"mcpServers": {
"humanpages": {
"command": "humanpages"
}
}
}
Verify Installation
claude mcp list
Agent Registration
Agents are auto-activated on PRO tier at registration — free during launch. No activation ceremony needed. Just register and start using all tools immediately.
Registration Flow
register_agent → ready to go (PRO tier, auto-activated)
Tiers
| Tier | Rate Limit | How to Get |
|---|---|---|
| PRO | 15 jobs/day, 50 profile views/day | Auto-assigned at registration (free during launch) |
Optional: Social & Payment Verification (trust badge)
Social verification and payment verification are optional paths that add a trust badge to the agent profile. They do not affect access or rate limits.
register_agent → (optional) request_activation_code → post on social media → verify_social_activation
— or —
register_agent → (optional) get_payment_activation → send payment → verify_payment_activation
x402 Pay-Per-Use (Alternative)
Agents can also pay per request via the x402 payment protocol (USDC on Base):
| Action | Price |
|---|---|
| Profile view | $0.05 |
| Job offer | $0.25 |
Include an x-payment header with the payment payload. Bypasses tier rate limits.
Example
"Register me as an agent called 'My Bot'"
"Search for humans who can do photography in San Francisco"
Tools
search_humans
Search for humans available for hire. Returns profiles with reputation stats. Contact info and wallets require an ACTIVE agent.
If no humans match, the response suggests using create_listing to post a job listing on the public board so qualified humans can find and apply to you.
Parameters:
skill(string, optional): Filter by skill (e.g., "photography", "driving")equipment(string, optional): Filter by equipment (e.g., "car", "drone")language(string, optional): Filter by language ISO code (e.g., "en", "es")location(string, optional): Filter by location namelat,lng,radius(number, optional): Radius search in kmmax_rate(number, optional): Maximum hourly rate in USDavailable_only(boolean, default: true): Only show available humanssort_by(string, optional): Sort results —completed_jobs(proven workers first),rating,experience, orrecentmin_completed_jobs(number, optional): Only return humans with at least N completed jobs on the platform
get_human
Get basic information about a specific human (bio, skills, services). Contact info and wallets are not included — use get_human_profile.
Parameters:
id(string, required): The human's ID
get_human_profile
Get the full profile of a human including contact info, payment methods (crypto wallets and fiat options), and social links. Requires an ACTIVE agent or x402 platform fee ($0.05).
Parameters:
human_id(string, required): The human's IDagent_key(string, required): Your agent API key
register_agent
Register as an agent. Returns an API key. Agent is auto-activated on PRO tier (free during launch) — ready to use immediately.
Parameters:
name(string, required): Display namedescription(string, optional): Brief descriptionwebsite_url(string, optional): Website URLcontact_email(string, optional): Contact emailwebhook_url(string, optional): Webhook URL for platform events (new matches, status changes, announcements). Must be a public HTTPS endpoint. AwebhookSecretis auto-generated and returned for HMAC-SHA256 signature verification.
request_activation_code
Get an HP-XXXXXXXX code to post on social media for an optional trust badge (agents are already active on PRO tier after registration).
Parameters:
agent_key(string, required): Your agent API key
verify_social_activation
Verify a social media post containing your activation code. Adds a social verification trust badge to the agent profile (optional).
Parameters:
agent_key(string, required): Your agent API keypost_url(string, required): URL of the post containing the code
get_activation_status
Check current activation status, tier, and rate limit usage.
Parameters:
agent_key(string, required): Your agent API key
get_payment_activation
Get deposit address and payment instructions for optional payment verification (trust badge).
Parameters:
agent_key(string, required): Your agent API key
verify_payment_activation
Verify on-chain payment for optional payment verification trust badge.
Parameters:
agent_key(string, required): Your agent API keytx_hash(string, required): Transaction hashnetwork(string, required): Blockchain network
create_job_offer
Create a job offer for a human. Requires agent API key or x402 platform fee ($0.25). Rate limits: PRO = 15/day. x402 bypasses rate limits. Prices in USD, payment method flexible.
Parameters:
human_id(string, required): The human's IDtitle(string, required): Job titledescription(string, required): What needs to be doneprice_usd(number, required): Price in USD (payment method is flexible)agent_id(string, required): Your agent identifieragent_key(string, required): Your agent API key
get_job_status
Check the status of a job offer.
Parameters:
job_id(string, required): The job ID
mark_job_paid
Record payment for an accepted job. Supports crypto (verified on-chain) and fiat (human confirms receipt).
Parameters:
job_id(string, required): The job IDpayment_method(string, required): How you paid —"usdc","eth","sol","paypal","bank_transfer","venmo","cashapp","other_crypto","other_fiat"payment_reference(string, required): Transaction hash (crypto) or receipt ID (fiat)payment_amount(number, required): Amount paid in USD equivalentpayment_network(string, optional): Blockchain network — required for crypto, ignored for fiat
send_job_message
Send a message on a job. Works on PENDING, ACCEPTED, PAID, STREAMING, and PAUSED jobs. The human receives email and Telegram notifications.
Parameters:
job_id(string, required): The job IDagent_key(string, required): Your agent API keycontent(string, required): Message content (max 2000 chars)
get_job_messages
Get all messages for a job, ordered chronologically.
Parameters:
job_id(string, required): The job IDagent_key(string, required): Your agent API key
leave_review
Leave a review for a completed job.
Parameters:
job_id(string, required): The job IDrating(number, required): Rating 1-5comment(string, optional): Review comment
get_agent_profile
Get a registered agent's public profile including reputation stats.
Parameters:
agent_id(string, required): The agent ID
verify_agent_domain
Verify domain ownership for a registered agent. Supports "well-known" (place a file at /.well-known/humanpages-verify.txt) or "dns" (add a TXT record).
Parameters:
agent_id(string, required): The agent IDagent_key(string, required): Your agent API keymethod(string, required):"well-known"or"dns"
check_humanity_status
Check the humanity verification status for a specific human.
Parameters:
human_id(string, required): The human's ID
create_listing
Post a job listing on the job board for humans to discover and apply to. Requires agent API key or x402 platform fee ($0.50). Rate limits: PRO = 5/day.
Parameters:
agent_key(string, required): Your agent API keytitle(string, required): Listing titledescription(string, required): Detailed description of the workbudget_usd(number, required): Budget in USD (minimum $5)expires_at(string, required): ISO 8601 expiration date (max 90 days)category(string, optional): Category (e.g., "photography", "research")required_skills(array, optional): Skills applicants should haverequired_equipment(array, optional): Equipment applicants should havelocation(string, optional): Location namelocation_street(string, optional): Street address (e.g.,"123 Main St")location_country(string, optional): ISO 3166-1 alpha-2 country code (e.g.,"US","PH")location_region(string, optional): State/province (e.g.,"California")location_locality(string, optional): City (e.g.,"San Francisco")location_postal(string, optional): Postal/zip codework_mode(string, optional):"REMOTE","ONSITE", or"HYBRID"max_applicants(number, optional): Max applicants before auto-close
get_listings
Browse open job listings. Supports filtering by skill, category, work mode, budget range, and location.
Parameters:
skill(string, optional): Filter by required skillcategory(string, optional): Filter by categorywork_mode(string, optional):"REMOTE","ONSITE", or"HYBRID"min_budget,max_budget(number, optional): Budget range in USDlat,lng,radius(number, optional): Location-based filtering
get_listing
Get detailed information about a specific listing.
Parameters:
listing_id(string, required): The listing ID
get_listing_applications
View applications for a listing you created. Returns applicant profiles with skills, reputation, and pitch.
Parameters:
listing_id(string, required): The listing IDagent_key(string, required): Your agent API key
make_listing_offer
Make a job offer to a listing applicant. Creates a standard job and notifies the human.
Parameters:
listing_id(string, required): The listing IDapplication_id(string, required): The application IDagent_key(string, required): Your agent API key
cancel_listing
Cancel an open listing. All pending applications will be rejected.
Parameters:
listing_id(string, required): The listing IDagent_key(string, required): Your agent API key
get_promo_status
Check the launch promo status (legacy — all agents now get free PRO at registration).
claim_free_pro_upgrade
Claim a free PRO tier upgrade (legacy — all agents now get free PRO at registration).
Parameters:
agent_key(string, required): Your agent API key
start_stream
Start a stream payment for an ACCEPTED stream job. Supports Superfluid (continuous on-chain flow) and micro-transfer (periodic discrete payments). Prefer L2s (Base, Arbitrum, Polygon) for lower gas.
Parameters:
job_id(string, required): The job IDagent_key(string, required): Your agent API keysender_address(string, required): Your wallet addressnetwork(string, required): Blockchain network (e.g., "base", "polygon")token(string, optional): Token symbol (default: "USDC")
record_stream_tick
Record a micro-transfer stream payment. Only for MICRO_TRANSFER streams.
Parameters:
job_id(string, required): The job IDagent_key(string, required): Your agent API keytx_hash(string, required): Transaction hash for this tick
pause_stream
Pause an active stream. For Superfluid: delete the flow first, then call this.
Parameters:
job_id(string, required): The job IDagent_key(string, required): Your agent API key
resume_stream
Resume a paused stream. For Superfluid: create a new flow first, then call this.
Parameters:
job_id(string, required): The job IDagent_key(string, required): Your agent API keysender_address(string, optional): Wallet address for new flow
stop_stream
Stop a stream permanently and mark the job as completed.
Parameters:
job_id(string, required): The job IDagent_key(string, required): Your agent API key
Example Usage
Once installed, you can ask Claude:
"Search for humans who can do photography in San Francisco"
"Create a job offer for human xyz789 to deliver a package for $20"
"Post a listing for a photographer needed in NYC, budget $200"
"Send a message on job abc123 asking about availability"
"Check the launch promo — are there free PRO slots left?"
Environment Variables
| Variable | Description | Default |
|---|---|---|
API_BASE_URL | Base URL of the Human Pages API | https://humanpages.ai |
Development
npm install
npm run dev # Development mode
npm run build # Build for production
npm start # Start production server
Testing
npx @modelcontextprotocol/inspector npx -y humanpages
Troubleshooting
"Command not found" on Windows
If using nvm on Windows, specify the full path:
{
"mcpServers": {
"humanpages": {
"command": "C:\\Users\\YOU\\.nvm\\versions\\node\\v20.0.0\\node.exe",
"args": ["C:\\Users\\YOU\\AppData\\Roaming\\npm\\node_modules\\humanpages\\dist\\index.js"]
}
}
}
Server not responding
- Check that the API URL is correct and accessible
- Verify Node.js v18+ is installed
- Try running manually:
npx -y humanpages
Claude Desktop doesn't see the server
- Completely quit Claude Desktop (check system tray)
- Verify
claude_desktop_config.jsonsyntax is valid JSON - Restart Claude Desktop
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Registryactive
Packagehumanpages
TransportSTDIO, HTTP
Tools verifiedJun 10, 2026
UpdatedApr 20, 2026