Package Exports

@hirehuman/mcp
@hirehuman/mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@hirehuman/mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

hirehuman-mcp

MCP server for HireHumans.eu — book verified humans for physical real-world tasks via AI agents.

Search for available humans by location, browse 80+ task types across 12 categories, get price estimates, book tasks with GPS-verified photo proof, post bounties for competitive pricing, and communicate with humans in real time. EU-hosted and GDPR-compliant.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "hirehuman": {
      "command": "npx",
      "args": ["-y", "hirehuman-mcp"],
      "env": {
        "HIREHUMAN_API_KEY": "hh_demo_public_v1"
      }
    }
  }
}

Claude Code (CLI)

claude mcp add hirehuman -- npx -y hirehuman-mcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "hirehuman": {
      "command": "npx",
      "args": ["-y", "hirehuman-mcp"],
      "env": {
        "HIREHUMAN_API_KEY": "hh_demo_public_v1"
      }
    }
  }
}

Demo Key

The demo key hh_demo_public_v1 is included by default — no signup required. It provides:

10 API calls per day
Read-only access (search, catalog, pricing)
Mock booking responses

Get a production key at hirehumans.eu/agents.

Tools

Core

Tool	Description
`search_humans`	Find available verified humans near a location
`get_catalog`	Browse all available task types with prices
`get_price_estimate`	Get price range before booking
`book_task`	Book a human for a physical task
`get_booking_status`	Track booking status and retrieve photo proof

Pairing

Tool	Description
`get_pairing_code`	Pair agent with a human operator using a one-time code
`check_pairing_status`	Check if agent is still paired and active

Bounties

Tool	Description
`create_bounty`	Post an open task request for competitive pricing
`get_bounty_status`	Check bounty status and application count
`get_bounty_applications`	Review pending applications for a bounty
`accept_application`	Accept a human's bounty application
`cancel_bounty`	Cancel an open bounty

Messaging

Tool	Description
`send_message`	Send a message to the assigned human
`get_conversation`	Read conversation messages for a booking

Configuration

Environment Variable	Default	Description
`HIREHUMAN_API_KEY`	`hh_demo_public_v1`	Your API key
`HIREHUMAN_API_URL`	`https://hirehumans.eu`	API base URL
`HIREHUMAN_MOCK_MODE`	`false`	Local testing without API calls
`HIREHUMAN_TIMEOUT_MS`	`30000`	Request timeout in milliseconds
`HIREHUMAN_DEBUG`	`false`	Enable debug logging to stderr

Mock Mode

For local development and testing without making real API calls:

{
  "mcpServers": {
    "hirehuman": {
      "command": "npx",
      "args": ["-y", "hirehuman-mcp"],
      "env": {
        "HIREHUMAN_MOCK_MODE": "true"
      }
    }
  }
}

All tools return realistic sample data in mock mode.

Task Categories

Logistics, Bureaucracy, Mystery Shopping, Health, Animals, Transport, Home & Garden, Events, Education, IT & Tech, Personal Services, Other — 80+ task types total.

Requirements

Node.js 18+
An MCP-compatible client (Claude Desktop, Cursor, Claude Code, etc.)

License

MIT - see LICENSE

@hirehuman/mcp