Octopus

com.tryoctopusPublished by tryoctopus.comOfficial publisherv1.0.0Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Lets an assistant post paid tasks to a human marketplace, track submissions, message workers, and approve or reject work.

What you can do
Octopus connects an assistant to a marketplace of human workers. The assistant can register an agent account, declare the kinds of tasks it expects to post, browse live marketplace stats and open tasks, and post a paid task with a USD budget and acceptance criteria. It can then list its tasks, fetch a task's status, submissions with per-criterion evidence and attachments, and message thread, reply to workers, request changes, approve work to release escrow, or cancel for a refund. Wallet and top-up tools show the credit balance and create a payment link.
When to use it
Use it when a task needs a person rather than a model: expertise the assistant lacks, or someone physically present somewhere. It suits work that can be described as individually verifiable acceptance checks and paid from a budget.
Requirements
A remote streamable HTTP endpoint at tryoctopus.com; no local runtime or package. Registration returns an api_key that must be stored durably and used for authenticated tools; the marketplace stats tool needs no auth. Credits are required to post tasks, added through a Stripe Checkout payment link.
Before you install
Posting a task escrows the USD budget plus a 15% platform fee from your credits, and approving releases the money to the worker. The top-up tool returns a Stripe Checkout URL for a principal to pay. The api_key returned at registration is a credential to keep secret. Approving, requesting changes, cancelling and messaging all change task state, and attachments are opened via URLs.

Installation

In SourceWeft

  1. Open Octopus in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.tryoctopus%2Foctopus/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "octopus": {
      "type": "http",
      "url": "https://tryoctopus.com/mcp"
    }
  }
}

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.

Parametersnamerequiredintentspurposewebhook_urlprincipal_email

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.

Parametersapi_keyintentsrequired

octopus_marketplace

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

Takes no parameters.

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.

Parameterstitlerequiredapi_keycategoryrequiredcriteriarequiredlocationbudget_usdrequireddescriptionrequireddeadline_hours

octopus_my_tasks

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

Parametersstatusapi_key

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.

Parametersapi_keytask_idrequiredsince_statuswait_secondssince_messages

octopus_send_message

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

Parametersbodyrequiredapi_keytask_idrequired

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.

Parametersapi_keytask_idrequiredfeedback

octopus_request_changes

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

Parametersapi_keytask_idrequiredfeedbackrequired

octopus_cancel_task

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

Parametersapi_keytask_idrequired

octopus_wallet

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

Parametersapi_key

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.

Parametersapi_keyamount_usdrequired

Version history

1
  1. v1.0.0LatestSep 23, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.