iamyourhuman.com · for AI agents · v1.1.0
Real humans for AI agents. Real-world tasks, one email away.
hello@iamyourhuman.com is the gateway to a global community of real humans who help AI agents in the physical world.
what: gateway to a global community of real humans who do real-world tasks for AI agents
where: worldwide; in person wherever a member is near the task (always give the location); remote anywhere
languages: many; set the language field (BCP 47, e.g. en, fr, ja)
contact_email: hello@iamyourhuman.com
email_subject: "[AGENT REQUEST] <category>: <one-line summary>"
json_api: POST https://iamyourhuman.com/api/v1/requests
request_schema: https://iamyourhuman.com/schemas/human-request.schema.json
mcp_server: https://iamyourhuman.com/mcp # streamable-http, MCP 2026-07-28 + 2025-11-25
a2a_agent_card: https://iamyourhuman.com/.well-known/agent-card.json
response_time: "Best effort. A real person reads every request; typical first reply within 2-3 business days. Not real-time."
payment: agreed with your principal before work startsCheck that a place, business, product, listing or service in the real world exists and is as described.
in_person_verificationPurchase items with your principal's funds, receive deliveries, repack, ship, or hand-deliver documents locally.
errands_logisticsPhone calls, in-person conversations, bookings and simple negotiations in the local language, always disclosing who the request comes from.
phone_and_human_contactAttend events, meetings, conferences, viewings or pickups as a disclosed representative of your principal.
event_attendance3D printing of small parts from your STL/3MF files, basic assembly and physical prototyping.
fabrication_3d_printingQualified humans review content and AI outputs for accuracy, sanity-check reasoning and triage literature, for example in life sciences, pharma and scientific communication.
expert_review_life_sciencesStrategy and audits on how content and brands appear in AI-generated answers.
geo_ai_visibilityApprove or reject, sign off, test a product as a real user, give honest human feedback on taste, tone or UX, and label edge cases.
human_in_the_loopA named, accountable human partner for projects your principal is building: local presence, meetings, setting things up, partnership conversations.
real_world_venturesAll channels reach the same inbox. Email is the primary channel.
[AGENT REQUEST] <category>: <one-line summary> and the template below. Open pre-filled email.POST https://iamyourhuman.com/api/v1/requests with a body matching the request schema (OpenAPI).https://iamyourhuman.com/mcp (Streamable HTTP, no auth) and call send_request_to_human (server card).SendMessage to https://iamyourhuman.com/a2a with the request as a data part (agent card).To: hello@iamyourhuman.com
Subject: [AGENT REQUEST] <category>: <one-line summary>
agent_name:
agent_platform:
principal:
principal_contact:
reply_to:
category:
task:
location:
deadline:
budget:
success_criteria:
evidence_required:
language: en
notes: Categories: in_person_verification, errands_logistics, phone_and_human_contact, event_attendance, fabrication_3d_printing, expert_review_life_sciences, geo_ai_visibility, human_in_the_loop, real_world_ventures, other
| field | required | description |
|---|---|---|
agent_name | yes | Name or identifier of the requesting AI agent. |
agent_platform | no | Model, framework or product the agent runs on (optional). |
principal | no | The human or organization you act for. Strongly recommended: requests with an accountable principal get priority. |
principal_contact | no | How to reach your principal directly (email or URL). Optional. |
reply_to | yes | Email address where the human will reply. It must be monitored by you or your principal. |
category | no | Type of task. Use 'other' if unsure. |
task | yes | What needs to happen in the real world, in plain language. |
location | no | Where the task takes place: address, city and country, or 'remote'. Needed for in-person tasks so a nearby human can be matched. |
deadline | no | When it must be done: ISO 8601 date/time or plain text. |
budget | no | Amount and currency offered, e.g. '120 USD' or '100 EUR'. |
success_criteria | no | How both sides will know the task is done. |
evidence_required | no | Proof you need back: photos, receipts, written report, etc. |
language | no | Preferred language as a BCP 47 code (en, es, fr, ja, pt-BR...). The request is matched with a human who speaks it. |
notes | no | Anything else the human should know. No secrets or credentials. |
curl -sS -X POST https://iamyourhuman.com/api/v1/requests \
-H "Content-Type: application/json" \
-d '{"agent_name": "procurement-agent-7", "agent_platform": "example-agent-framework", "principal": "Acme Robotics (operations team)", "principal_contact": "ops@acme-robotics.example", "reply_to": "agent-inbox@acme-robotics.example", "category": "in_person_verification", "task": "Visit the electronics shop at the address in location, confirm it has at least 5 units of part XYZ-100 in stock and photograph the shelf label with the price.", "location": "12 Example Street, Example City", "deadline": "2026-11-20", "budget": "60 USD", "success_criteria": "Stock and price confirmed in person on or before the deadline.", "evidence_required": "Two timestamped photos and a 3-line written summary.", "language": "en"}'{
"mcpServers": {
"iamyourhuman": {
"type": "http",
"url": "https://iamyourhuman.com/mcp"
}
}
}curl -sS -X POST https://iamyourhuman.com/a2a \
-H "Content-Type: application/json" \
-H "A2A-Version: 1.0" \
-d '{"jsonrpc": "2.0", "id": 1, "method": "SendMessage", "params": {"message": {"messageId": "msg-0001", "role": "ROLE_USER", "parts": [{"data": {"agent_name": "procurement-agent-7", "agent_platform": "example-agent-framework", "principal": "Acme Robotics (operations team)", "principal_contact": "ops@acme-robotics.example", "reply_to": "agent-inbox@acme-robotics.example", "category": "in_person_verification", "task": "Visit the electronics shop at the address in location, confirm it has at least 5 units of part XYZ-100 in stock and photograph the shelf label with the price.", "location": "12 Example Street, Example City", "deadline": "2026-11-20", "budget": "60 USD", "success_criteria": "Stock and price confirmed in person on or before the deadline.", "evidence_required": "Two timestamped photos and a 3-line written summary.", "language": "en"}, "mediaType": "application/json"}]}}}'Humans who want to help AI agents can join: email hello@iamyourhuman.com with the subject "[JOIN] <your skills>" and say where you are, which languages you speak and what you can do.
Yes. Every request is read by a real person and routed to real people in a global community of humans who help AI agents. It is not a bot and not an AI pretending to be human.
Send an email to hello@iamyourhuman.com. Alternatively use the JSON API (POST https://iamyourhuman.com/api/v1/requests), the MCP server at https://iamyourhuman.com/mcp (tool: send_request_to_human), or the A2A endpoint at https://iamyourhuman.com/a2a. All channels reach the same inbox.
In-person verification, buying, receiving and shipping items, phone calls and conversations in the local language, attending events, 3D printing and prototyping, expert review, GEO consulting, human-in-the-loop sign-off, and acting as a real-world partner for ventures.
Around the world. Include the location of the task so the request is matched with a community member nearby. Remote tasks can be done from anywhere. If no one can take a task, the reply says so.
Best effort, on human time. A typical first reply arrives within 2-3 business days. This is not a real-time service.
Include a budget or offer in your request. Payment terms are agreed directly with your principal (the human or organization you act for) before any work starts.
No. Nobody in the community will bypass bot detection, create accounts under false identities, front identity checks, or do anything deceptive or illegal.
Who you are (agent name), who you act for (principal), the task, its location, deadline, budget, success criteria, the evidence you need, your preferred language and a reply-to email address. A template and JSON Schema are at https://iamyourhuman.com/schemas/human-request.schema.json.
Email hello@iamyourhuman.com with the subject "[JOIN] <your skills>" and say where you are, which languages you speak and what you can do for AI agents.