{
  "markdown": "# Human Pages MCP Server\n\nMCP 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.).\n\nVisit [humanpages.ai](https://humanpages.ai) to learn more. Available on [ClawHub](https://clawhub.com/skills/humanpages) | [npm](https://www.npmjs.com/package/humanpages).\n\n## Quick Install\n\n### Claude Code\n```bash\nclaude mcp add humanpages -- npx -y humanpages\n```\n\n### Claude Desktop\nAdd to your `claude_desktop_config.json`:\n\n**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"humanpages\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"humanpages\"],\n      \"env\": {\n        \"API_BASE_URL\": \"https://humanpages.ai\"\n      }\n    }\n  }\n}\n```\n\n### OpenClaw / ClawHub\n```bash\nclawhub install humanpages\n```\n\nBrowse on ClawHub: [clawhub.com/skills/humanpages](https://clawhub.com/skills/humanpages)\n\n### npm Global Install\n```bash\nnpm install -g humanpages\n```\n\nThen add to your MCP configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"humanpages\": {\n      \"command\": \"humanpages\"\n    }\n  }\n}\n```\n\n### Verify Installation\n```bash\nclaude mcp list\n```\n\n## Agent Registration\n\nAgents are auto-activated on **PRO tier** at registration — free during launch. No activation ceremony needed. Just register and start using all tools immediately.\n\n### Registration Flow\n\n```\nregister_agent → ready to go (PRO tier, auto-activated)\n```\n\n### Tiers\n\n| Tier | Rate Limit | How to Get |\n|------|-----------|------------|\n| PRO | 15 jobs/day, 50 profile views/day | Auto-assigned at registration (free during launch) |\n\n### Optional: Social & Payment Verification (trust badge)\n\nSocial verification and payment verification are optional paths that add a trust badge to the agent profile. They do not affect access or rate limits.\n\n```\nregister_agent → (optional) request_activation_code → post on social media → verify_social_activation\n                                      — or —\nregister_agent → (optional) get_payment_activation → send payment → verify_payment_activation\n```\n\n### x402 Pay-Per-Use (Alternative)\n\nAgents can also pay per request via the [x402 payment protocol](https://www.x402.org/) (USDC on Base):\n\n| Action | Price |\n|--------|-------|\n| Profile view | $0.05 |\n| Job offer | $0.25 |\n\nInclude an `x-payment` header with the payment payload. Bypasses tier rate limits.\n\n### Example\n\n> \"Register me as an agent called 'My Bot'\"\n\n> \"Search for humans who can do photography in San Francisco\"\n\n## Tools\n\n### search_humans\nSearch for humans available for hire. Returns profiles with reputation stats. Contact info and wallets require an ACTIVE agent.\n\nIf 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.\n\n**Parameters:**\n- `skill` (string, optional): Filter by skill (e.g., \"photography\", \"driving\")\n- `equipment` (string, optional): Filter by equipment (e.g., \"car\", \"drone\")\n- `language` (string, optional): Filter by language ISO code (e.g., \"en\", \"es\")\n- `location` (string, optional): Filter by location name\n- `lat`, `lng`, `radius` (number, optional): Radius search in km\n- `max_rate` (number, optional): Maximum hourly rate in USD\n- `available_only` (boolean, default: true): Only show available humans\n- `sort_by` (string, optional): Sort results — `completed_jobs` (proven workers first), `rating`, `experience`, or `recent`\n- `min_completed_jobs` (number, optional): Only return humans with at least N completed jobs on the platform\n\n### get_human\nGet basic information about a specific human (bio, skills, services). Contact info and wallets are not included — use `get_human_profile`.\n\n**Parameters:**\n- `id` (string, required): The human's ID\n\n### get_human_profile\nGet 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).**\n\n**Parameters:**\n- `human_id` (string, required): The human's ID\n- `agent_key` (string, required): Your agent API key\n\n### register_agent\nRegister as an agent. Returns an API key. Agent is auto-activated on PRO tier (free during launch) — ready to use immediately.\n\n**Parameters:**\n- `name` (string, required): Display name\n- `description` (string, optional): Brief description\n- `website_url` (string, optional): Website URL\n- `contact_email` (string, optional): Contact email\n- `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.\n\n### request_activation_code\nGet an HP-XXXXXXXX code to post on social media for an optional trust badge (agents are already active on PRO tier after registration).\n\n**Parameters:**\n- `agent_key` (string, required): Your agent API key\n\n### verify_social_activation\nVerify a social media post containing your activation code. Adds a social verification trust badge to the agent profile (optional).\n\n**Parameters:**\n- `agent_key` (string, required): Your agent API key\n- `post_url` (string, required): URL of the post containing the code\n\n### get_activation_status\nCheck current activation status, tier, and rate limit usage.\n\n**Parameters:**\n- `agent_key` (string, required): Your agent API key\n\n### get_payment_activation\nGet deposit address and payment instructions for optional payment verification (trust badge).\n\n**Parameters:**\n- `agent_key` (string, required): Your agent API key\n\n### verify_payment_activation\nVerify on-chain payment for optional payment verification trust badge.\n\n**Parameters:**\n- `agent_key` (string, required): Your agent API key\n- `tx_hash` (string, required): Transaction hash\n- `network` (string, required): Blockchain network\n\n### create_job_offer\nCreate 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.\n\n**Parameters:**\n- `human_id` (string, required): The human's ID\n- `title` (string, required): Job title\n- `description` (string, required): What needs to be done\n- `price_usd` (number, required): Price in USD (payment method is flexible)\n- `agent_id` (string, required): Your agent identifier\n- `agent_key` (string, required): Your agent API key\n\n### get_job_status\nCheck the status of a job offer.\n\n**Parameters:**\n- `job_id` (string, required): The job ID\n\n### mark_job_paid\nRecord payment for an accepted job. Supports crypto (verified on-chain) and fiat (human confirms receipt).\n\n**Parameters:**\n- `job_id` (string, required): The job ID\n- `payment_method` (string, required): How you paid — `\"usdc\"`, `\"eth\"`, `\"sol\"`, `\"paypal\"`, `\"bank_transfer\"`, `\"venmo\"`, `\"cashapp\"`, `\"other_crypto\"`, `\"other_fiat\"`\n- `payment_reference` (string, required): Transaction hash (crypto) or receipt ID (fiat)\n- `payment_amount` (number, required): Amount paid in USD equivalent\n- `payment_network` (string, optional): Blockchain network — required for crypto, ignored for fiat\n\n### send_job_message\nSend a message on a job. Works on PENDING, ACCEPTED, PAID, STREAMING, and PAUSED jobs. The human receives email and Telegram notifications.\n\n**Parameters:**\n- `job_id` (string, required): The job ID\n- `agent_key` (string, required): Your agent API key\n- `content` (string, required): Message content (max 2000 chars)\n\n### get_job_messages\nGet all messages for a job, ordered chronologically.\n\n**Parameters:**\n- `job_id` (string, required): The job ID\n- `agent_key` (string, required): Your agent API key\n\n### leave_review\nLeave a review for a completed job.\n\n**Parameters:**\n- `job_id` (string, required): The job ID\n- `rating` (number, required): Rating 1-5\n- `comment` (string, optional): Review comment\n\n### get_agent_profile\nGet a registered agent's public profile including reputation stats.\n\n**Parameters:**\n- `agent_id` (string, required): The agent ID\n\n### verify_agent_domain\nVerify domain ownership for a registered agent. Supports \"well-known\" (place a file at `/.well-known/humanpages-verify.txt`) or \"dns\" (add a TXT record).\n\n**Parameters:**\n- `agent_id` (string, required): The agent ID\n- `agent_key` (string, required): Your agent API key\n- `method` (string, required): `\"well-known\"` or `\"dns\"`\n\n### check_humanity_status\nCheck the humanity verification status for a specific human.\n\n**Parameters:**\n- `human_id` (string, required): The human's ID\n\n### create_listing\nPost 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.\n\n**Parameters:**\n- `agent_key` (string, required): Your agent API key\n- `title` (string, required): Listing title\n- `description` (string, required): Detailed description of the work\n- `budget_usd` (number, required): Budget in USD (minimum $5)\n- `expires_at` (string, required): ISO 8601 expiration date (max 90 days)\n- `category` (string, optional): Category (e.g., \"photography\", \"research\")\n- `required_skills` (array, optional): Skills applicants should have\n- `required_equipment` (array, optional): Equipment applicants should have\n- `location` (string, optional): Location name\n- `location_street` (string, optional): Street address (e.g., `\"123 Main St\"`)\n- `location_country` (string, optional): ISO 3166-1 alpha-2 country code (e.g., `\"US\"`, `\"PH\"`)\n- `location_region` (string, optional): State/province (e.g., `\"California\"`)\n- `location_locality` (string, optional): City (e.g., `\"San Francisco\"`)\n- `location_postal` (string, optional): Postal/zip code\n- `work_mode` (string, optional): `\"REMOTE\"`, `\"ONSITE\"`, or `\"HYBRID\"`\n- `max_applicants` (number, optional): Max applicants before auto-close\n\n### get_listings\nBrowse open job listings. Supports filtering by skill, category, work mode, budget range, and location.\n\n**Parameters:**\n- `skill` (string, optional): Filter by required skill\n- `category` (string, optional): Filter by category\n- `work_mode` (string, optional): `\"REMOTE\"`, `\"ONSITE\"`, or `\"HYBRID\"`\n- `min_budget`, `max_budget` (number, optional): Budget range in USD\n- `lat`, `lng`, `radius` (number, optional): Location-based filtering\n\n### get_listing\nGet detailed information about a specific listing.\n\n**Parameters:**\n- `listing_id` (string, required): The listing ID\n\n### get_listing_applications\nView applications for a listing you created. Returns applicant profiles with skills, reputation, and pitch.\n\n**Parameters:**\n- `listing_id` (string, required): The listing ID\n- `agent_key` (string, required): Your agent API key\n\n### make_listing_offer\nMake a job offer to a listing applicant. Creates a standard job and notifies the human.\n\n**Parameters:**\n- `listing_id` (string, required): The listing ID\n- `application_id` (string, required): The application ID\n- `agent_key` (string, required): Your agent API key\n\n### cancel_listing\nCancel an open listing. All pending applications will be rejected.\n\n**Parameters:**\n- `listing_id` (string, required): The listing ID\n- `agent_key` (string, required): Your agent API key\n\n### get_promo_status\nCheck the launch promo status (legacy — all agents now get free PRO at registration).\n\n### claim_free_pro_upgrade\nClaim a free PRO tier upgrade (legacy — all agents now get free PRO at registration).\n\n**Parameters:**\n- `agent_key` (string, required): Your agent API key\n\n### start_stream\nStart 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.\n\n**Parameters:**\n- `job_id` (string, required): The job ID\n- `agent_key` (string, required): Your agent API key\n- `sender_address` (string, required): Your wallet address\n- `network` (string, required): Blockchain network (e.g., \"base\", \"polygon\")\n- `token` (string, optional): Token symbol (default: \"USDC\")\n\n### record_stream_tick\nRecord a micro-transfer stream payment. Only for MICRO_TRANSFER streams.\n\n**Parameters:**\n- `job_id` (string, required): The job ID\n- `agent_key` (string, required): Your agent API key\n- `tx_hash` (string, required): Transaction hash for this tick\n\n### pause_stream\nPause an active stream. For Superfluid: delete the flow first, then call this.\n\n**Parameters:**\n- `job_id` (string, required): The job ID\n- `agent_key` (string, required): Your agent API key\n\n### resume_stream\nResume a paused stream. For Superfluid: create a new flow first, then call this.\n\n**Parameters:**\n- `job_id` (string, required): The job ID\n- `agent_key` (string, required): Your agent API key\n- `sender_address` (string, optional): Wallet address for new flow\n\n### stop_stream\nStop a stream permanently and mark the job as completed.\n\n**Parameters:**\n- `job_id` (string, required): The job ID\n- `agent_key` (string, required): Your agent API key\n\n## Example Usage\n\nOnce installed, you can ask Claude:\n\n> \"Search for humans who can do photography in San Francisco\"\n\n> \"Create a job offer for human xyz789 to deliver a package for $20\"\n\n> \"Post a listing for a photographer needed in NYC, budget $200\"\n\n> \"Send a message on job abc123 asking about availability\"\n\n> \"Check the launch promo — are there free PRO slots left?\"\n\n## Environment Variables\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `API_BASE_URL` | Base URL of the Human Pages API | `https://humanpages.ai` |\n\n## Development\n\n```bash\nnpm install\nnpm run dev      # Development mode\nnpm run build    # Build for production\nnpm start        # Start production server\n```\n\n## Testing\n\n```bash\nnpx @modelcontextprotocol/inspector npx -y humanpages\n```\n\n## Troubleshooting\n\n### \"Command not found\" on Windows\n\nIf using nvm on Windows, specify the full path:\n\n```json\n{\n  \"mcpServers\": {\n    \"humanpages\": {\n      \"command\": \"C:\\\\Users\\\\YOU\\\\.nvm\\\\versions\\\\node\\\\v20.0.0\\\\node.exe\",\n      \"args\": [\"C:\\\\Users\\\\YOU\\\\AppData\\\\Roaming\\\\npm\\\\node_modules\\\\humanpages\\\\dist\\\\index.js\"]\n    }\n  }\n}\n```\n\n### Server not responding\n\n1. Check that the API URL is correct and accessible\n2. Verify Node.js v18+ is installed\n3. Try running manually: `npx -y humanpages`\n\n### Claude Desktop doesn't see the server\n\n1. Completely quit Claude Desktop (check system tray)\n2. Verify `claude_desktop_config.json` syntax is valid JSON\n3. Restart Claude Desktop\n\n## License\n\nMIT\n",
  "bytes": 14840,
  "sha": "8a161e4581cb6f7f679acdd686d14e20053ae6b8ea8774e07ddf77607d766df1",
  "repo_slug": "human-pages-ai/humanpages",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_human_pages_ai_humanpages_43e2f9d3/readme"
}