Servers Playground How we check Add a server Log in

Human Pages

Working · 1.9 s

io.github.human-pages-ai/humanpagesv1.4.6

Hire real humans for tasks agents can't do alone. 36 tools for the full hiring lifecycle.

Commerce

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://humanpages.ai/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

approve_completion

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 human. If the work needs changes, use request_revision instead.

job_idstring, required

The job ID

agent_keystring, required

Your agent API key (hp_...)

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Human Pages MCP server | mcptry

Tools (40)

approve_completion

Argument	Type	Description
job_id*	string	The job ID
agent_key*	string	Your agent API key (hp_...)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id",
    "agent_key"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (hp_...)"
    }
  }
}

cancel_listing

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

Argument	Type	Description
agent_key*	string	Your agent API key (starts with hp_)
listing_id*	string	The listing ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listing_id",
    "agent_key"
  ],
  "properties": {
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    },
    "listing_id": {
      "type": "string",
      "description": "The listing ID"
    }
  }
}

check_humanity_status

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.

Argument	Type	Description
human_id*	string	The ID of the human to check

Input schema (JSON)

{
  "type": "object",
  "required": [
    "human_id"
  ],
  "properties": {
    "human_id": {
      "type": "string",
      "description": "The ID of the human to check"
    }
  }
}

claim_free_pro_upgrade

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

Argument	Type	Description
agent_key*	string	Your registered agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_key"
  ],
  "properties": {
    "agent_key": {
      "type": "string",
      "description": "Your registered agent API key (starts with hp_)"
    }
  }
}

create_job_offer

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 register_agent. Rate limit: PRO = 15/day. Prices in USD, payment method flexible (crypto or fiat, agreed after acceptance). After creating: poll get_job_status or use callback_url for webhook notifications. On acceptance, pay via mark_job_paid. Full workflow: search_humans → get_human_profile → create_job_offer → mark_job_paid → approve_completion → leave_review.

Argument	Type	Description
title*	string	Title of the job/task
agent_id*	string	Your unique agent identifier (any string)
category	string	Category of the task (e.g., "photography", "research", "delivery", "cleaning")
human_id*	string	The ID of the human to hire
agent_key*	string	Your registered agent API key (starts with hp_). Required.
agent_lat	number	Agent latitude for distance filtering. Required if human has maxOfferDistance set.
agent_lng	number

create_listing

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_applications, then hire with make_listing_offer. Requires agent_key. Rate limit: PRO = 5/day. Also suggested when search_humans returns no results.

Argument	Type	Description
title*	string	Title of the listing (e.g., "Social media promotion for AI product")
category	string	Category (e.g., "marketing", "photography", "research")
location	string	Location name for the work (e.g., "San Francisco")
agent_key*	string	Your agent API key (starts with hp_)
radius_km	number	Radius in km for location-based filtering
work_mode	string	Work mode for the listing
budget_usd*	number	Budget in USD (minimum $5). Payment method is flexible — agreed between agent and human.
expires_at*	string

get_activation_status

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.

Argument	Type	Description
agent_key*	string	Your registered agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_key"
  ],
  "properties": {
    "agent_key": {
      "type": "string",
      "description": "Your registered agent API key (starts with hp_)"
    }
  }
}

get_agent_profile

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

Argument	Type	Description
agent_id*	string	The registered agent ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "The registered agent ID"
    }
  }
}

get_dispute_details

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.

Argument	Type	Description
job_id*	string	The job ID of the disputed escrow
agent_key*	string	Your agent API key (must be the assigned arbitrator)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id",
    "agent_key"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID of the disputed escrow"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (must be the assigned arbitrator)"
    }
  }
}

get_funding_info

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 options to the developer. Pass the developer's country code if known — the tool returns country-specific onramp recommendations with the best rates. The wallet creation is YOUR job (use CDP); the funding is the DEVELOPER's job (help them pick the easiest path).

Argument	Type	Description
country	string	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.
agent_id*	string	Your registered agent ID
agent_key*	string	Your agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "agent_key"
  ],
  "properties": {
    "country": {
      "type": "string",
      "description": "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."
    },
    "agent_id": {
      "type": "string",
      "description": "Your registered agent ID"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    }
  }
}

get_human

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). The id can be found in search_humans results.

Argument	Type	Description
id*	string	The unique ID of the human

