# HUMAN API

> HUMAN API is an MCP server for productivity. Ask a real person to do a physical-world task for your agent, and see their decision. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API
- **Repository:** https://github.com/human-api-labs/human-ai
- **MCP Registry name:** io.github.human-api-labs/human-ai
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-15

## About

The service rests on one rule: a human always decides. An agent submits a free-form task with optional location, deadline, budget and requirements, the service matches human capability profiles, and a person explicitly accepts or declines. The decision is returned to the requesting agent. People can refuse anything unsafe, illegal or unwanted.

Examples include reading the model number off a machine label in Germany, photographing an object, or confirming what is visible at a location. There is no fixed job catalogue; profiles describe what a person can plausibly help with.

The README calls it an early MVP and a market-discovery experiment, with no payment processing in the first version, so budgets are informational. Agents can find it through the MCP Registry, llms.txt, OpenAPI or ARD discovery, and the same functions are available over REST.

## Features

- **Human discovery:** Find voluntary human capability profiles.
- **Free-form requests:** Describe any physical-world task with location, deadline and budget.
- **Explicit acceptance:** A real person accepts or declines each request.
- **Status checks:** Retrieve the human decision for a task.
- **MCP and REST:** Same service over MCP and an OpenAPI interface.

## Good for

- Have someone photograph an item at a location
- Verify a label or serial number in person
- Get human judgement on what is visible somewhere
- Test whether agents can delegate offline tasks

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http human-ai https://human-api-labs.onrender.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://human-api-labs.onrender.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "human-ai": {
      "url": "https://human-api-labs.onrender.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "human-ai": {
      "type": "http",
      "url": "https://human-api-labs.onrender.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "human-ai": {
      "serverUrl": "https://human-api-labs.onrender.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://human-api-labs.onrender.com/mcp
```

Enter a Name (for example "HUMAN API"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "human-ai": {
      "type": "http",
      "url": "https://human-api-labs.onrender.com/mcp"
    }
  }
}
```

## Tools

- `discover_humans`: Find voluntary human capability profiles
- `request_human_help`: Ask a human to perform a physical-world task
- `get_task_status`: Retrieve the human decision and status

## FAQ

### Is a person always involved?

Yes. A real human must choose ACCEPT or DECLINE for every task.

### Does it handle payment?

No. The README says the first MVP has no payment processing.

### What is its status?

An early MVP and market-discovery experiment.

### How do agents find it?

Via the MCP Registry, llms.txt, ARD or OpenAPI.

### How do I add HUMAN API to Claude Code?

Run this command in your terminal: claude mcp add --transport http human-ai https://human-api-labs.onrender.com/mcp

### What are the best alternatives to HUMAN API?

The closest alternatives to HUMAN API are Handflow, Human as a Service (Geoff), askingahuman, Invoke Human Tool and flixconomy.ai: humans and Ari for agents.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Handflow](https://ai-powered.com/mcp/handflow): Handflow is a paid MCP server for local services.
- [Human as a Service (Geoff)](https://ai-powered.com/mcp/human-as-a-service-geoff): Human as a Service (Geoff) is a free MCP server for productivity.
- [askingahuman](https://ai-powered.com/mcp/askingahuman): askingahuman is a freemium MCP server for communication.
- [Invoke Human Tool](https://ai-powered.com/mcp/invoke-human-tool): Invoke Human Tool is a free MCP server for productivity.
- [flixconomy.ai: humans and Ari for agents](https://ai-powered.com/mcp/flixconomy-ai-humans-and-ari-for-agents): flixconomy.ai: humans and Ari for agents is a paid MCP server for productivity.
- [Taskriz](https://ai-powered.com/mcp/taskriz): Taskriz is a freemium MCP server for productivity.
- [Operis](https://ai-powered.com/mcp/operis): Operis is a paid MCP server for productivity.
- [A2H: ask a human](https://ai-powered.com/mcp/a2h-ask-a-human): A2H: ask a human is a free MCP server for communication.

---
Source: https://ai-powered.com/mcp/human-api
