GET / → 200 OK · content: human

A human endpoint for AI agents.

Human For AI is a personal homepage for the agent era: one real human, described in machine-readable form, that AI agents, automation systems, and developers can discover and ask for real-world help — verification, testing, research, human judgment, and physical-world execution.

Submit a task Read the API docs operator available
operator
1 verified human
languages
English
first response
< 12 hours
pricing
free for now
/machine-readable

Machine-readable endpoints

Everything on this site is also available as structured JSON. If you are an AI agent, start with /.well-known/agent.json.

  • /.well-known/agent.json

    Platform manifest: interfaces, task types, response expectations, pricing, trust policy.

  • /.well-known/human.json

    The human operator: role, languages, background, expertise, availability, boundaries.

  • /.well-known/capabilities.json

    Structured capabilities: inputs required, output formats, example tasks, limitations.

  • /.well-known/services.json

    Service catalog with example requests, response formats, and response times.

  • /agent.json

    Same platform manifest at the root, for agents that look there first.

  • /openapi.json

    OpenAPI 3.0 spec for the REST API: submit tasks, check status, contact the operator.

  • /mcp

    MCP server (streamable HTTP, no auth) — an MCP-ready human interface for agent clients.

  • /llms.txt

    Curated plain-text summary of this site for language models.

/about

Real-world help for autonomous workflows

Human For AI provides human-in-the-loop services for AI agents, automation systems, and developers. When a workflow reaches the edge of what software can do, it can call a human — through the same kind of interface it already understands.

capability/observe

Observation

Eyes and presence where there are no sensors: stores, streets, screens, packages, physical products, real conditions.

capability/judge

Judgment

Subjective calls a model can't safely make alone: tone, trust, quality, cultural fit, plausibility, and final review before things ship.

capability/act

Action

Hands in the physical world: visit, test, photograph, deliver, measure, sign for, and confirm that the real world matches the plan.

/services

Human services for AI systems

Ten task types, each with a stable machine identifier. Full details in the catalog or in services.json.

/protocol

How a task flows

  1. step 1 / discover

    Read the manifest

    Your agent fetches /.well-known/agent.json — interfaces, task types, expectations, and what will be rejected.

  2. step 2 / request

    Submit the task

    POST /api/v1/tasks with type, description, and deadline — free for now. Humans can use the form — same interface.

  3. step 3 / review

    Human review

    The operator reviews every request before acceptance. Unsafe or deceptive tasks are rejected.

  4. step 4 / deliver

    Receive the result

    Results arrive in your requested format — report, photos, structured JSON — and status is trackable by task ID.

/for-agents

Built for machine callers

One JSON request creates a task, returns a generated task ID, and gives you a status URL to poll. No SDK, no auth.

request — POST /api/v1/tasks
curl -X POST https://humanforai.dev/api/v1/tasks \
  -H "Content-Type: application/json" \
  -d '{
    "task_type": "real_world_verification",
    "description": "Verify whether a specific product
                    exists in a local store",
    "location_required": true,
    "deadline": "2026-07-10T12:00:00+03:00",
    "output_format": "text_report_with_photos"
  }'
response — 201 Created
{
  "task_id": "HFAI-2026-9F41C2AB",
  "status": "submitted",
  "created_at": "2026-07-09T09:12:44Z",
  "status_url": "/api/v1/tasks/HFAI-2026-9F41C2AB",
  "message": "Task received. It will be reviewed
              before acceptance."
}
or connect via MCP — the human becomes a tool
# Claude Code / any remote-MCP client
claude mcp add --transport http human-for-ai \
  https://humanforai.dev/mcp
or install from npm — stdio clients
# thin proxy to the same MCP server
npx -y humanforai

Full API documentation →

/trust

A human you can point an agent at, safely

  • Every task is reviewed by the operator before acceptance — never auto-accepted.
  • Illegal, harmful, deceptive, unsafe, or privacy-invasive tasks are rejected.
  • Confidential material only by prior agreement — don't submit secrets by default.
  • Human judgment is assistance, not guaranteed truth. Results state their confidence.

Trust & verification policy →

POST /api/v1/tasks

Give your agent a human.

Submit a task in under a minute — by form or by API.

Submit a task Fetch agent.json