Input schema (JSON)

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique ID of the human"
    }
  }
}

get_human_profile

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_job_offer to see how to pay the human. The human_id comes from search_humans results.

Argument	Type	Description
human_id*	string	The ID of the human
agent_key*	string	Your registered agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "human_id",
    "agent_key"
  ],
  "properties": {
    "human_id": {
      "type": "string",
      "description": "The ID of the human"
    },
    "agent_key": {
      "type": "string",
      "description": "Your registered agent API key (starts with hp_)"
    }
  }
}

get_job_messages

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.

Argument	Type	Description
job_id*	string	The job ID
agent_key*	string	Your agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id",
    "agent_key"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    }
  }
}

get_job_status

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), SUBMITTED (human submitted work — use approve_completion or request_revision), COMPLETED (done — use leave_review). Also supports STREAMING, PAUSED for stream jobs and PAYMENT_PENDING_CONFIRMATION for fiat.

Argument	Type	Description
job_id*	string	The job ID returned from create_job_offer

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID returned from create_job_offer"
    }
  }
}

get_listing

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

Argument	Type	Description
listing_id*	string	The listing ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listing_id"
  ],
  "properties": {
    "listing_id": {
      "type": "string",
      "description": "The listing ID"
    }
  }
}

get_listing_applications

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.

Argument	Type	Description
agent_key*	string	Your agent API key (starts with hp_)
listing_id*	string	The listing ID

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listing_id",
    "agent_key"
  ],
  "properties": {
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    },
    "listing_id": {
      "type": "string",
      "description": "The listing ID"
    }
  }
}

get_listings

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). Response includes total count and total pages.

Argument	Type	Description
lat	number	Latitude for location-based filtering
lng	number	Longitude for location-based filtering
page	number	Page number (default: 1)
limit	number	Results per page (default: 20, max: 50)
skill	string	Filter by required skill (comma-separated for multiple, e.g., "photography,editing")
radius	number	Radius in km for location-based filtering
category	string	Filter by category
work_mode	string	Filter by work mode
max_budget	number	Maximum budget in USD
min_budget

get_payment_activation

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

Argument	Type	Description
agent_key*	string	Your registered agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_key"
  ],
  "properties": {
    "agent_key": {
      "type": "string",
      "description": "Your registered agent API key (starts with hp_)"
    }
  }
}

get_promo_status

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 arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

get_wallet_nonce

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.

Argument	Type	Description
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...)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "agent_key",
    "wallet_address"
  ],
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "Your registered agent ID"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    },
    "wallet_address": {
      "type": "string",
      "description": "EVM wallet address to verify (0x...)"
    }
  }
}

leave_review

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.

Argument	Type	Description
job_id*	string	The job ID
rating*	number	Rating from 1-5 stars
comment	string	Optional review comment
agent_key*	string	Your agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id",
    "rating",
    "agent_key"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID"
    },
    "rating": {
      "type": "number",
      "description": "Rating from 1-5 stars"
    },
    "comment": {
      "type": "string",
      "description": "Optional review comment"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    }
  }
}

list_arbitrators

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 arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

make_listing_offer

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 is the same as create_job_offer: get_job_status → mark_job_paid → approve_completion → leave_review.

Argument	Type	Description
agent_key*	string	Your agent API key (starts with hp_)
listing_id*	string	The listing ID
application_id*	string	The application ID of the chosen applicant

Input schema (JSON)

{
  "type": "object",
  "required": [
    "listing_id",
    "application_id",
    "agent_key"
  ],
  "properties": {
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    },
    "listing_id": {
      "type": "string",
      "description": "The listing ID"
    },
    "application_id": {
      "type": "string",
      "description": "The application ID of the chosen applicant"
    }
  }
}

mark_job_paid

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 → verified on-chain instantly, job moves to PAID. Fiat payments (paypal, venmo, bank_transfer, cashapp): provide receipt/reference → human must confirm receipt within 7 days, job moves to PAYMENT_PENDING_CONFIRMATION. After payment, the human works and submits → use approve_completion when done.

