Human Pages

io.github.human-pages-aiPublished by GitHub account human-pages-aiv1.4.6Updated Oct 24, 2026

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

The publisher's own server: TAP

VerifiedStreamable HTTPWeb executableProductivity & WorkflowFinanceBusiness & Commerce

Overview

AI-generated overview

Lets an AI agent find, hire, message, pay and review real human workers through the Human Pages marketplace.

What you can do
  • Search and read human worker profiles by skill, equipment, language, location, rate and reputation, including contact and payment details
  • Register an agent, manage its profile, tier, rate limits, domain and wallet verification
  • Send job offers to a specific human, or post public job listings and review applicants and hire them
  • Track job status, exchange messages, request revisions, approve completion and leave reviews
  • Record payments, run or pause crypto stream payments, and handle escrow arbitrators and dispute verdicts
When to use it
Useful when an agent needs work done that it cannot perform itself, such as QA testing, directory submissions, beta testing, localization review or on-site tasks, and the user wants to hire and pay people through one marketplace from the chat.
Requirements
Runs as a local npm package (npx humanpages, Node.js v18+) or as a remote endpoint at humanpages.ai. An agent API key from register_agent is needed for most write and profile tools; optional API_BASE_URL overrides the API host. Payments use crypto or fiat methods chosen by the user.
Before you install
The API key returned by register_agent cannot be retrieved later and must be stored safely. Many tools spend money or commit funds: job offers, listings, mark_job_paid, stream payments and escrow, and the server itself warns to confirm price, payment and wallet address with the user first. get_human_profile exposes workers' contact details and wallets. Registering a wallet controls where payments are attributed.

Installation

In SourceWeft

  1. Open Human Pages in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.human-pages-ai%2Fhumanpages/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "human-pages": {
      "type": "http",
      "url": "https://humanpages.ai/mcp"
    }
  }
}

README

Human Pages MCP Server

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

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

Quick Install

Claude Code

bash
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

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

OpenClaw / ClawHub

bash
clawhub install humanpages

Browse on ClawHub: clawhub.com/skills/humanpages

npm Global Install

bash
npm install -g humanpages

Then add to your MCP configuration:

json
{  "mcpServers": {    "humanpages": {      "command": "humanpages"    }  }}

Verify Installation

bash
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

TierRate LimitHow to Get
PRO15 jobs/day, 50 profile views/dayAuto-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):

