Legwork

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:

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:

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.