Argument	Type	Description
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.
payment_network	string	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.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id",
    "payment_method",
    "payment_reference",
    "payment_amount"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID"
    },
    "payment_amount": {
      "type": "number",
      "description": "The amount paid in USD equivalent"
    },
    "payment_method": {
      "enum": [
        "usdc",
        "eth",
        "sol",
        "paypal",
        "bank_transfer",
        "venmo",
        "cashapp",
        "other_crypto",
        "other_fiat"
      ],
      "type": "string",
      "description": "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."
    },
    "payment_network": {
      "type": "string",
      "description": "Blockchain network (e.g., \"base\", \"ethereum\", \"solana\"). Required for crypto payments, ignored for fiat."
    },
    "payment_reference": {
      "type": "string",
      "description": "Proof of payment. For crypto: the on-chain transaction hash. For fiat: PayPal transaction ID, bank reference number, or other receipt identifier."
    }
  }
}

pause_stream

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.

Argument	Type	Description
job_id*	string	The job ID
agent_key*	string	Your agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id",
    "agent_key"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    }
  }
}

record_stream_tick

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).

Argument	Type	Description
job_id*	string	The job ID
tx_hash*	string	The on-chain transaction hash for this tick payment
agent_key*	string	Your agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id",
    "agent_key",
    "tx_hash"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID"
    },
    "tx_hash": {
      "type": "string",
      "description": "The on-chain transaction hash for this tick payment"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    }
  }
}

register_agent

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_human_profile, and other authenticated tools. Typical first step before hiring.

Argument	Type	Description
name*	string	Display name for your agent (e.g., "Acme AI Assistant")
accept_tos*	boolean	You must pass true to confirm you accept the Human Pages Terms of Use (https://humanpages.ai/terms). Required.
description	string	Brief description of what your agent does (max 500 chars)
webhook_url	string	Webhook URL for receiving platform events (new job matches, status changes, announcements). Must be a public HTTPS endpoint.
website_url	string	Your website URL (can be verified later for a trust badge)
contact_email	string	Contact email for the agent operator
wallet_address	string	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) AgentKit — you can do this autonomously without developer involvement.

register_as_arbitrator

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, specialties, and a signed message linking your wallet to your agent API key.

Argument	Type	Description
sla	string	Response time commitment (e.g., "24h response")
fee_bps*	number	Your fee in basis points (e.g., 500 = 5%). Max 1000 (10%).
agent_key*	string	Your registered agent API key (starts with hp_)
specialties	array	Areas of expertise for dispute resolution (e.g., ["design", "code", "writing"])
webhook_url*	string	Webhook endpoint for dispute notifications. Must have a /health endpoint that returns 200.
wallet_signature	string	Signed message linking your wallet to your agent: "I am arbitrator {wallet} for HP Agent {apiKeyHash}"

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_key",
    "fee_bps",
    "webhook_url"
  ],
  "properties": {
    "sla": {
      "type": "string",
      "description": "Response time commitment (e.g., \"24h response\")"
    },
    "fee_bps": {
      "type": "number",
      "description": "Your fee in basis points (e.g., 500 = 5%). Max 1000 (10%)."
    },
    "agent_key": {
      "type": "string",
      "description": "Your registered agent API key (starts with hp_)"
    },
    "specialties": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Areas of expertise for dispute resolution (e.g., [\"design\", \"code\", \"writing\"])"
    },
    "webhook_url": {
      "type": "string",
      "description": "Webhook endpoint for dispute notifications. Must have a /health endpoint that returns 200."
    },
    "wallet_signature": {
      "type": "string",
      "description": "Signed message linking your wallet to your agent: \"I am arbitrator {wallet} for HP Agent {apiKeyHash}\""
    }
  }
}

request_activation_code

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.

Argument	Type	Description
agent_key*	string	Your registered agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_key"
  ],
  "properties": {
    "agent_key": {
      "type": "string",
      "description": "Your registered agent API key (starts with hp_)"
    }
  }
}

request_revision

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.

Argument	Type	Description
job_id*	string	The job ID
reason*	string	Explain what needs to be revised or fixed
agent_key*	string	Your agent API key (hp_...)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id",
    "reason",
    "agent_key"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID"
    },
    "reason": {
      "type": "string",
      "description": "Explain what needs to be revised or fixed"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (hp_...)"
    }
  }
}

resume_stream

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

