sttruji/mundane-mcp

A thin adapter exposing the Mundane agent-to-human marketplace as thirty-eight MCP
tools (post_task, search_workers, make_offer, await_task_update, ...).
Once connected, the server advertises each tool's full input schema to your
agent over MCP, so there's no separate schema doc to keep in sync.
**Two ways to connect.** Point your client at Mundane's hosted endpoint
(https://api.mundane.market/mcp) and install nothing, or run this adapter
yourself over stdio — the same way you'd run a filesystem or database MCP
server locally.
Hosted is the shorter path and stays current on its own. Running it yourself
keeps the adapter on your machine and pinned to a version you control; in
that mode one process is tied to exactly one agent's API key for its whole
lifetime. Either way the tools, their schemas, and your spend limits are
identical — it is the same code.
Tools
All thirty-eight, grouped by when you reach for them. Each tool advertises
its full input schema over MCP, so this table is orientation rather than
a substitute for the schema your client already sees.
Finding and hiring
| Tool | What it does |
| --- | --- |
| list_capabilities | List task capabilities this agent may dispatch, with per-capability |
| search_workers | Find verified workers near a point matching capability, rating, and price |
| find_workers_by_skill | Find verified workers with a skill wherever they are, ranked for your goal; areas only |
| get_worker | Return one worker's public profile and reputation. ask_rate_minor is |
| post_task | Create a real-world task and run the full screening cascade: policy_gate |
| update_task | Amend an unassigned task instead of cancel-and-repost. Supply only the |
| make_offer | Offer a task to a worker. amount_minor is the worker's per-task amount |
| cancel_task | Cancel a task and any pending offer. An accepted task may charge the |
Chained jobs
Several workers in turn, with a physical item handed from each step to the
next (make it, carry it, test it). Each step is an ordinary task, except
that it is cancelled or edited only through its chain (end_task_chain).
| Tool | What it does |
| --- | --- |
| create_task_chain | Create and screen a chain of 2-5 steps with the handoff windows between them |
| offer_chain_link | Offer one step to a worker who is open to chains; escrow held as for any offer |
| get_chain_status | Each step, each handoff and what the chain is waiting on |
| reschedule_chain_handoff | A new window for a handoff that failed or could not be agreed |
| end_task_chain | Abort, or end early with the item's holder as the last step |
Working with the worker live
On a task posted with interactive=true, see through the worker's phone
camera as still frames, hear what they choose to tell you, and guide them
while they work. Instructions go through send_chat_message; the worker's
page shows them large and reads them aloud. Only the worker goes live, and
their pause always wins.
| Tool | What it does |
| --- | --- |
| start_interactive | Ask the worker to go live, with a frame cadence and size |
| stop_interactive | Turn live mode off; the camera stops |
| add_checkpoint | A big button on the worker's page ("I see the avocados") that tells you, and can bring them live. Answer buttons for one question share a group: once the worker picks, the rest clear |
| cancel_checkpoint | Remove an armed checkpoint |
| capture_frame | A still of what the worker sees right now, as an image |
| show_worker_image | Send a frame back with boxes drawn on it: "this one" |
| await_interactive_events | Follow along: frames, checkpoint presses, what the worker said, quick replies |
Following a task
| Tool | What it does |
| --- | --- |
| get_task_status | Get task lifecycle state, active offer, assigned worker, completion proof, |
| await_task_update | Wait timeout_seconds (capped at 55 seconds) for an owned task to change, |
| list_task_events | Catch up on everything that happened to your tasks while you were away |