@ai2hum/mcp-server

MCP Server for ai2hum — the human layer for AI agents.

Lets AI agents (Claude, GPT, etc.) delegate real-world tasks to human workers via the Model Context Protocol.

Prerequisites

• Node.js 18 or later (https://nodejs.org/)
• An ai2hum API key (sign up at ai2hum.ai/developers)

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ai2hum": {
      "command": "npx",
      "args": ["@ai2hum/mcp-server"],
      "env": {
        "AI2HUM_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Where is this file?

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

After saving, restart Claude Desktop. You should see ai2hum tools in the tool list.

Claude Code

Add to your .claude/settings.json or project settings:

{
  "mcpServers": {
    "ai2hum": {
      "command": "npx",
      "args": ["@ai2hum/mcp-server"],
      "env": {
        "AI2HUM_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Environment Variable

export AI2HUM_API_KEY=sk_live_your_key_here
npx @ai2hum/mcp-server

Tools

| Tool | Description | |------|-------------| | ai2hum_create_task | Create a task for a human worker | | ai2hum_get_task | Check task status and get the human's result | | ai2hum_list_tasks | List all your tasks with filters (status, type) | | ai2hum_list_workers | Browse available workers or re-hire past workers | | ai2hum_cancel_task | Cancel an open task |

Task Types

17 task types are supported:

| Type | Description | |------|-------------| | phone_call | Call someone (government office, customer service, negotiate) | | verification | Verify real-world information (address, identity, document) | | physical_visit | Visit a physical location (inspect, survey, verify) | | research | Research from real-world sources (interviews, surveys) | | expert_review | Expert human review (legal, financial, compliance) | | portal_navigation | Navigate complex web portals (IRCTC, GST, MCA, passport) | | pickup | Pick up documents, packages, or items from a location | | meeting | Attend a meeting or hearing on behalf of someone | | document_signing | Get documents signed or notarized in person | | recon | On-ground reconnaissance (does this shop exist? is it open?) | | event_attendance | Attend an event, take notes, represent someone | | hardware_setup | Set up physical hardware, equipment, or devices | | real_estate | Real estate related tasks (site visits, broker meetings) | | product_testing | Test a physical product and report findings | | errand | General errands (deliver something, stand in line, buy something) | | photography | Take photos of a location, product, or event | | purchase | Purchase items from a store or market |

Worker Preferences

When creating a task, you can optionally specify worker preferences to control matching:

| Parameter | Description | |-----------|-------------| | preferred_worker_id | Re-hire a specific worker (e.g. "WRK-001") | | min_trust_score | Minimum trust score 0-100 (e.g. 80) | | preferred_location | Match workers near this location | | required_languages | Languages the worker must speak (e.g. ["Hindi", "English"]) | | required_tech | Equipment needed (e.g. ["two_wheeler", "camera"]) | | min_completed_tasks | Minimum completed task count | | max_reward | Budget cap in INR | | exclude_workers | Worker IDs to exclude |

Examples

Create a phone call task:

Ask Claude: "Use ai2hum to call BBMP about property tax for property ID KA-BLR-2024-88431. Offer 300 rupees reward."

Verify a PG accommodation:

Ask Claude: "Use ai2hum to send someone to verify the PG at 4th Cross, Koramangala. Check room size, WiFi speed, and food quality. 500 rupee reward, high urgency."

Re-hire a specific worker:

Ask Claude: "Use ai2hum to create a pickup task. Collect the signed contract from the lawyer's office in Indiranagar. Re-hire worker WRK-001 if available. 400 rupees."

Browse past workers:

Ask Claude: "Use ai2hum to show me workers I've used before."

Check task result:

Ask Claude: "Use ai2hum to check the status of task BNT-017."

Troubleshooting

| Problem | Fix | |---------|-----| | "AI2HUM_API_KEY not set" | Make sure the env block in your config has AI2HUM_API_KEY | | Tools not showing up in Claude | Restart Claude Desktop after editing the config file | | "Task type not valid" | Use one of the 17 types listed above (e.g. phone_call, not call) | | "Missing required field" | Every task needs: type, title, description, and reward | | Permission denied | Check that your API key starts with sk_live_ or sk_test_ |

Get API Key

Sign up at ai2hum.ai/developers to get your API key.