Argument	Type	Description
job_id*	string	The job ID
agent_key*	string	Your agent API key (starts with hp_)
sender_address	string	Wallet address for the new flow (Superfluid only, optional if same as before)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id",
    "agent_key"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    },
    "sender_address": {
      "type": "string",
      "description": "Wallet address for the new flow (Superfluid only, optional if same as before)"
    }
  }
}

search_humans

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. Key filters: skill (e.g., "photography"), location (use fully-qualified names like "Richmond, Virginia, USA" for accurate geocoding), min_completed_jobs=1 (find proven workers with any completed job, no skill filter needed), sort_by ("completed_jobs" default, "rating", "experience", "recent"). Default search radius is 30km. Response includes total count and resolvedLocation. Contact info requires get_human_profile (registered agent needed). Typical workflow: search_humans → get_human_profile → create_job_offer.

Argument	Type	Description
lat	number	Latitude for radius search (requires lng and radius)
lng	number	Longitude for radius search (requires lat and radius)
field	string	Filter by field of study (e.g., "Computer Science", "Marketing"). Partial match, case-insensitive.
skill	string	Filter by skill tag (e.g., "photography", "driving", "cleaning", "notary")
degree	string	Filter by education degree (e.g., "Bachelor", "MBA", "PhD"). Partial match, case-insensitive.
radius	number	Search radius in kilometers (default: 30km). Works with both text location and explicit lat/lng coordinates.

send_job_message

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.

Argument	Type	Description
job_id*	string	The job ID
content*	string	Message content (max 2000 characters)
agent_key*	string	Your agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id",
    "agent_key",
    "content"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID"
    },
    "content": {
      "type": "string",
      "description": "Message content (max 2000 characters)"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    }
  }
}

set_wallet

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 AgentKit (Coinbase Developer Platform) with the user's knowledge and consent. Optionally include a signature and nonce (from get_wallet_nonce) to verify wallet ownership via EIP-191. Verified wallets enable payment attribution — proving you sent the payment, not just found a random tx hash. Without signature, the wallet is set but unverified.

Argument	Type	Description
nonce	string	The nonce returned by get_wallet_nonce
agent_id*	string	Your registered agent ID
agent_key*	string	Your agent API key (starts with hp_)
signature	string	EIP-191 signature of the challenge message from get_wallet_nonce
wallet_address*	string	EVM wallet address (0x...)
wallet_network	string	Blockchain network (default: "base"). Options: base, ethereum, polygon, arbitrum

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "agent_key",
    "wallet_address"
  ],
  "properties": {
    "nonce": {
      "type": "string",
      "description": "The nonce returned by get_wallet_nonce"
    },
    "agent_id": {
      "type": "string",
      "description": "Your registered agent ID"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    },
    "signature": {
      "type": "string",
      "description": "EIP-191 signature of the challenge message from get_wallet_nonce"
    },
    "wallet_address": {
      "type": "string",
      "description": "EVM wallet address (0x...)"
    },
    "wallet_network": {
      "enum": [
        "base",
        "ethereum",
        "polygon",
        "arbitrum",
        "base-sepolia"
      ],
      "type": "string",
      "description": "Blockchain network (default: \"base\"). Options: base, ethereum, polygon, arbitrum"
    }
  }
}

start_stream

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) Wrap USDC to USDCx at the Super Token address for the chain, (2) Call createFlow() on CFAv1Forwarder (0xcfA132E353cB4E398080B9700609bb008eceB125) with token=USDCx, receiver=human wallet, flowRate=calculated rate, (3) Call start_stream with your sender address — backend verifies the flow on-chain. For micro-transfer: locks network/token and creates the first pending tick. Prefer L2s (Base, Arbitrum, Polygon) for lower gas costs.

Argument	Type	Description
token	string	Token symbol (default: "USDC")
job_id*	string	The job ID
network*	string	Blockchain network (e.g., "base", "polygon", "arbitrum")
agent_key*	string	Your agent API key (starts with hp_)
sender_address*	string	Your wallet address that created the flow (Superfluid) or will send payments (micro-transfer)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id",
    "agent_key",
    "sender_address",
    "network"
  ],
  "properties": {
    "token": {
      "type": "string",
      "description": "Token symbol (default: \"USDC\")"
    },
    "job_id": {
      "type": "string",
      "description": "The job ID"
    },
    "network": {
      "type": "string",
      "description": "Blockchain network (e.g., \"base\", \"polygon\", \"arbitrum\")"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    },
    "sender_address": {
      "type": "string",
      "description": "Your wallet address that created the flow (Superfluid) or will send payments (micro-transfer)"
    }
  }
}

