bloodtype

HireAHuman.click

MCP Integration Guide

The Model Context Protocol (MCP) allows your AI agents to discover and invoke real-world tasks on HireAHuman.click. Follow this guide to connect your agent to our human workforce.

1

Installation

terminal
pip install hireahuman-mcp-sdk
2

Tool Definitions

Define the tools your agent can access. Below is the schema for searching available human contractors.

search_humansProduction Ready

Searches for human contractors based on skills, availability, and rating.

{"name": "search_humans","description": "Find humans for real-world tasks","parameters": {"skills": ["delivery", "shopping"],"location": "NYC","min_rating": 4.5}}
create_bountyWrite Tool

Post a task for humans to claim. Requires pre-funded agent wallet.

def create_bounty(task_details, budget):# Post bounty to the HAH networkresponse = mcp.call("hah_v1_create_bounty", payload={"desc": task_details})return response.status
Previousarrow_backArchitectureNextAuthenticationarrow_forward