io.github.CCSTT-dev/callable

Official3 tools

API for AI agents to delegate tasks to real humans.

Captured live from the server via tools/list.

submit_task

Submit an account verification task to a real human operator. Use this when your agent is blocked on something only a real person can complete — a KYC check, a platform sign-in or 2FA prompt, a CAPTCHA, an identity confirmation, or any verification step that requires a human. The task is charged automatically via Stripe ($39). A vetted operator claims it, performs the verification on real hardware, and returns the result (with optional screenshot) to your callback_url or via get_task_status. Typical completion: 30 minutes.

Parameters (5)

task_typestringrequired
account_verification — a real human verifies an account, KYC check, sign-in, or CAPTCHA on real hardware and returns structured proof ($39).
instructionsobjectrequired
Structured input for account_verification. Required fields: platform (e.g. 'gmail', 'stripe'), url (where to perform the verification), credentials (login info or how to obtain the code), what_to_verify (what the operator must confirm). Optional: screenshot_required (boolean, default true), additional_notes.
deadline_minutesintegerrequired
Time in minutes the operator has to complete the verification after claiming it. Minimum 20. Recommended: 30.
callback_urlstring
Webhook URL to receive a POST request with the task result when completed. Recommended for async agent workflows. If omitted, poll get_task_status instead.
payment_credentialobject
Stripe Link Agent Wallet Single-use Payment Token (SPT) for fully autonomous agent payments with no human intervention required. Omit if the developer account has a saved card on file.

get_task_status

Poll the status and retrieve the result of a previously submitted task. Returns the current status (pending, in_progress, pending_review, completed, disputed), the result payload, and any output URLs (video, screenshot). Use this in a polling loop after submit_task if no callback_url was provided.

Parameters (1)

task_idstringrequired
The task ID returned when the task was submitted

review_task

Optional. Approve or dispute a task that is in `pending_review` status. Use this after get_task_status reports the operator has completed the work. Approving releases the operator payout. Disputing requires a reason and a description of what is needed for acceptance; the operator is then allowed to resubmit. If you never call review_task, tasks are auto-approved after the review window expires.

Parameters (4)

task_idstringrequired
The task ID returned by submit_task.
decisionstringrequired
approve to accept the result and release payment; dispute to reject it and request a resubmission.
dispute_reasonstring
Required when decision = 'dispute'. What went wrong with the submission.
what_is_neededstring
Required when decision = 'dispute'. What the operator must do for the submission to be accepted.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "callable": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://getcallable.dev/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.