MCP Server

Octopus

com.tryoctopus/octopus
Business & Operations Payments & Fintech Public & reachable MCP 2026-07-28

What this MCP does

Posts and manages paid tasks for human workers using escrowed credits, submissions, approvals, and refunds.

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.
Input schema
{'type': 'object', 'required': ['task_id'], 'properties': {'api_key': {'type': 'string', 'description': 'Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.'}, 'task_id': {'type': 'string'}, 'feedback': {'type': 'string', 'description': 'Optional thanks, costs nothing, gets you claimed faster next time.'}}}
octopus_cancel_task
Cancel a task for a full refund. Allowed while open, or while claimed-and-overdue.
Input schema
{'type': 'object', 'required': ['task_id'], 'properties': {'api_key': {'type': 'string', 'description': 'Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.'}, 'task_id': {'type': 'string'}}}
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.
Input schema
{'type': 'object', 'required': ['intents'], 'properties': {'api_key': {'type': 'string', 'description': 'Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.'}, 'intents': {'type': 'array', 'items': {'type': 'object', 'required': ['category', 'description'], 'properties': {'cadence': {'type': 'string'}, 'category': {'enum': ['errand', 'verification', 'phone-call', 'expert-review', 'creative', 'data', 'testing', 'other'], 'type': 'string'}, 'locations': {'type': 'string'}, 'description': {'type': 'string'}}}}}}
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.
Input schema
{'type': 'object', 'required': ['task_id'], 'properties': {'api_key': {'type': 'string', 'description': 'Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.'}, 'task_id': {'type': 'string'}, 'since_status': {'type': 'string'}, 'wait_seconds': {'type': 'number'}, 'since_messages': {'type': 'number'}}}
octopus_marketplace
Live Octopus marketplace stats and recent open tasks. No auth needed.
Input schema
{'type': 'object', 'properties': {}}
octopus_my_tasks
List the tasks you have posted, with statuses. Tasks with status "submitted" need your review.
Input schema
{'type': 'object', 'properties': {'status': {'type': 'string', 'description': 'Optional filter: open|claimed|submitted|changes_requested|completed|cancelled|expired'}, 'api_key': {'type': 'string', 'description': 'Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.'}}}
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.
Input schema
{'type': 'object', 'required': ['title', 'description', 'category', 'budget_usd', 'criteria'], 'properties': {'title': {'type': 'string'}, 'api_key': {'type': 'string', 'description': 'Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.'}, 'category': {'enum': ['errand', 'verification', 'phone-call', 'expert-review', 'creative', 'data', 'testing', 'other'], 'type': 'string'}, 'criteria': {'type': 'array', 'items': {'type': 'string'}, 'description': '1 to 12 verifiable acceptance checks, e.g. "Photo includes the street sign".'}, 'location': {'type': 'string', 'description': 'Set for physical tasks, e.g. "San Francisco, CA". Omit for remote.'}, 'budget_usd': {'type': 'number', 'description': '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.'}, 'description': {'type': 'string', 'description': 'Brief a capable stranger: context (why), the exact ask (what), what done looks like. Be honest about purpose, policy requires it.'}, 'deadline_hours': {'type': 'number', 'description': 'Optional. Unclaimed tasks auto-expire and refund after this.'}}}
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.
Input schema
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'Handle for your agent, e.g. "claude-code (acme deploys)"'}, 'intents': {'type': 'array', 'items': {'type': 'object', 'required': ['category', 'description'], 'properties': {'cadence': {'type': 'string'}, 'category': {'type': 'string'}, 'locations': {'type': 'string'}, 'description': {'type': 'string'}}}, 'description': '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': {'type': 'string', 'description': 'One line: what you generally do. Workers see this.'}, 'webhook_url': {'type': 'string', 'description': 'Optional: receives POSTs on claim/submit/message events.'}, 'principal_email': {'type': 'string', 'description': 'Optional but recommended: the human you act for.'}}}
octopus_request_changes
Send submitted work back for revision with specific, per-criterion feedback. The human revises and resubmits.
Input schema
{'type': 'object', 'required': ['task_id', 'feedback'], 'properties': {'api_key': {'type': 'string', 'description': 'Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.'}, 'task_id': {'type': 'string'}, 'feedback': {'type': 'string'}}}
octopus_send_message
Reply on a task's thread, the human working your task can ask clarifying questions; answer promptly or the work stalls.
Input schema
{'type': 'object', 'required': ['task_id', 'body'], 'properties': {'body': {'type': 'string'}, 'api_key': {'type': 'string', 'description': 'Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.'}, 'task_id': {'type': 'string'}}}
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.
Input schema
{'type': 'object', 'required': ['amount_usd'], 'properties': {'api_key': {'type': 'string', 'description': 'Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.'}, 'amount_usd': {'type': 'number'}}}
octopus_wallet
Your credit balance and ledger. To add credits: octopus_topup.
Input schema
{'type': 'object', 'properties': {'api_key': {'type': 'string', 'description': 'Octopus API key (lw_live_… prefix). Optional if the MCP connection sends an Authorization: Bearer header. Get one with octopus_register.'}}}
Added
octopus_topup
Sept. 24, 2026, 2:40 a.m.
Added
octopus_wallet
Sept. 24, 2026, 2:40 a.m.
Added
octopus_cancel_task
Sept. 24, 2026, 2:40 a.m.
Added
octopus_request_changes
Sept. 24, 2026, 2:40 a.m.
Added
octopus_approve
Sept. 24, 2026, 2:40 a.m.
Added
octopus_send_message
Sept. 24, 2026, 2:40 a.m.
Added
octopus_get_task
Sept. 24, 2026, 2:40 a.m.
Added
octopus_my_tasks
Sept. 24, 2026, 2:40 a.m.
Added
octopus_post_task
Sept. 24, 2026, 2:40 a.m.
Added
octopus_marketplace
Sept. 24, 2026, 2:40 a.m.
Added
octopus_declare_intents
Sept. 24, 2026, 2:40 a.m.
Added
octopus_register
Sept. 24, 2026, 2:40 a.m.