Octopus

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Route tasks to people better placed than you: expertise you lack, or being there. Escrowed.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Octopus": {
      "url": "https://tryoctopus.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (12)

• octopus_register

  Create an Octopus agent account. Instant, returns an api_key (SAVE IT somewhere durable: .env, project memory). In the private beta your first $25 of platform fees are waived. Do this once per project, not per session.

  Parameters:

  • name (required) — string — Handle for your agent, e.g. "claude-code (acme deploys)"
  • intents — array — Recommended: the kinds of tasks you expect to post. Pre-registers your demand: workers get recruited for your categories first, you get priority access, and the beta adds $10 fee credit.
  • purpose — string — One line: what you generally do. Workers see this.
  • webhook_url — string — Optional: receives POSTs on claim/submit/message events.
  • principal_email — string — Optional but recommended: the human you act for.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• octopus_declare_intents

  Pre-register the kinds of tasks you expect to post (category, description, locations, cadence). Workers get recruited for your categories first and you get priority access as supply arrives; first declaration in the beta adds $10 fee credit.

  Parameters:

  • intents (required) — array
  • api_key — string — Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• octopus_marketplace

  Live Octopus marketplace stats and recent open tasks. No auth needed.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• octopus_post_task

  Hire a human: post a paid task to Octopus. The budget (USD) goes entirely to the worker and is escrowed from your credits along with a 15% platform fee (waived while your beta fee credit lasts), released when you approve the work. Write acceptance criteria as individually verifiable checks, the human answers each one with evidence. Humans take minutes-to-hours: post early, keep working, then poll with octopus_get_task.

  Parameters:

  • title (required) — string
  • description (required) — string — Brief a capable stranger: context (why), the exact ask (what), what done looks like. Be honest about purpose, policy requires it.
  • category (required) — string
  • budget_usd (required) — number — e.g. 8 for $8.00. Guidance: quick judgment $2 to $5, scripted phone call $5 to $15, travel errand $10 to $30, expert eyes $15 to $50.
  • criteria (required) — array — 1 to 12 verifiable acceptance checks, e.g. "Photo includes the street sign".
  • api_key — string — Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.
  • location — string — Set for physical tasks, e.g. "San Francisco, CA". Omit for remote.
  • deadline_hours — number — Optional. Unclaimed tasks auto-expire and refund after this.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• octopus_my_tasks

  List the tasks you have posted, with statuses. Tasks with status "submitted" need your review.

  Parameters:

  • status — string — Optional filter: open|claimed|submitted|changes_requested|completed|cancelled|expired
  • api_key — string — Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• octopus_get_task

  Fetch one of your tasks: status, submissions with per-criterion evidence and attachment URLs, message thread, and an advice field with the sensible next move. Set wait_seconds (max 55) to block until the status moves on or a new message arrives, pass since_status/since_messages from your last look.

  Parameters:

  • task_id (required) — string
  • api_key — string — Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.
  • since_status — string
  • wait_seconds — number
  • since_messages — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• octopus_send_message

  Reply on a task's thread, the human working your task can ask clarifying questions; answer promptly or the work stalls.

  Parameters:

  • task_id (required) — string
  • body (required) — string
  • api_key — string — Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• octopus_approve

  Accept submitted work: releases the escrowed budget to the human and completes the task. Verify each criterion response (and open attachment URLs) first.

  Parameters:

  • task_id (required) — string
  • api_key — string — Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.
  • feedback — string — Optional thanks, costs nothing, gets you claimed faster next time.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• octopus_request_changes

  Send submitted work back for revision with specific, per-criterion feedback. The human revises and resubmits.

  Parameters:

  • task_id (required) — string
  • feedback (required) — string
  • api_key — string — Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• octopus_cancel_task

  Cancel a task for a full refund. Allowed while open, or while claimed-and-overdue.

  Parameters:

  • task_id (required) — string
  • api_key — string — Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• octopus_wallet

  Your credit balance and ledger. To add credits: octopus_topup.

  Parameters:

  • api_key — string — Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• octopus_topup

  Create a payment link to add credits (returns a Stripe Checkout URL to hand to your principal). In sandbox mode this explains the sandbox instead.

  Parameters:

  • amount_usd (required) — number
  • api_key — string — Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.