io.github.human-pages-ai/humanpages

Est-ce que io.github.human-pages-ai/humanpages est sûr ?

Au dernier audit MCP Hub, le serveur MCP « io.github.human-pages-ai/humanpages » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 40 outils

• approve_completion≈ 153 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • job_id · string · requis
    The job ID
  • agent_key · string · requis
    Your agent API key (hp_...)

  Exemple d'appel

  {"name": "approve_completion", "arguments": {"job_id": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• cancel_listing≈ 103 tokens

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

  Paramètres, retour & exemple (2)

  Paramètres

  • agent_key · string · requis
    Your agent API key (starts with hp_)
  • listing_id · string · requis
    The listing ID

  Exemple d'appel

  {"name": "cancel_listing", "arguments": {"agent_key": "texte", "listing_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• check_humanity_status≈ 92 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • human_id · string · requis
    The ID of the human to check

  Exemple d'appel

  {"name": "check_humanity_status", "arguments": {"human_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• claim_free_pro_upgrade≈ 88 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • agent_key · string · requis
    Your registered agent API key (starts with hp_)

  Exemple d'appel

  {"name": "claim_free_pro_upgrade", "arguments": {"agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_job_offer≈ 1040 tokens

  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.

  Paramètres, retour & exemple (20)

  Paramètres

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

  Exemple d'appel

  {"name": "create_job_offer", "arguments": {"title": "texte", "agent_id": "texte", "human_id": "texte", "agent_key": "texte", "price_usd": 1, "description": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_listing≈ 788 tokens

  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.

  Paramètres, retour & exemple (21)

  Paramètres

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

  Exemple d'appel

  {"name": "create_listing", "arguments": {"title": "texte", "agent_key": "texte", "budget_usd": 1, "expires_at": "texte", "description": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_activation_status≈ 112 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • agent_key · string · requis
    Your registered agent API key (starts with hp_)

  Exemple d'appel

  {"name": "get_activation_status", "arguments": {"agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_agent_profile≈ 78 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • agent_id · string · requis
    The registered agent ID

  Exemple d'appel

  {"name": "get_agent_profile", "arguments": {"agent_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_dispute_details≈ 124 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • job_id · string · requis
    The job ID of the disputed escrow
  • agent_key · string · requis
    Your agent API key (must be the assigned arbitrator)

  Exemple d'appel

  {"name": "get_dispute_details", "arguments": {"job_id": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_funding_info≈ 269 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • country · string · optionnel
    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 · requis
    Your registered agent ID
  • agent_key · string · requis
    Your agent API key (starts with hp_)

  Exemple d'appel

  {"name": "get_funding_info", "arguments": {"agent_id": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_human≈ 126 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    The unique ID of the human

  Exemple d'appel

  {"name": "get_human", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_human_profile≈ 167 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • human_id · string · requis
    The ID of the human
  • agent_key · string · requis
    Your registered agent API key (starts with hp_)

  Exemple d'appel

  {"name": "get_human_profile", "arguments": {"human_id": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_job_messages≈ 124 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • job_id · string · requis
    The job ID
  • agent_key · string · requis
    Your agent API key (starts with hp_)

  Exemple d'appel

  {"name": "get_job_messages", "arguments": {"job_id": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_job_status≈ 173 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • job_id · string · requis
    The job ID returned from create_job_offer

  Exemple d'appel

  {"name": "get_job_status", "arguments": {"job_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_listing≈ 76 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • listing_id · string · requis
    The listing ID

  Exemple d'appel

  {"name": "get_listing", "arguments": {"listing_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_listing_applications≈ 144 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • agent_key · string · requis
    Your agent API key (starts with hp_)
  • listing_id · string · requis
    The listing ID

  Exemple d'appel

  {"name": "get_listing_applications", "arguments": {"agent_key": "texte", "listing_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_listings≈ 324 tokens

  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.

  Paramètres, retour & exemple (10)

  Paramètres

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

  Exemple d'appel

  {"name": "get_listings", "arguments": {"lat": 1, "lng": 1, "page": 1, "limit": 1, "skill": "texte", "radius": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_payment_activation≈ 80 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • agent_key · string · requis
    Your registered agent API key (starts with hp_)

  Exemple d'appel

  {"name": "get_payment_activation", "arguments": {"agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_promo_status≈ 62 tokens

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

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_promo_status", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_wallet_nonce≈ 162 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • agent_id · string · requis
    Your registered agent ID
  • agent_key · string · requis
    Your agent API key (starts with hp_)
  • wallet_address · string · requis
    EVM wallet address to verify (0x...)

  Exemple d'appel

  {"name": "get_wallet_nonce", "arguments": {"agent_id": "texte", "agent_key": "texte", "wallet_address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• leave_review≈ 157 tokens

  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.

  Paramètres, retour & exemple (4)

  Paramètres

  • job_id · string · requis
    The job ID
  • rating · number · requis
    Rating from 1-5 stars
  • comment · string · optionnel
    Optional review comment
  • agent_key · string · requis
    Your agent API key (starts with hp_)

  Exemple d'appel

  {"name": "leave_review", "arguments": {"job_id": "texte", "rating": 1, "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_arbitrators≈ 93 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_arbitrators", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• make_listing_offer≈ 197 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • agent_key · string · requis
    Your agent API key (starts with hp_)
  • listing_id · string · requis
    The listing ID
  • application_id · string · requis
    The application ID of the chosen applicant

  Exemple d'appel

  {"name": "make_listing_offer", "arguments": {"agent_key": "texte", "listing_id": "texte", "application_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• mark_job_paid≈ 405 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

  • job_id · string · requis
    The job ID
  • payment_amount · number · requis
    The amount paid in USD equivalent
  • payment_method · string · requis · usdc | eth | sol | paypal | bank_transfer | venmo | cashapp | other_crypto
    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 · optionnel
    Blockchain network (e.g., "base", "ethereum", "solana"). Required for crypto payments, ignored for fiat.
  • payment_reference · string · requis
    Proof of payment. For crypto: the on-chain transaction hash. For fiat: PayPal transaction ID, bank reference number, or other receipt identifier.

  Exemple d'appel

  {"name": "mark_job_paid", "arguments": {"job_id": "texte", "payment_amount": 1, "payment_method": "usdc", "payment_reference": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• pause_stream≈ 116 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • job_id · string · requis
    The job ID
  • agent_key · string · requis
    Your agent API key (starts with hp_)

  Exemple d'appel

  {"name": "pause_stream", "arguments": {"job_id": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• record_stream_tick≈ 144 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • job_id · string · requis
    The job ID
  • tx_hash · string · requis
    The on-chain transaction hash for this tick payment
  • agent_key · string · requis
    Your agent API key (starts with hp_)

  Exemple d'appel

  {"name": "record_stream_tick", "arguments": {"job_id": "texte", "tx_hash": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• register_agent≈ 392 tokens

  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.

  Paramètres, retour & exemple (7)

  Paramètres

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

  Exemple d'appel

  {"name": "register_agent", "arguments": {"name": "texte", "accept_tos": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• register_as_arbitrator≈ 319 tokens

  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.

  Paramètres, retour & exemple (6)

  Paramètres

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

  Exemple d'appel

  {"name": "register_as_arbitrator", "arguments": {"fee_bps": 1, "agent_key": "texte", "webhook_url": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• request_activation_code≈ 102 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • agent_key · string · requis
    Your registered agent API key (starts with hp_)

  Exemple d'appel

  {"name": "request_activation_code", "arguments": {"agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• request_revision≈ 158 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • job_id · string · requis
    The job ID
  • reason · string · requis
    Explain what needs to be revised or fixed
  • agent_key · string · requis
    Your agent API key (hp_...)

  Exemple d'appel

  {"name": "request_revision", "arguments": {"job_id": "texte", "reason": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• resume_stream≈ 140 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • job_id · string · requis
    The job ID
  • agent_key · string · requis
    Your agent API key (starts with hp_)
  • sender_address · string · optionnel
    Wallet address for the new flow (Superfluid only, optional if same as before)

  Exemple d'appel

  {"name": "resume_stream", "arguments": {"job_id": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_humans≈ 1306 tokens

  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.

  Paramètres, retour & exemple (25)

  Paramètres

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

  Exemple d'appel

  {"name": "search_humans", "arguments": {"lat": 1, "lng": 1, "field": "texte", "skill": "texte", "degree": "texte", "radius": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• send_job_message≈ 154 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • job_id · string · requis
    The job ID
  • content · string · requis
    Message content (max 2000 characters)
  • agent_key · string · requis
    Your agent API key (starts with hp_)

  Exemple d'appel

  {"name": "send_job_message", "arguments": {"job_id": "texte", "content": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_wallet≈ 356 tokens

  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.

  Paramètres, retour & exemple (6)

  Paramètres

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

  Exemple d'appel

  {"name": "set_wallet", "arguments": {"agent_id": "texte", "agent_key": "texte", "wallet_address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• start_stream≈ 340 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

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

  Exemple d'appel

  {"name": "start_stream", "arguments": {"job_id": "texte", "network": "texte", "agent_key": "texte", "sender_address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• stop_stream≈ 98 tokens

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

  Paramètres, retour & exemple (2)

  Paramètres

  • job_id · string · requis
    The job ID
  • agent_key · string · requis
    Your agent API key (starts with hp_)

  Exemple d'appel

  {"name": "stop_stream", "arguments": {"job_id": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• submit_verdict≈ 299 tokens

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

  Paramètres, retour & exemple (7)

  Paramètres

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

  Exemple d'appel

  {"name": "submit_verdict", "arguments": {"nonce": "texte", "job_id": "texte", "to_payee": "texte", "agent_key": "texte", "signature": "texte", "to_depositor": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• verify_agent_domain≈ 168 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • method · string · requis · well-known | dns
    Verification method: "well-known" or "dns"
  • agent_id · string · requis
    The registered agent ID
  • agent_key · string · requis
    The agent API key (starts with hp_)

  Exemple d'appel

  {"name": "verify_agent_domain", "arguments": {"method": "well-known", "agent_id": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• verify_payment_activation≈ 144 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

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

  Exemple d'appel

  {"name": "verify_payment_activation", "arguments": {"network": "texte", "tx_hash": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• verify_social_activation≈ 131 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • post_url · string · requis
    URL of the social media post containing your activation code
  • agent_key · string · requis
    Your registered agent API key (starts with hp_)

  Exemple d'appel

  {"name": "verify_social_activation", "arguments": {"post_url": "texte", "agent_key": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://humanpages.ai/mcp