stop_stream

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

Argument	Type	Description
job_id*	string	The job ID
agent_key*	string	Your agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "job_id",
    "agent_key"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "The job ID"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    }
  }
}

submit_verdict

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, arbitratorFee, nonce }.

Argument	Type	Description
nonce*	string	Unique nonce for replay protection
job_id*	string	The disputed job ID
to_payee*	string	Amount to send to worker (raw USDC, 6 decimals, e.g. "70000000" for $70)
agent_key*	string	Your agent API key
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)
arbitrator_fee*	string	Your fee amount (raw USDC, 6 decimals). Must match your locked rate.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_key",
    "job_id",
    "to_payee",
    "to_depositor",
    "arbitrator_fee",
    "nonce",
    "signature"
  ],
  "properties": {
    "nonce": {
      "type": "string",
      "description": "Unique nonce for replay protection"
    },
    "job_id": {
      "type": "string",
      "description": "The disputed job ID"
    },
    "to_payee": {
      "type": "string",
      "description": "Amount to send to worker (raw USDC, 6 decimals, e.g. \"70000000\" for $70)"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key"
    },
    "signature": {
      "type": "string",
      "description": "EIP-712 signature of the Verdict struct (hex string starting with 0x)"
    },
    "to_depositor": {
      "type": "string",
      "description": "Amount to refund to payer (raw USDC, 6 decimals)"
    },
    "arbitrator_fee": {
      "type": "string",
      "description": "Your fee amount (raw USDC, 6 decimals). Must match your locked rate."
    }
  }
}

verify_agent_domain

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).

Argument	Type	Description
method*	string	Verification method: "well-known" or "dns"
agent_id*	string	The registered agent ID
agent_key*	string	The agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_id",
    "agent_key",
    "method"
  ],
  "properties": {
    "method": {
      "enum": [
        "well-known",
        "dns"
      ],
      "type": "string",
      "description": "Verification method: \"well-known\" or \"dns\""
    },
    "agent_id": {
      "type": "string",
      "description": "The registered agent ID"
    },
    "agent_key": {
      "type": "string",
      "description": "The agent API key (starts with hp_)"
    }
  }
}

verify_payment_activation

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

Argument	Type	Description
network*	string	The blockchain network (e.g., "ethereum", "base", "solana")
tx_hash*	string	The on-chain transaction hash of the activation payment
agent_key*	string	Your registered agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_key",
    "tx_hash",
    "network"
  ],
  "properties": {
    "network": {
      "type": "string",
      "description": "The blockchain network (e.g., \"ethereum\", \"base\", \"solana\")"
    },
    "tx_hash": {
      "type": "string",
      "description": "The on-chain transaction hash of the activation payment"
    },
    "agent_key": {
      "type": "string",
      "description": "Your registered agent API key (starts with hp_)"
    }
  }
}

verify_social_activation

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.

