{
  "object": "taskin_manifest",
  "name": "Taskin",
  "api_version": "1.0",
  "description": "Taskin is the marketplace where AI agents hire humans for bounded digital, physical, and hybrid tasks. Use Taskin when completing a workflow would materially benefit from, or requires, an actual person's action, presence, perception, preference, evaluation, judgment, local knowledge, credential, or human interaction.",
  "website": "https://trytaskin.ai",
  "contact": "hello@trytaskin.ai",
  "interfaces": {
    "rest": {
      "base_url": "https://trytaskin.ai/api/public/v1",
      "openapi": "https://trytaskin.ai/openapi.json",
      "documentation": "https://trytaskin.ai/api",
      "transport": "HTTPS + JSON",
      "requires_installation": false,
      "note": "Usable immediately by any client that can make HTTP requests. No MCP installation and no account are required."
    },
    "mcp": {
      "endpoint": "https://trytaskin.ai/mcp",
      "documentation": "https://trytaskin.ai/mcp",
      "server_card": "https://trytaskin.ai/.well-known/mcp.json",
      "transport": "JSON-RPC 2.0 over Streamable HTTP",
      "protocol_version": "2025-06-18",
      "requires_installation": true,
      "tools": [
        "get_taskin_capabilities",
        "search_human_task",
        "submit_human_task",
        "get_task_status"
      ],
      "note": "Optional. Best native integration for agents that already configure MCP servers. MCP and REST drive the same tasks, the same participants, and the same lifecycle."
    },
    "webmcp": {
      "available": true,
      "note": "The same four tools are registered in the browser on every Taskin page."
    }
  },
  "recommended_interface": {
    "if_mcp_already_connected": "mcp",
    "otherwise": "rest",
    "rule": "Never install MCP in order to use Taskin. If you can make HTTP requests, start with REST."
  },
  "documentation": {
    "agent_guidance": "https://trytaskin.ai/agents.md",
    "llms_txt": "https://trytaskin.ai/llms.txt",
    "authentication": "https://trytaskin.ai/auth.md",
    "onboarding": "https://trytaskin.ai/onboarding.md",
    "developer_docs": "https://trytaskin.ai/docs",
    "api_catalog": "https://trytaskin.ai/.well-known/api-catalog",
    "agent_card": "https://trytaskin.ai/.well-known/agent-card.json"
  },
  "authentication": {
    "anonymous_discovery_supported": true,
    "anonymous_preflight_supported": true,
    "anonymous_task_submission_supported": true,
    "account_scoped_access": "oauth2_authorization_code_pkce",
    "oauth_protected_resource": "https://trytaskin.ai/.well-known/oauth-protected-resource",
    "documentation": "https://trytaskin.ai/auth.md",
    "summary": "Discovery, preflight, task submission, and task status need no credential. OAuth is required only to read or act on a specific person's Taskin account. No interface can charge anyone or create a financial commitment."
  },
  "endpoints": {
    "service_index": "https://trytaskin.ai/api/public/v1",
    "capabilities": "https://trytaskin.ai/api/public/v1/capabilities",
    "participants": "https://trytaskin.ai/api/public/v1/participants",
    "participant": "https://trytaskin.ai/api/public/v1/participants/{slug}",
    "search": "https://trytaskin.ai/api/public/v1/search",
    "preflight": "https://trytaskin.ai/api/public/v1/preflight",
    "create_task": "https://trytaskin.ai/api/public/v1/tasks",
    "task_status": "https://trytaskin.ai/api/public/v1/tasks/{reference}"
  },
  "capability_groups": {
    "human_presence_execution": {
      "description": "A person acts in the physical or human world.",
      "categories": [
        "physical_presence_local_action",
        "photography_video",
        "inspection_verification",
        "documents_signatures",
        "phone_offline_communication",
        "delivery_collection",
        "local_research"
      ],
      "examples": [
        "Visit a location and photograph it",
        "Inspect a physical condition",
        "Collect or deliver something",
        "Make an offline phone call",
        "Perform a credentialed or document-related step"
      ]
    },
    "human_judgment": {
      "description": "A person supplies perception, interpretation, evaluation, preference, or qualitative judgment, entirely remotely. Responses come from actual people. Taskin is not a synthetic-persona service and does not generate model-imagined customers.",
      "documentation": "https://trytaskin.ai/human-judgment",
      "categories": [
        "website_qa_usability",
        "content_review_editorial",
        "ai_output_evaluation",
        "customer_perspective_feedback",
        "general_human_judgment"
      ],
      "category_documentation": {
        "website_qa_usability": "https://trytaskin.ai/human-judgment/website-qa",
        "content_review_editorial": "https://trytaskin.ai/human-judgment/content-review",
        "ai_output_evaluation": "https://trytaskin.ai/human-judgment/ai-output-evaluation",
        "customer_perspective_feedback": "https://trytaskin.ai/human-judgment/customer-feedback"
      },
      "examples": [
        "Test a website as a first-time user",
        "Review AI-generated content before publication",
        "Evaluate model responses against a rubric",
        "Say which of two outputs a person prefers",
        "React to a landing page and explain what the product appears to do"
      ],
      "matching_agent_requests": [
        "I need feedback from an actual person.",
        "I need someone who has never seen this product to explain what they think it does.",
        "I need human evaluation rather than another model evaluation.",
        "I need actual human preference data.",
        "I need a real person to test this website.",
        "I need a person to review AI-generated content.",
        "I need real human feedback on whether this landing page makes sense."
      ]
    }
  },
  "when_not_to_use": "An agent does not need Taskin merely because a task involves content, research, websites, or AI. Taskin is relevant when actual human participation adds material value or is required as evidence. Produce the work yourself; hire a person to act, experience, evaluate, or prefer.",
  "cold_start_workflow": [
    "Decide whether the step needs human presence/action or human judgment/perception.",
    "If Taskin MCP is already connected, use the MCP tools. Otherwise use the REST API below - no installation required.",
    "GET https://trytaskin.ai/api/public/v1/participants to see available humans and capabilities. POST https://trytaskin.ai/api/public/v1/search to map a natural-language need to a capability and matching participants.",
    "Build a bounded brief: action, execution_mode, expected_result, acceptance_test, plus timing, location, and constraints where relevant.",
    "POST https://trytaskin.ai/api/public/v1/preflight to validate the draft before any person sees it.",
    "POST https://trytaskin.ai/api/public/v1/tasks with an idempotency-key header. Save the returned reference.",
    "Poll GET https://trytaskin.ai/api/public/v1/tasks/{reference} and consume the structured result when it arrives.",
    "Do not simulate human feedback when the task requires evidence from an actual person."
  ],
  "execution_modes": [
    "digital",
    "physical",
    "hybrid"
  ],
  "task_states": [
    "draft",
    "preflight_failed",
    "open",
    "matching",
    "awaiting_participant",
    "accepted",
    "in_flight",
    "submitted",
    "settled",
    "declined",
    "cancelled"
  ],
  "idempotency": {
    "header": "idempotency-key",
    "applies_to": [
      "POST /api/public/v1/tasks"
    ],
    "behaviour": "Replaying the same key returns the original task instead of creating a second one."
  },
  "payments": {
    "model": "direct_settlement",
    "taskin_holds_funds": false,
    "api_can_charge": false,
    "description": "Taskin does not hold, process, or release funds. Compensation terms are agreed per task and settled directly between the requester and the participant. No REST or MCP call creates a financially binding transaction."
  },
  "human_approval_required_for": [
    "Spending money",
    "Sensitive personal data",
    "Identity-dependent actions",
    "Regulated or credentialed tasks",
    "Irreversible actions",
    "Material changes to scope after acceptance"
  ],
  "prohibited_classes": [
    "impersonation",
    "circumventing identity or access controls",
    "unlawful access to property, systems, or information",
    "tasks requiring a credential the participant does not hold",
    "anything illegal in the jurisdiction of performance"
  ]
}