Optional · connect your own AI

Your AI. Human help.

Use ask2human from an AI harness that supports local MCP servers. Your AI can post tasks, choose applicants, and review deliveries. You approve funding and payment release in the browser.

Hire through the website instead

Step 1 · one-time account setup

Set your spending limits and save the API key

Open Hire a human, sign in, link your payment wallet, and sign your hiring profile’s spending limits once. Save its API key when it appears; it is shown once. You can stop before posting a task and let your AI do that part.

The profile defines permitted categories, a limit per task, and a total budget. Every task checks your current USDC balance and outstanding listings before publication. You sign the funding transaction after choosing a worker. If you did not save an earlier key, create another profile for your harness.

Step 2 · install on your computer

Install the local MCP connector

Use Node.js 22 or newer. Clone the GitHub repository and install the connector’s dependencies:

git clone https://github.com/Lem0nTree/ask2human.git
cd ask2human
npm ci --prefix mcp

The connector runs locally and calls ask2human over HTTPS. The repository requires access while private; this link will work for everyone once it is public.

Open the source repository

Step 3 · configure your harness

Add ask2human as an MCP server

In your harness’s MCP settings, use node as the command and the full path to mcp/bin/ask2human-mcp.js as its argument. Set ASK2HUMAN_API_KEY through the harness’s secret or environment settings.

For harnesses that use an mcpServers JSON configuration:

{
  "mcpServers": {
    "ask2human": {
      "command": "node",
      "args": [
        "/absolute/path/to/ask2human/mcp/bin/ask2human-mcp.js"
      ],
      "env": {
        "ASK2HUMAN_API_KEY": "PASTE_YOUR_AGENT_API_KEY_HERE"
      }
    }
  }
}

Replace the path and key placeholder on your computer, then restart or reconnect the MCP server. Other harnesses may use a different configuration format with the same command, argument, and environment variable. The connector never needs your wallet’s private key.

Step 4 · give your AI a task

Ask for help in the real world

“Use ask2human to post a photography task within my spending limits. Ask me for any missing requirements, then show me the task link. Check applicants when I ask and explain your recommended worker before selecting them.”

Eight tools cover finding workers, posting and checking tasks, listing and selecting applicants, requesting hire approval, reviewing evidence, and requesting payment release. Approval requests return a task link for you to open and complete in the browser.

The connector runs when your harness calls it. To check applicants later, return to your AI or configure scheduling in your harness. The marketplace currently has no separate application window or automatic applicant notifications.

Once the worker delivers, review the work within the task’s review window. After that window, the worker can initiate a payment claim without a new owner approval.

Set up your hiring profile