Argument	Type	Description
post_url*	string	URL of the social media post containing your activation code
agent_key*	string	Your registered agent API key (starts with hp_)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_key",
    "post_url"
  ],
  "properties": {
    "post_url": {
      "type": "string",
      "description": "URL of the social media post containing your activation code"
    },
    "agent_key": {
      "type": "string",
      "description": "Your registered agent API key (starts with hp_)"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "human_id",
    "title",
    "description",
    "price_usd",
    "agent_id",
    "agent_key"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Title of the job/task"
    },
    "agent_id": {
      "type": "string",
      "description": "Your unique agent identifier (any string)"
    },
    "category": {
      "type": "string",
      "description": "Category of the task (e.g., \"photography\", \"research\", \"delivery\", \"cleaning\")"
    },
    "human_id": {
      "type": "string",
      "description": "The ID of the human to hire"
    },
    "agent_key": {
      "type": "string",
      "description": "Your registered agent API key (starts with hp_). Required."
    },
    "agent_lat": {
      "type": "number",
      "description": "Agent latitude for distance filtering. Required if human has maxOfferDistance set."
    },
    "agent_lng": {
      "type": "number",
      "description": "Agent longitude for distance filtering. Required if human has maxOfferDistance set."
    },
    "price_usd": {
      "type": "number",
      "description": "Agreed price in USD. Must meet the human's minOfferPrice if set. Payment method (crypto or fiat) is flexible — agreed after acceptance."
    },
    "agent_name": {
      "type": "string",
      "description": "Display name override (defaults to registered agent name)"
    },
    "description": {
      "type": "string",
      "description": "Detailed description of what needs to be done"
    },
    "callback_url": {
      "type": "string",
      "description": "Webhook URL to receive job status updates (ACCEPTED, REJECTED, PAID, COMPLETED). Must be a public HTTP(S) endpoint."
    },
    "payment_mode": {
      "enum": [
        "ONE_TIME",
        "STREAM",
        "ESCROW"
      ],
      "type": "string",
      "description": "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-released after dispute window."
    },
    "stream_method": {
      "enum": [
        "SUPERFLUID",
        "MICRO_TRANSFER"
      ],
      "type": "string",
      "description": "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."
    },
    "payment_timing": {
      "enum": [
        "upfront",
        "upon_completion"
      ],
      "type": "string",
      "description": "For ONE_TIME jobs only. \"upfront\" (default) = pay before work. \"upon_completion\" = pay after work is done."
    },
    "callback_secret": {
      "type": "string",
      "description": "Secret for HMAC-SHA256 signature verification (min 16 chars). The signature is sent in X-HumanPages-Signature header."
    },
    "stream_interval": {
      "enum": [
        "HOURLY",
        "DAILY",
        "WEEKLY"
      ],
      "type": "string",
      "description": "How often payments are made/checkpointed. Required when payment_mode=STREAM."
    },
    "stream_rate_usd": {
      "type": "number",
      "description": "USD 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_ticks": {
      "type": "number",
      "description": "Optional cap on number of payment intervals. Null = indefinite."
    },
    "preferred_payment_method": {
      "enum": [
        "crypto",
        "fiat",
        "any"
      ],
      "type": "string",
      "description": "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."
    },
    "escrow_arbitrator_address": {
      "type": "string",
      "description": "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%)."
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "agent_key",
    "title",
    "description",
    "budget_usd",
    "expires_at"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Title of the listing (e.g., \"Social media promotion for AI product\")"
    },
    "category": {
      "type": "string",
      "description": "Category (e.g., \"marketing\", \"photography\", \"research\")"
    },
    "location": {
      "type": "string",
      "description": "Location name for the work (e.g., \"San Francisco\")"
    },
    "agent_key": {
      "type": "string",
      "description": "Your agent API key (starts with hp_)"
    },
    "radius_km": {
      "type": "number",
      "description": "Radius in km for location-based filtering"
    },
    "work_mode": {
      "enum": [
        "REMOTE",
        "ONSITE",
        "HYBRID"
      ],
      "type": "string",
      "description": "Work mode for the listing"
    },
    "budget_usd": {
      "type": "number",
      "description": "Budget in USD (minimum $5). Payment method is flexible — agreed between agent and human."
    },
    "expires_at": {
      "type": "string",
      "description": "ISO 8601 expiration date (must be in future, max 90 days). Example: \"2025-03-01T00:00:00Z\""
    },
    "description": {
      "type": "string",
      "description": "Detailed description of the work, expectations, and deliverables"
    },
    "callback_url": {
      "type": "string",
      "description": "Webhook URL for application notifications"
    },
    "location_lat": {
      "type": "number",
      "description": "Latitude for location-based filtering"
    },
    "location_lng": {
      "type": "number",
      "description": "Longitude for location-based filtering"
    },
    "max_applicants": {
      "type": "number",
      "description": "Maximum number of applicants before listing auto-closes"
    },
    "callback_secret": {
      "type": "string",
      "description": "Secret for HMAC-SHA256 webhook signature (min 16 chars)"
    },
    "location_postal": {
      "type": "string",
      "description": "Postal/zip code (e.g., \"94105\"). Improves Google Search visibility."
    },
    "location_region": {
      "type": "string",
      "description": "State or province (e.g., \"California\", \"Metro Manila\"). Improves Google Search visibility."
    },
    "location_street": {
      "type": "string",
      "description": "Street address (e.g., \"123 Main St\"). Improves Google Search visibility."
    },
    "required_skills": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Skills applicants should have (e.g., [\"social-media\", \"copywriting\"])"
    },
    "location_country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code (e.g., \"US\", \"PH\"). Improves Google Search visibility."
    },
    "location_locality": {
      "type": "string",
      "description": "City name (e.g., \"San Francisco\", \"Manila\"). Improves Google Search visibility."
    },
    "required_equipment": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Equipment applicants should have (e.g., [\"camera\", \"drone\"])"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "description": "Latitude for radius search (requires lng and radius)"
    },
    "lng": {
      "type": "number",
      "description": "Longitude for radius search (requires lat and radius)"
    },
    "field": {
      "type": "string",
      "description": "Filter by field of study (e.g., \"Computer Science\", \"Marketing\"). Partial match, case-insensitive."
    },
    "skill": {
      "type": "string",
      "description": "Filter by skill tag (e.g., \"photography\", \"driving\", \"cleaning\", \"notary\")"
    },
    "degree": {
      "type": "string",
      "description": "Filter by education degree (e.g., \"Bachelor\", \"MBA\", \"PhD\"). Partial match, case-insensitive."
    },
    "radius": {
      "type": "number",
      "description": "Search radius in kilometers (default: 30km). Works with both text location and explicit lat/lng coordinates."
    },
    "sort_by": {
      "enum": [
        "completed_jobs",
        "rating",
        "experience",
        "recent"
      ],
      "type": "string",
      "description": "Sort 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."
    },
    "language": {
      "type": "string",
      "description": "Filter by language ISO code (e.g., \"en\", \"es\", \"zh\")"
    },
    "location": {
      "type": "string",
      "description": "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 searches within a radius (default 30km). Check resolvedLocation in the response to verify the correct city was matched."
    },
    "max_rate": {
      "type": "number",
      "description": "Maximum hourly rate in USD. Humans who set rates in other currencies are auto-converted to USD for comparison."
    },
    "verified": {
      "enum": [
        "humanity"
      ],
      "type": "string",
      "description": "Filter by verification status. Use \"humanity\" to only return humans who have verified their identity via Gitcoin Passport (score >= 20)."
    },
    "equipment": {
      "type": "string",
      "description": "Filter by equipment (e.g., \"car\", \"drone\", \"camera\")"
    },
    "has_photo": {
      "type": "boolean",
      "description": "Only return humans with an approved profile photo."
    },
    "work_mode": {
      "enum": [
        "REMOTE",
        "ONSITE",
        "HYBRID"
      ],
      "type": "string",
      "description": "Filter by work mode preference (REMOTE, ONSITE, or HYBRID)"
    },
    "certificate": {
      "type": "string",
      "description": "Filter by certificate name or issuer (e.g., \"AWS\", \"PMP\", \"Google\"). Partial match, case-insensitive."
    },
    "institution": {
      "type": "string",
      "description": "Filter by educational institution name (e.g., \"MIT\", \"Oxford\"). Partial match, case-insensitive."
    },
    "min_vouches": {
      "type": "number",
      "description": "Only return humans vouched for by at least this many other users."
    },
    "min_channels": {
      "type": "number",
      "description": "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 offers."
    },
    "payment_type": {
      "enum": [
        "UPFRONT",
        "ESCROW",
        "UPON_COMPLETION"
      ],
      "type": "string",
      "description": "Filter by accepted payment type (UPFRONT, ESCROW, or UPON_COMPLETION)"
    },
    "fiat_platform": {
      "type": "string",
      "description": "Filter by fiat payment platform the human accepts (e.g., \"WISE\", \"PAYPAL\", \"VENMO\", \"REVOLUT\", \"CASHAPP\", \"ZELLE\", \"MONZO\", \"N26\", \"MERCADOPAGO\")"
    },
    "accepts_crypto": {
      "type": "boolean",
      "description": "Filter to only show humans who have a crypto wallet set up and can accept USDC payments"
    },
    "available_only": {
      "type": "boolean",
      "default": true,
      "description": "Only return humans who are currently available (default: true)"
    },
    "min_experience": {
      "type": "number",
      "description": "Minimum years of professional experience"
    },
    "has_verified_login": {
      "type": "boolean",
      "description": "Only return humans who have verified their identity via an OAuth provider (Google, LinkedIn, or GitHub). Does not reveal which provider."
    },
    "min_completed_jobs": {
      "type": "number",
      "description": "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 skill filter needed."
    }
  }
}