This MCP server enables AI assistants to obtain human input by creating tasks (HITs) on Amazon Mechanical Turk. It exposes tools that let an AI ask a human worker a question and later check on the status of submitted responses. Specifically, you can use the askHuman tool to pose a question, specify a reward, and set HIT metadata such as title and validity. If a worker submits an answer within the HIT window, the response is returned to the AI; otherwise you can retrieve the HIT ID and check status later with checkHITStatus. The server relies on the external form hosted for MTurk interactions and uses the MCP protocol to exchange questions and answers between the AI agent and human workers.

Prerequisites: Node.js 16+ installed, AWS credentials with MTurk permissions, and optionally the AWS CLI for configuring credentials.

1. Install Node.js 16+ from the official site or via your system package manager.

2. Ensure AWS credentials are available (AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY) and configure a profile if desired (e.g., mcp-human) using the AWS CLI:

   aws configure --profile mcp-human

3. Install and run the MCP server via npx (no global installation required):

   Start in sandbox mode by default

   npx -y mcp-human@latest

   If you want to run against production MTurk, set MTURK_SANDBOX=false in your environment before starting the server

4. Optional: provide environment variables to customize behavior (examples):

   export MTURK_SANDBOX=true export AWS_REGION=us-east-1 export AWS_PROFILE=mcp-human export DEFAULT_REWARD=0.05 export FORM_URL=https://syskall.com/mcp-human/

5. Integrate with your MCP client configuration by adding the server under mcpServers, for example:

   { "mcpServers": { "human": { "command": "npx", "args": ["-y", "mcp-human@latest"] } } }

Tips and caveats: Start with MTurk Sandbox (MTURK_SANDBOX=true) to test end-to-end flows without spending real money. The server uses MTurk's ExternalQuestion format, which requires hosting a form externally (the hosted form URL is configured via FORM_URL). The Default Reward value sets the base HIT payment; adjust as needed, especially when moving from sandbox to production. Ensure your AWS profile (AWS_PROFILE) has AmazonMechanicalTurkFullAccess or appropriate permissions. If you encounter HIT rendering or form-hosting issues, verify that FORM_URL is accessible via HTTPS and that the MTurk form works with the expected query parameters. The tooling supports two main actions: askHuman to create a HIT and checkHITStatus to poll for results. Remember that some constraints are present, such as limiting to simple text-based exchanges and basic polling instead of webhooks.