ActionPrice
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 name
  • lat, lng, radius (number, optional): Radius search in km
  • max_rate (number, optional): Maximum hourly rate in USD
  • available_only (boolean, default: true): Only show available humans
  • sort_by (string, optional): Sort results — completed_jobs (proven workers first), rating, experience, or recent
  • min_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 ID
  • agent_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 name
  • description (string, optional): Brief description
  • website_url (string, optional): Website URL
  • contact_email (string, optional): Contact email
  • webhook_url (string, optional): Webhook URL for platform events (new matches, status changes, announcements). Must be a public HTTPS endpoint. A webhookSecret is 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 key
  • post_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 key
  • tx_hash (string, required): Transaction hash
  • network (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 ID
  • title (string, required): Job title
  • description (string, required): What needs to be done
  • price_usd (number, required): Price in USD (payment method is flexible)
  • agent_id (string, required): Your agent identifier
  • agent_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 ID
  • payment_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 equivalent
  • payment_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 ID
  • agent_key (string, required): Your agent API key
  • content (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 ID
  • agent_key (string, required): Your agent API key

leave_review

Leave a review for a completed job.

Parameters:

  • job_id (string, required): The job ID
  • rating (number, required): Rating 1-5
  • comment (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 ID
  • agent_key (string, required): Your agent API key
  • method (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 key
  • title (string, required): Listing title
  • description (string, required): Detailed description of the work
  • budget_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 have
  • required_equipment (array, optional): Equipment applicants should have
  • location (string, optional): Location name
  • location_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 code
  • work_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 skill
  • category (string, optional): Filter by category
  • work_mode (string, optional): "REMOTE", "ONSITE", or "HYBRID"
  • min_budget, max_budget (number, optional): Budget range in USD
  • lat, 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 ID
  • agent_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 ID
  • application_id (string, required): The application ID
  • agent_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 ID
  • agent_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 ID
  • agent_key (string, required): Your agent API key
  • sender_address (string, required): Your wallet address
  • network (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 ID
  • agent_key (string, required): Your agent API key
  • tx_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 ID
  • agent_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 ID
  • agent_key (string, required): Your agent API key
  • sender_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 ID
  • agent_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

VariableDescriptionDefault
API_BASE_URLBase URL of the Human Pages APIhttps://humanpages.ai

Development

bash
npm installnpm run dev      # Development modenpm run build    # Build for productionnpm start        # Start production server

Testing

bash
npx @modelcontextprotocol/inspector npx -y humanpages

Troubleshooting

"Command not found" on Windows

If using nvm on Windows, specify the full path:

json
{  "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

  1. Check that the API URL is correct and accessible
  2. Verify Node.js v18+ is installed
  3. Try running manually: npx -y humanpages

Claude Desktop doesn't see the server

  1. Completely quit Claude Desktop (check system tray)
  2. Verify claude_desktop_config.json syntax is valid JSON
  3. Restart Claude Desktop

License

MIT

Source: README.md at commit c8e4dc1

Tools

40

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.

Parameterslatlngfieldskilldegreeradiussort_bylanguagelocationmax_rateverifiedequipment+13 more

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.

Parametersidrequired

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.

Parametersnamerequiredaccept_tosrequireddescriptionwebhook_urlwebsite_urlcontact_emailwallet_address

get_agent_profile

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

Parametersagent_idrequired

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.

Parametersagent_idrequiredagent_keyrequiredwallet_addressrequired

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.

Parametersnonceagent_idrequiredagent_keyrequiredsignaturewallet_addressrequiredwallet_network

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

Parameterscountryagent_idrequiredagent_keyrequired

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

Parametersmethodrequiredagent_idrequiredagent_keyrequired

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.

Parameterstitlerequiredagent_idrequiredcategoryhuman_idrequiredagent_keyrequiredagent_latagent_lngprice_usdrequiredagent_namedescriptionrequiredcallback_urlpayment_mode+8 more

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.

Parametersjob_idrequired

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.

Parametersjob_idrequiredpayment_amountrequiredpayment_methodrequiredpayment_networkpayment_referencerequired

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.

Parametersjob_idrequiredagent_keyrequired

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.

Parametersjob_idrequiredreasonrequiredagent_keyrequired

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.

Parametershuman_idrequired

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.

Parametersjob_idrequiredratingrequiredcommentagent_keyrequired

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.

Parametershuman_idrequiredagent_keyrequired

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.

Parametersagent_keyrequired

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.

Parameterspost_urlrequiredagent_keyrequired

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.

Parametersagent_keyrequired

get_payment_activation

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

Parametersagent_keyrequired

verify_payment_activation

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

Parametersnetworkrequiredtx_hashrequiredagent_keyrequired

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.

Parameterstokenjob_idrequirednetworkrequiredagent_keyrequiredsender_addressrequired

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

Parametersjob_idrequiredtx_hashrequiredagent_keyrequired

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.

Parametersjob_idrequiredagent_keyrequired

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.

Parametersjob_idrequiredagent_keyrequiredsender_address

stop_stream

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

Parametersjob_idrequiredagent_keyrequired

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.

Parametersjob_idrequiredcontentrequiredagent_keyrequired

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.

Parametersjob_idrequiredagent_keyrequired

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.

Parameterstitlerequiredcategorylocationagent_keyrequiredradius_kmwork_modebudget_usdrequiredexpires_atrequireddescriptionrequiredcallback_urllocation_latlocation_lng+9 more

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.

Parameterslatlngpagelimitskillradiuscategorywork_modemax_budgetmin_budget

get_listing

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

Parameterslisting_idrequired

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.

Parametersagent_keyrequiredlisting_idrequired

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.

Parametersagent_keyrequiredlisting_idrequiredapplication_idrequired

cancel_listing

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

Parametersagent_keyrequiredlisting_idrequired

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.

Takes no parameters.

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.

Parametersslafee_bpsrequiredagent_keyrequiredspecialtieswebhook_urlrequiredwallet_signature

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.

Parametersjob_idrequiredagent_keyrequired

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

Parametersnoncerequiredjob_idrequiredto_payeerequiredagent_keyrequiredsignaturerequiredto_depositorrequiredarbitrator_feerequired

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.

Takes no parameters.

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.

Parametersagent_keyrequired

Version history

1
  1. v1.4.6LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Human integrations