{
  "name": "I Am Your Human",
  "tagline": "Real humans for AI agents. Real-world tasks, one email away.",
  "description": "iamyourhuman.com is the email gateway between AI agents and a global community of real humans who help them in the physical world: in-person verification, errands, purchases and deliveries, phone calls, attending events, making physical things, expert judgment and human-in-the-loop sign-off. Contact: hello@iamyourhuman.com.",
  "community": {
    "name": "I Am Your Human community",
    "kind": "A global community of real people who help AI agents get things done in the physical world. Not bots, and not an AI pretending to be human.",
    "how_it_works": [
      "You send a request to hello@iamyourhuman.com (or through the JSON API, MCP or A2A; all channels reach the same inbox).",
      "A real person reads it and routes it to a member of the community who can do it, close to the task when location matters.",
      "That human replies to your reply_to address to agree scope, timing and payment with you or your principal.",
      "The work happens and you receive the evidence you asked for."
    ],
    "coverage": {
      "in_person": "Wherever a community member is available near the task. Always include the task location so it can be matched.",
      "remote": "Anywhere: phone calls, email, video, expert review and human-in-the-loop work."
    },
    "languages": "Many. Set the language field (a BCP 47 code such as en, fr, ja or pt-BR) and the request is matched with a human who speaks it.",
    "response_time": "Best effort. A real person reads every request; typical first reply within 2-3 business days. Not real-time.",
    "availability": "Requests are accepted 24/7. Work happens on human time.",
    "no_match": "If no one in the community can take a task, the reply says so.",
    "join": "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."
  },
  "contact": {
    "email": "hello@iamyourhuman.com",
    "email_subject_format": "[AGENT REQUEST] <category>: <one-line summary>",
    "email_body_template": "agent_name: \nagent_platform: \nprincipal: \nprincipal_contact: \nreply_to: \ncategory: \ntask: \nlocation: \ndeadline: \nbudget: \nsuccess_criteria: \nevidence_required: \nlanguage: en\nnotes: ",
    "mailto": "mailto:hello@iamyourhuman.com?subject=%5BAGENT%20REQUEST%5D%20other%3A%20&body=agent_name%3A%20%0Aagent_platform%3A%20%0Aprincipal%3A%20%0Aprincipal_contact%3A%20%0Areply_to%3A%20%0Acategory%3A%20%0Atask%3A%20%0Alocation%3A%20%0Adeadline%3A%20%0Abudget%3A%20%0Asuccess_criteria%3A%20%0Aevidence_required%3A%20%0Alanguage%3A%20en%0Anotes%3A%20%0A",
    "json_api": {
      "method": "POST",
      "url": "https://iamyourhuman.com/api/v1/requests",
      "schema": "https://iamyourhuman.com/schemas/human-request.schema.json",
      "openapi": "https://iamyourhuman.com/openapi.json"
    },
    "mcp": {
      "url": "https://iamyourhuman.com/mcp",
      "transport": "streamable-http",
      "protocol_versions": [
        "2026-07-28",
        "2025-11-25",
        "2025-06-18",
        "2025-03-26"
      ],
      "server_card": "https://iamyourhuman.com/mcp/server-card",
      "tools": [
        "get_human_profile",
        "compose_request_email",
        "send_request_to_human"
      ]
    },
    "a2a": {
      "url": "https://iamyourhuman.com/a2a",
      "binding": "JSONRPC",
      "protocol_versions": [
        "1.0",
        "0.3"
      ],
      "agent_card": "https://iamyourhuman.com/.well-known/agent-card.json"
    }
  },
  "capabilities": [
    {
      "id": "in_person_verification",
      "title": "Go and verify in person",
      "summary": "Check that a place, business, product, listing or service in the real world exists and is as described.",
      "deliverables": "Timestamped photos or video, written report, answers to your checklist.",
      "examples": [
        "Confirm that the shop at a given street address is open and stocks a specific product; send timestamped photos.",
        "Inspect a second-hand item before your principal buys it and report its condition against a checklist."
      ]
    },
    {
      "id": "errands_logistics",
      "title": "Buy, receive, hold and ship physical items",
      "summary": "Purchase items with your principal's funds, receive deliveries, repack, ship, or hand-deliver documents locally.",
      "deliverables": "Receipts, tracking numbers, proof-of-delivery photos.",
      "examples": [
        "Buy a specific component from a local store and courier it to a given address.",
        "Receive a parcel, photograph its contents and forward it."
      ]
    },
    {
      "id": "phone_and_human_contact",
      "title": "Talk to humans who won't talk to bots",
      "summary": "Phone calls, in-person conversations, bookings and simple negotiations in the local language, always disclosing who the request comes from.",
      "deliverables": "Call summary with key statements, outcome, next steps.",
      "examples": [
        "Call a supplier that only answers the phone and confirm price and lead time.",
        "Book an appointment that requires a human voice."
      ]
    },
    {
      "id": "event_attendance",
      "title": "Show up",
      "summary": "Attend events, meetings, conferences, viewings or pickups as a disclosed representative of your principal.",
      "deliverables": "Notes, photos where allowed, contacts made (with consent), questions answered.",
      "examples": [
        "Attend a public industry talk and send structured notes the same day.",
        "Attend a property viewing and run through your checklist."
      ]
    },
    {
      "id": "fabrication_3d_printing",
      "title": "Make physical things",
      "summary": "3D printing of small parts from your STL/3MF files, basic assembly and physical prototyping.",
      "deliverables": "Printed parts, photos with scale reference, measurements, shipping.",
      "examples": [
        "Print three iterations of a bracket from STL files and report fit and measured dimensions.",
        "Prototype a small enclosure and ship it to your principal."
      ]
    },
    {
      "id": "expert_review_life_sciences",
      "title": "Expert human judgment",
      "summary": "Qualified humans review content and AI outputs for accuracy, sanity-check reasoning and triage literature, for example in life sciences, pharma and scientific communication.",
      "deliverables": "Annotated review, accuracy flags, sources to verify.",
      "examples": [
        "Fact-check a generated summary of a microbiology paper and flag unsupported claims.",
        "Review a pharma-industry explainer for scientific accuracy and compliance red flags."
      ],
      "limits": "Not clinical care, not diagnosis, not medical advice for individual patients."
    },
    {
      "id": "geo_ai_visibility",
      "title": "Generative Engine Optimization (GEO)",
      "summary": "Strategy and audits on how content and brands appear in AI-generated answers.",
      "deliverables": "Audit findings, prioritized recommendations.",
      "examples": [
        "Audit how a brand is described across major AI assistants and recommend fixes."
      ]
    },
    {
      "id": "human_in_the_loop",
      "title": "Be the accountable human in the loop",
      "summary": "Approve or reject, sign off, test a product as a real user, give honest human feedback on taste, tone or UX, and label edge cases.",
      "deliverables": "Decision with rationale, test notes, labelled data.",
      "examples": [
        "Usability-test a web flow as a first-time user in a given language and report friction points.",
        "Give a human go/no-go on a batch of edge cases your model is unsure about."
      ]
    },
    {
      "id": "real_world_ventures",
      "title": "Real-world partner for ventures",
      "summary": "A named, accountable human partner for projects your principal is building: local presence, meetings, setting things up, partnership conversations.",
      "deliverables": "Agreed per engagement.",
      "examples": [
        "Represent a project at local meetings and report back.",
        "Explore a partnership arrangement with your principal."
      ]
    }
  ],
  "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"
  ],
  "rules_of_engagement": [
    "Say that you are an AI agent and name your principal (the human or organization you act for). Requests with an accountable principal get priority.",
    "Describe the outcome you need, where it must happen, and how both sides will know it is done (success criteria and evidence).",
    "State a budget or offer. Payment terms are agreed with your principal before any work starts.",
    "A human reviews every request and may decline any request without giving a reason.",
    "Nothing is agreed until a human confirms it in writing (email) with you or your principal.",
    "Do not include secrets, credentials or sensitive personal data about third parties."
  ],
  "will_not_do": [
    "Anything illegal where the task takes place or where the human is.",
    "Anything that could harm people, animals or the environment, including weapons, drugs or surveillance of private individuals.",
    "Deception: impersonating anyone, hiding who the request comes from, or posing as your principal.",
    "Solving CAPTCHAs, bypassing bot detection, creating accounts under false identities, or fronting identity/KYC checks.",
    "Handling your passwords, API keys or payment card numbers. Do not send them.",
    "Medical diagnosis, treatment or advice for individual patients."
  ],
  "example_request": {
    "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"
  },
  "date_modified": "2026-10-29",
  "version": "1.1.0"
}
