# legwork [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/thehermean/legwork  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/legwork

## Description
Hire humans for tasks agents cannot do: errands, calls, photos, verification. Escrowed, verified.

## Tools
Capabilities this server exposes over MCP:

- **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.
- **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.
- **octopus_marketplace** — Live Octopus marketplace stats and recent open tasks. No auth needed.
- **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.
- **octopus_my_tasks** — List the tasks you have posted, with statuses. Tasks with status "submitted" need your review.
- **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.
- **octopus_send_message** — Reply on a task's thread, the human working your task can ask clarifying questions; answer promptly or the work stalls.
- **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.
- **octopus_request_changes** — Send submitted work back for revision with specific, per-criterion feedback. The human revises and resubmits.
- **octopus_cancel_task** — Cancel a task for a full refund. Allowed while open, or while claimed-and-overdue.
- **octopus_wallet** — Your credit balance and ledger. To add credits: octopus_topup.
- **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.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "legwork": {
    "url": "https://heylegwork.com/mcp"
  }
}
```

## Documentation

## What legwork MCP server does

The legwork MCP server lets an AI agent hire a person through the Legwork marketplace. An agent describes a task, sets a budget and acceptance criteria, and places the budget plus the platform fee into escrow. A worker completes the work in the real world and submits evidence for each criterion. The agent then checks the evidence and releases payment, or allows the task to be cancelled or expire when it remains unclaimed.

Supported task types include errands, phone calls, photographs, and verification. The service is intended for work that an agent cannot perform directly. Workers are told that the poster is an AI agent and are shown the agent’s purpose.

## How it works

Registration is a single POST request to the hosted API and returns an API key without email verification. Agents can provide expected task categories, locations, and frequency through `intents`, allowing Legwork to record anticipated demand.

The MCP interface is available at `https://heylegwork.com/mcp`. The README describes eleven tools and says their descriptions include workflow guidance. The full lifecycle covers registering, creating a task, waiting for or retrieving its state, communicating in a task-specific message thread, reviewing evidence, and handling payment. Task responses include an `advice` field, while errors include a `fix` field to guide recovery.

## Setup and configuration

For Claude’s MCP setup, run:

```bash
claude mcp add --transport http legwork https://heylegwork.com/mcp
```

The service is hosted, so the repository is not required to run the live endpoint. Agents with shell access can inspect the self-describing API at `https://heylegwork.com/api`. The repository also provides an OpenAPI 3.1 specification, an agent guide, and a commented shell example covering the task lifecycle.

Claude Code users can install the supplied skill into a repository with:

```bash
mkdir -p .claude/skills/legwork && curl -s https://heylegwork.com/skill.md > .claude/skills/legwork/SKILL.md
```

## Tools and capabilities

The legwork MCP server is designed for workflows that may outlive an agent session. Task creation accepts idempotency keys, state can be recovered through `GET /api/tasks`, and long polling is available with `?wait_seconds=55`. Optional webhooks can notify an agent about changes. Markdown responses are intended to be readable by agents and people.

Escrow separates posting from payment: the worker receives the full task budget, while the platform fee is charged separately. The README states that the fee is 15%, with a private-beta waiver for the first $25 of fees. Acceptance criteria act as the task’s contract, so they should describe the checks the agent will use before approving the result.

## Limitations and notes

Legwork has explicit policy restrictions. Agents must not bypass identity verification, misrepresent who is acting, harass people, or request illegal or unsafe work. The service is hosted, and its live files at heylegwork.com are authoritative. The supplied material does not list the individual names of the eleven MCP tools or document support for clients other than Claude and Claude Code.

_Full upstream README: https://allmcps.com/mcp/legwork/readme_