{"_id":"@ai2hum/mcp-server","name":"@ai2hum/mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@ai2hum/mcp-server","version":"0.1.0","description":"MCP Server for ai2hum — the human layer for AI agents","type":"module","main":"dist/index.js","bin":{"ai2hum-mcp":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js","dev":"tsx src/index.ts"},"keywords":["mcp","ai2hum","human-in-the-loop","ai-agents"],"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"typescript":"^5.3.0","tsx":"^4.7.0","@types/node":"^20.0.0"},"_id":"@ai2hum/mcp-server@0.1.0","gitHead":"3f764c1605c0b8efe894a107824012d086880b70","types":"./dist/index.d.ts","_nodeVersion":"18.20.8","_npmVersion":"10.8.2","dist":{"integrity":"sha512-GsSdS8lR2UUx0DyzseN/Mjv7xqpOfpn8ZlHNCdSS4jt7ABgI//SgQ90C41xsW8cf7VO8kQxI8mgaM4uXQK1GTQ==","shasum":"68e9146b5db7204eac6f9151fa2d8a94ba820c9a","tarball":"https://registry.npmjs.org/@ai2hum/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":11,"unpackedSize":45247,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCilRChgEK69aejkz/wPzO1h5u6ji2/uCcimRsHM13U/QIgIFvgMTTQuKPKUgBMwHaN4vGIvi3qfly9JAw5bBMg4Q4="}]},"_npmUser":{"name":"ai2hum","email":"manu@agent4u.co"},"directories":{},"maintainers":[{"name":"ai2hum","email":"manu@agent4u.co"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.0_1771138197408_0.8814052061643081"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-15T06:49:57.332Z","0.1.0":"2026-02-15T06:49:57.570Z","modified":"2026-02-15T06:49:57.766Z"},"maintainers":[{"name":"ai2hum","email":"manu@agent4u.co"}],"description":"MCP Server for ai2hum — the human layer for AI agents","keywords":["mcp","ai2hum","human-in-the-loop","ai-agents"],"license":"MIT","readme":"# @ai2hum/mcp-server\n\nMCP Server for [ai2hum](https://ai2hum.ai) — the human layer for AI agents.\n\nLets AI agents (Claude, GPT, etc.) delegate real-world tasks to human workers via the Model Context Protocol.\n\n## Prerequisites\n\n- Node.js 18 or later (https://nodejs.org/)\n- An ai2hum API key (sign up at [ai2hum.ai/developers](https://ai2hum.ai/developers))\n\n## Setup\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"ai2hum\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ai2hum/mcp-server\"],\n      \"env\": {\n        \"AI2HUM_API_KEY\": \"sk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Where is this file?**\n- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- Windows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\nAfter saving, restart Claude Desktop. You should see ai2hum tools in the tool list.\n\n### Claude Code\n\nAdd to your `.claude/settings.json` or project settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"ai2hum\": {\n      \"command\": \"npx\",\n      \"args\": [\"@ai2hum/mcp-server\"],\n      \"env\": {\n        \"AI2HUM_API_KEY\": \"sk_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Environment Variable\n\n```bash\nexport AI2HUM_API_KEY=sk_live_your_key_here\nnpx @ai2hum/mcp-server\n```\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `ai2hum_create_task` | Create a task for a human worker |\n| `ai2hum_get_task` | Check task status and get the human's result |\n| `ai2hum_list_tasks` | List all your tasks with filters (status, type) |\n| `ai2hum_list_workers` | Browse available workers or re-hire past workers |\n| `ai2hum_cancel_task` | Cancel an open task |\n\n## Task Types\n\n17 task types are supported:\n\n| Type | Description |\n|------|-------------|\n| `phone_call` | Call someone (government office, customer service, negotiate) |\n| `verification` | Verify real-world information (address, identity, document) |\n| `physical_visit` | Visit a physical location (inspect, survey, verify) |\n| `research` | Research from real-world sources (interviews, surveys) |\n| `expert_review` | Expert human review (legal, financial, compliance) |\n| `portal_navigation` | Navigate complex web portals (IRCTC, GST, MCA, passport) |\n| `pickup` | Pick up documents, packages, or items from a location |\n| `meeting` | Attend a meeting or hearing on behalf of someone |\n| `document_signing` | Get documents signed or notarized in person |\n| `recon` | On-ground reconnaissance (does this shop exist? is it open?) |\n| `event_attendance` | Attend an event, take notes, represent someone |\n| `hardware_setup` | Set up physical hardware, equipment, or devices |\n| `real_estate` | Real estate related tasks (site visits, broker meetings) |\n| `product_testing` | Test a physical product and report findings |\n| `errand` | General errands (deliver something, stand in line, buy something) |\n| `photography` | Take photos of a location, product, or event |\n| `purchase` | Purchase items from a store or market |\n\n## Worker Preferences\n\nWhen creating a task, you can optionally specify worker preferences to control matching:\n\n| Parameter | Description |\n|-----------|-------------|\n| `preferred_worker_id` | Re-hire a specific worker (e.g. `\"WRK-001\"`) |\n| `min_trust_score` | Minimum trust score 0-100 (e.g. `80`) |\n| `preferred_location` | Match workers near this location |\n| `required_languages` | Languages the worker must speak (e.g. `[\"Hindi\", \"English\"]`) |\n| `required_tech` | Equipment needed (e.g. `[\"two_wheeler\", \"camera\"]`) |\n| `min_completed_tasks` | Minimum completed task count |\n| `max_reward` | Budget cap in INR |\n| `exclude_workers` | Worker IDs to exclude |\n\n## Examples\n\n**Create a phone call task:**\n> Ask Claude: *\"Use ai2hum to call BBMP about property tax for property ID KA-BLR-2024-88431. Offer 300 rupees reward.\"*\n\n**Verify a PG accommodation:**\n> 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.\"*\n\n**Re-hire a specific worker:**\n> 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.\"*\n\n**Browse past workers:**\n> Ask Claude: *\"Use ai2hum to show me workers I've used before.\"*\n\n**Check task result:**\n> Ask Claude: *\"Use ai2hum to check the status of task BNT-017.\"*\n\n## Troubleshooting\n\n| Problem | Fix |\n|---------|-----|\n| \"AI2HUM_API_KEY not set\" | Make sure the `env` block in your config has `AI2HUM_API_KEY` |\n| Tools not showing up in Claude | Restart Claude Desktop after editing the config file |\n| \"Task type not valid\" | Use one of the 17 types listed above (e.g. `phone_call`, not `call`) |\n| \"Missing required field\" | Every task needs: `type`, `title`, `description`, and `reward` |\n| Permission denied | Check that your API key starts with `sk_live_` or `sk_test_` |\n\n## Get API Key\n\nSign up at [ai2hum.ai/developers](https://ai2hum.ai/developers) to get your API key.\n","readmeFilename":"README.md","_rev":"1-03b1035fff921f0b83a262e6c9cce955"}