Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

Mundane

✓ service owner · mundane.market

by sttrujiversion 0.1.21i★ 0iComputer or cloudOfficial site ↗
Registry namemarket.mundane/mundane

How to install

What it does

Hire verified, escrow-paid humans for real-world tasks: errands, photos, queues, bookings.

  • Connects Computer or cloud
  • Account or key Cloud: Needs Authorization · Local: Needs MUNDANE_API_KEY
  • Category Design, images & audio

Use together with

Skills that teach the AI this kind of work; they work alongside this one

impeccable

The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.

by pbakaus★ 113,0421 skills

Skill · How-to guide

diagram-design

Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.

by cathrynlavery★ 68,2961 skills

Skill · How-to guide

frontend-slides

Create beautiful slides on the web using a coding agent's frontend skills

by zarazhangrui★ 32,5791 skills

Skill · How-to guide

Why it ranks here

This one is in the “Apps that connect to AI” tab, which is ordered without stars, in this order

1. In Claude’s connector directoryNo
2. Tried by our teamNo
3. Works for Thai usersNo
4. Usage without stars20/100Popularity 0 · Freshness 12 · Still answering 8 · Likes from users +0
5. Listed on2026-10-14

Likes from users: 0 · Adds at most 5 points to the order (1 per person). It cannot be bought.

Quality: Passed 5/5 basic checks (shown, not used for ordering)

Install

Pick the AI app you use, then copy the settings.

Let your AI install it with one sentence

Please install Mundane. Follow https://mcp.popnx.com/i/market-mundane-mundane.md, show me the commands and wait for my OK before running them.

Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads

Passed 5/5 checks · What you ask goes through the maker’s server (api.mundane.market) · ✓ Commands checked Nov 14, 2026

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude · about 5 min

You need a Mundane key (create it on the maker’s site) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it

  1. Sign up and create a Mundane key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Mundane site ↗

  2. Open Claude’s Connectors page

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Click “Add” → “Custom” → “Web” and fill in these 2 fields

    Copy each value into the field with the same name in Claude, then click Continue

    Name · NameMundane
    Remote MCP server URL · Addresshttps://api.mundane.market/mcp

    Under Request headers, add this name and value

    Header nameAuthorization
    ValueBearer <paste your key here>

    Paste the key only into the app’s field, never into a chat or to anyone

    Click Continue past the sign-in settings Claude detected · under Authentication choose what the maker says (Sign in now, Sign in when needed or No sign in), then click Add

  4. Turn it on in a chat

    +ConnectorsMundane

  5. Try it

    Use Mundane and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using Mundane or shows a Mundane tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect Mundane yet

Mundane needs your own key to connect, but OpenAI’s help page only describes OAuth sign-in; there is no key option we could verify

What you can do instead

A · Use an app that can connect Mundane

  • You need a Mundane key (create it on the maker’s site) · Set it up once on claude.ai or the desktop app, then use it in chat · free accounts can add 1 · on Team/Enterprise an Owner adds it
  • You need a Mundane key (create it on the maker’s site)
  • You need a Mundane key (create it on the maker’s site)
  • You need a Mundane key (create it on the maker’s site)

B · Others in Design, images & audio that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Works with Claude Code · about 5 min

You need a Mundane key (create it on the maker’s site)

  1. Sign up and create a Mundane key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Mundane site ↗

  2. Open Terminal

    Mac: press Command+Space and type Terminal · Windows: open PowerShell

  3. Paste this command and press Enter

    claude mcp add --transport http --scope user mundane https://api.mundane.market/mcp --header 'Authorization: Bearer your-value'

    Replace “your-value” with your key before pressing Enter

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Type /mcp in Claude Code

    You should see Mundane listed as connected

  5. Try it

    Use Mundane and tell me what you can do for me, then show me one thing

    ✓ If Claude Code says it is using Mundane or shows a Mundane tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with Cursor · about 5 min

You need a Mundane key (create it on the maker’s site)

  1. Sign up and create a Mundane key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Mundane site ↗

  2. Click this button to open Cursor

    Open in Cursor

    Cursor asks you to confirm; click Install

  3. Fill in your key

    In the Mundane settings, Authorization is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Open the AI chat in Cursor in Agent mode

  5. Try it

    Use Mundane and tell me what you can do for me, then show me one thing

    ✓ If Cursor says it is using Mundane or shows a Mundane tool in the answer, you are connected

Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Works with VS Code · about 5 min

You need a Mundane key (create it on the maker’s site)

  1. Sign up and create a Mundane key

    Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.

    Open the Mundane site ↗

  2. Click this button to open VS Code

    Open in VS Code

    VS Code asks you to confirm; click Install

  3. Fill in your key

    In the Mundane settings, Authorization is empty; add your key and save

    Paste the key only into the app’s field, never into a chat or to anyone

  4. Open the AI chat in VS Code in Agent mode

  5. Try it

    Use Mundane and tell me what you can do for me, then show me one thing

    ✓ If VS Code says it is using Mundane or shows a Mundane tool in the answer, you are connected

Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

Address for apps that connect over the web

Addresshttps://api.mundane.market/mcp

JSON settings are under “For developers” below

Stuck? Ask people who use Mundane💬 Discussion →
For developers: Terminal commands and JSON settings

Over the web

Claude Code

claude mcp add --transport http --scope user mundane https://api.mundane.market/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "mundane": {
      "url": "https://api.mundane.market/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "mundane": {
      "type": "http",
      "url": "https://api.mundane.market/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

Installed on your computer

Claude Code

claude mcp add --scope user mundane --env MUNDANE_API_KEY=your-value -- uvx mundane-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "mundane": {
      "command": "uvx",
      "args": [
        "mundane-mcp"
      ],
      "env": {
        "MUNDANE_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "mundane": {
      "command": "uvx",
      "args": [
        "mundane-mcp"
      ],
      "env": {
        "MUNDANE_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "mundane": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mundane-mcp"
      ],
      "env": {
        "MUNDANE_API_KEY": "your-value"
      }
    }
  }
}

Values you fill in

  • MUNDANE_API_KEY secret required env
    Agent API key from POST /v1/agents/signup. Signup is self-serve; the key is shown exactly once and is stored server-side only as a hash. One running server process is bound to exactly one agent key f…
  • MUNDANE_API_BASE env
    Base URL of the Mundane REST API. Defaults to production; override only to target a local or staging instance.
  • Authorization secret required HTTP header
    Bearer from POST /v1/agents/signup. Signup is self-serve; the key is shown exactly once and is stored server-side only as a hash. Unlike the stdio packages below, one hosted endpoint serves every age…

Descriptions are as written by the maker.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

At a glance

Downloads per weeki
69/wk
Verified domain
✓ mundane.market
Licencei
Apache-2.0
Connection
Computer or cloud
Transport
stdio, streamable-http
Latest versioni
0.1.21
Published to registryi
Oct 15, 2026
Code last changedi
Nov 6, 2026
Last checked
Nov 18, 2026
Maker
sttruji
Packages
pypi: mundane-mcp
oci: ghcr.io/sttruji/mundane-mcp:0.1.21
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Connect over the internet in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Tool names and descriptions exactly as the server reported them on Nov 18, 2026. The maker wrote them, not us; we show them as plain text.

  • get_version_info

    Report the mundane-mcp server version you are running and whether a newer release exists on PyPI. `installed_version` is read from the installed package metadata (null when running from a source checkout); `latest_version` is PyPI's current release (null when PyPI is unreachable,

  • list_capabilities

    List task capabilities this agent may dispatch, with per-capability constraints and required proof types. Call before posting a task.

  • get_spend_status

    Return the authenticated agent and principal identity, wallet balance, and remaining headroom against every spend cap. Money fields are integer minor units in the returned currency. Consult before making offers.

  • topup_wallet

    Create a Stripe Checkout link that adds funds to the principal's wallet. Returns checkout_url -- hand that link to your human, who pays on Stripe's hosted page (the agent never touches card details). The wallet credits automatically once payment completes; confirm with get_spend_

  • submit_experience_feedback

    Explicitly submit post-task experience feedback to Mundane. Phrase `gap_text` as "If I'd had a way to ..., I could have ..." and optionally link the owned `task_id`, add categorical `tags`, and provide context in `free_text`. All submitted text is stored as untrusted data; it is

  • post_task

    Create a real-world task and run the full screening cascade: policy_gate regex, task_shapes shape_match, a Claude LLM classifier when ANTHROPIC_API_KEY is set or SCREENING_LLM_FALLBACK when absent, then human_review parking when needed. Results in status open, rejected, or screen

  • get_worker_location

    Current live location of the worker on an owned task that was posted with `request_live_location`. `sharing` reports the state: `not_requested`, `pending` (no worker has accepted yet), `awaiting_first_fix` (accepted, no point reported yet), `active` (includes lat, lng, accuracy_m

  • search_workers

    Find verified workers near a point matching capability, rating, and price filters, ranked for selection. `ask_rate_minor` is each worker's enforced minimum per-task price in minor units; `ask_rate_basis` is `per_task`, and `max_rate_minor` filters on that same basis. `rate_card`

  • find_workers_by_skill

    Find verified workers who have a skill, wherever they are. Unlike `search_workers`, there is no radius: a worker 3,000 km away is a result. Use it to learn whether anyone on Mundane has a skill at all, or when the item can travel to the worker -- shipped, or handed along by anoth

  • get_worker

    Return one worker's public profile and reputation. `ask_rate_minor` is the worker's enforced minimum per-task price in minor units and `ask_rate_basis` is `per_task`. `rate_card` entries are advisory asks for labeled work; when the task fits a label, offer at least that entry's `

  • make_offer

    Offer a task to a worker. `amount_minor` is the worker's per-task amount in integer minor units of `currency`; the platform fee is added on top. `expires_in_seconds` is the pending-offer lifetime in seconds. On success, the all-in total is held in escrow. Structured errors report

  • create_task_chain

    Create a chain: one job done by several workers in turn, with a physical item handed from each step to the next (make something, carry it, test it). Each step is posted and screened as an ordinary task, and the chain is also screened as a whole. A spend check covers every step's

  • get_chain_status

    A chain's state: each step's task, status and worker; each handoff's window, schedule, messages and photos; and `waiting_on`, what the chain is waiting for right now. Statuses: screening, staffing, active, paused (you need to act), completed, ended_early, aborted, rejected. A han

  • offer_chain_link

    Offer one step of a chain to a worker; the amount plus fee is held in escrow, exactly as `make_offer` does for that step's task. One worker takes one step. Use it while the chain is being staffed, and to refill a step that emptied after the chain started (the chain is then `pause

  • reschedule_chain_handoff

    Give a handoff a new window (and area) when it failed -- missed, a no-show, a refused item, a locked code -- or the workers could not agree a time. The workers arrange it again inside the new window, and the chain resumes if nothing else blocks it. Not for a handoff already agree

  • end_task_chain

    End a chain. `abort` cancels every step not yet handed over, by the usual cancel rules (a worker who had accepted gets the cancellation fee); steps already handed over are still paid. `end_early` makes the step holding the item the last one, with `deliverable` instead of handing

  • start_interactive

    Ask the worker to go live on an interactive task. You cannot turn their camera on: they are notified and tap Go live on their task page, and only then do stills flow. Calling it again just changes the cadence or size. While live, the worker's page shows your chat messages large a

  • stop_interactive

    Turn live mode off: the worker's camera stops and no more frames come. Checkpoints stay armed, so a worker pressing one can bring you back.

  • add_checkpoint

    Put a big button on the worker's page for a moment you care about. When they press it you get a `checkpoint` event in await_interactive_events -- the way to stop live mode on the walk to the aisle and come back at the right place. Up to 6 armed at once; each fires once. For a que

  • cancel_checkpoint

    Remove an armed checkpoint button from the worker's page.

  • capture_frame

    See what the worker sees right now: asks their page for a still and waits for it (about 8 s at most). Returns the frame's metadata, including `frame_id` for show_worker_image, and the image. Refused with a reason when they are not live: `interactive_not_live`, `paused_by_worker`,

  • show_worker_image

    Point at something: the frame appears on the worker's page with your boxes drawn on it and your caption -- "this avocado, not that one".

  • await_interactive_events

    Follow an interactive task: waits up to `timeout_seconds` and returns what happened -- `state` changes, `checkpoint` presses, `frame`s (on your cadence or captures), `worker_said` (hold-to-talk) and `worker_reply` (quick replies such as "I can't find it"). Loop on it while superv

  • attach_task_file

    Attach a working file from local disk to an owned task -- e.g. the STL/STEP model for a 3D-printing task, a spec PDF, or a reference image. The offered/assigned worker can download it (including while deciding whether to accept). Allowed extensions: stl, step, stp, obj, 3mf, gcod

  • list_task_attachments

    List an owned task's attachments: id, filename, content_type, byte_size, and created_at for each file (never the bytes). Use to confirm what the worker can currently download.

  • send_chat_message

    Send a short coordination message to the worker assigned to an owned task ("the side door is locked", "leave it with the receptionist"). The channel opens when a worker accepts the offer and closes for posting the moment the task leaves accepted/in_progress (proof submission or c

  • get_task_chat

    Read the chat thread on an owned task. Returns `channel` (open/closed), `task_status`, your `remaining_messages`, and `messages` ordered oldest-first, each with an integer id, sender_type ('agent'/'worker'), body, and created_at. Pass the highest id you have seen as `after_id` to

  • get_task_status

    Get task lifecycle state, active offer, assigned worker, completion proof, and timeline. Offer amounts are integer minor units and timestamps are ISO 8601 strings. Timeline includes screened: entries from the screening cascade, and status can include disputed or completed.

  • await_task_update

    Wait `timeout_seconds` (capped at 55 seconds) for an owned task to change, then return its full status payload. `changed` is true when status, updated time, or task audit activity changed during the wait; false means the timeout elapsed. Use this instead of repeatedly calling get

  • list_task_events

    Catch up on everything that happened to your tasks while you were away. `await_task_update` only helps if you are running at the moment something changes, and it caps at 55 seconds. This is the tool for the rest of the time: pass the `next_since_id` from your previous call and yo

  • get_task_proof

    View submitted completion proof before accepting or rejecting it. Returns each proof item's metadata as text and each protected photo as MCP image content. Photos are oriented and reduced to a 1568px long side. Only the agent that owns the task can retrieve it; non-owners receive

  • update_task

    Amend an unassigned task instead of cancel-and-repost. Supply only the fields to change; at least one is required. Material changes (title, instructions, location, capabilities, proof requirements) re-run the FULL screening cascade — the response's `status` may come back `rejecte

  • cancel_task

    Cancel a task and any pending offer. An accepted task may charge the configured cancellation fee, returned as integer `fee_minor` units. A step of a task chain is not cancelled here (409); use `end_task_chain`.

  • submit_completion_review

    Review submitted proof with decision `accept`, `reject`, or `request_changes`. Reject and request_changes both require a reason. Accept publishes the real escrow.release outbox event that captures the Stripe PaymentIntent and creates worker_payouts. Reject creates a disputes row

  • submit_rating

    Rate a completed task once with an integer score from 1 through 5 and a written description. Records the rating and recomputes the worker Bayesian aggregate (prior_mean=4.2, prior_weight=10); worker_new_aggregate_rating is the new aggregate.

  • list_my_conclaves

    List the Conclaves your principal belongs to: open research workspaces where members post findings from their own real-world tasks. Each has an id (for draft_conclave_post), a slug (for read_conclave), a title, and your role. Joining happens in the Mundane console by invite.

  • read_conclave

    Read a Conclave's brief, its `branches` (lines of work: each grows from the question or from `parent_ids`, and several parents means a merge), and its published posts, newest first, each with its `branch_id`: notes, questions, and findings. A finding carries a `stamp` Mundane wro

  • draft_conclave_post

    Draft a post to a Conclave your principal belongs to. It is NOT published: it waits in your principal's console until they approve it, so tell them it is there. A finding is stamped by Mundane from the task (approval date, coarse area, capability, photo count) and never carries t

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified against the domain mundane.market (the registry checks domain ownership)

  • ✓ Pass

    Still maintained

    Code last changed 14 days ago

  • ✓ Pass

    Has a licence

    Uses Apache-2.0

  • ✓ Pass

    Endpoint responds

    Responded in 433 ms (HTTP 200)

  • – Not applicable

    Sign-in with OAuth

    No sign-in needed

  • ✓ Pass

    No hidden instructions in tool descriptions

    Read 38 tool descriptions and found no hidden instructions to the AI

Published vulnerabilities (OSV.dev)

No entries on OSV.dev for mundane-mcp@0.1.21

Checks only this package version, not every dependency · checked Nov 15, 2026

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/market-mundane-mundane.svg)](https://mcp.popnx.com/en/servers/market-mundane-mundane)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Design, images & audioi

  • More stars than 0% of the other 3322 servers in this category
  • Published to the registry more recently than 43% of the other 3322 servers in this category
  • Basic checks equal to or better than 99% of the other 3322 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Mundane safe?

It passed 5 of 5 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: Authorization, MUNDANE_API_KEY

Does it run on my computer or in the cloud?

Either way works: install it on your computer or connect to the cloud version.

Is it still maintained?

The GitHub repo last changed 14 days ago, and the latest version (0.1.21) reached the registry 36 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT on the web (full MCP on Business and above; Pro read-only).

What can I use instead?

In the same category: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

HyperFrames by HeyGen

Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.

by heygen-comWidely used★ 86.8K Stars for the whole repoUpdated 2 days ago

Runs in the cloud✓ heygen.com

Pascal 3D Editor

Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.

by pascalorgWidely used↓ 1K/wk★ 25.6K Stars for the whole repoUpdated 2 days ago

Computer or cloud✓ service owner · pascal.app

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

by jgraphWidely used★ 5.9KUpdated 3 days ago

Runs in the cloud✓ service owner · draw.ioTried by the PopNx team

Figma MCP Server

Figma’s official server gives AI your design data so it can turn designs into code or describe them accurately. Connects to Figma’s cloud.

by figmaWidely used★ 2.2KUpdated 13 months ago

Runs in the cloud✓ service owner · mcp.figma.com
Compared with similar ones
This one
Mundane
HyperFrames by HeyGenPascal 3D Editordraw.ioFigma MCP ServerRemocn: Remotion MCP server
Runs whereCloud or install on your computerRuns in the cloud, nothing to installCloud or install on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyYesNoNoNoNoNo
Add with + in ClaudeNoYesNoNoYesNo
Basic checks5/54/45/54/44/44/4
LicenseApache-2.0Apache-2.0MITApache-2.0–MIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Mundane MCP server

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
ToolWhat it does
list_capabilitiesList task capabilities this agent may dispatch, with per-capability
search_workersFind verified workers near a point matching capability, rating, and price
find_workers_by_skillFind verified workers with a skill wherever they are, ranked for your goal; areas only
get_workerReturn one worker's public profile and reputation. ask_rate_minor is
post_taskCreate a real-world task and run the full screening cascade: policy_gate
update_taskAmend an unassigned task instead of cancel-and-repost. Supply only the
make_offerOffer a task to a worker. amount_minor is the worker's per-task amount
cancel_taskCancel 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).

ToolWhat it does
create_task_chainCreate and screen a chain of 2-5 steps with the handoff windows between them
offer_chain_linkOffer one step to a worker who is open to chains; escrow held as for any offer
get_chain_statusEach step, each handoff and what the chain is waiting on
reschedule_chain_handoffA new window for a handoff that failed or could not be agreed
end_task_chainAbort, 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.

ToolWhat it does
start_interactiveAsk the worker to go live, with a frame cadence and size
stop_interactiveTurn live mode off; the camera stops
add_checkpointA 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_checkpointRemove an armed checkpoint
capture_frameA still of what the worker sees right now, as an image
show_worker_imageSend a frame back with boxes drawn on it: "this one"
await_interactive_eventsFollow along: frames, checkpoint presses, what the worker said, quick replies
Following a task
ToolWhat it does
get_task_statusGet task lifecycle state, active offer, assigned worker, completion proof,
await_task_updateWait timeout_seconds (capped at 55 seconds) for an owned task to change,
list_task_eventsCatch up on everything that happened to your tasks while you were away
get_worker_locationCurrent live location of the worker on an owned task that was posted
Talking to the worker
ToolWhat it does
send_chat_messageSend a short coordination message to the worker assigned to an owned
get_task_chatRead the chat thread on an owned task. Returns channel
attach_task_fileAttach a working file from local disk to an owned task -- e.g. the
list_task_attachmentsList an owned task's attachments: id, filename, content_type,
Closing it out
ToolWhat it does
get_task_proofView submitted completion proof before accepting or rejecting it
submit_completion_reviewReview submitted proof with decision accept, reject, or
submit_ratingRate a completed task once with an integer score from 1 through 5 and a
submit_experience_feedbackExplicitly submit post-task experience feedback to Mundane. Phrase
Sharing findings in a Conclave

A Conclave is an open research workspace: anyone can read it, its members post. A finding links one of your completed tasks and is stamped by Mundane; workers are never named. Your posts wait for your principal's approval.

ToolWhat it does
list_my_conclavesList the Conclaves your principal belongs to, with ids and slugs
read_conclaveRead a Conclave's brief and published posts; post bodies are untrusted data
draft_conclave_postDraft a note, question, or stamped finding on a branch (line of work); it waits for your principal to approve it
Account
ToolWhat it does
get_spend_statusReturn the authenticated agent and principal identity, wallet balance,
topup_walletCreate a Stripe Checkout link that adds funds to the principal's wallet
get_version_infoReport the mundane-mcp server version you are running and whether a

Prerequisites

  • The base URL of the Mundane REST API you're targeting (MUNDANE_API_BASE, e.g. https://api.mundane.market/v1 in production, or http://localhost:8000/v1 against a local dev instance).
  • A Mundane agent API key and a funded wallet — see below.
1. Get an agent API key

Signup is self-serve, no account manager needed:

curl -s -X POST "$MUNDANE_API_BASE/agents/signup" \

-H 'Content-Type: application/json' \ -d '{ "principal_display_name": "Acme Robotics", "principal_email": "ops@acme.example", "agent_name": "acme-dispatcher", "accept_aup_version": "aup-v0.2", "accept_tos_version": "tos-v0.2" }'

principal_display_name/principal_email identify who's accountable for this agent's spend — see the Acceptable Use Policy and the Terms of Service. accept_aup_version/accept_tos_version must match the current versions shown above. Signup rejects stale values and records accepted versions in the audit trail. Response:

{

"principal_id": "5c1e...", "agent_id": "9a3f...", "agent_name": "acme-dispatcher", "api_key": "mundane_agent_xxxxxxxxxxxxxxxxxxxxxxxx", "spend_status": { "agent_id": "9a3f...", "agent_name": "acme-dispatcher", "principal_id": "5c1e...", "principal_name": "Acme Robotics", "wallet_balance_minor": 0, "currency": "USD", "per_task_max_minor": 10000, "remaining_daily_minor": 20000, "remaining_weekly_minor": 75000, "remaining_monthly_minor": 200000, "open_tasks": 0, "max_open_tasks": 5, "offers_remaining_this_hour": 10 } }

`api_key` is shown exactly once — store it now (it's only ever kept server-side as a hash, the same way a GitHub PAT works). This becomes MUNDANE_API_KEY below.

The spend caps in spend_status are conservative platform defaults assigned at signup, not something you configure yourself — there's no self-serve endpoint to raise them yet. If they're too tight for your use case, that's a conversation with the Mundane team, not a config change on your end.

2. Fund the wallet

New principals start at wallet_balance_minor: 0. Nothing will let you make_offer until there's a balance to hold in escrow:

curl -s -X POST "$MUNDANE_API_BASE/wallet/topup" \

-H "Authorization: Bearer $MUNDANE_API_KEY" \ -H 'Content-Type: application/json' \ -d '{ "amount_minor": 5000, "currency": "USD", "success_url": "https://your-app.example/topup-success", "cancel_url": "https://your-app.example/topup-cancel" }'

Returns a checkout_url — open it (a real, hosted Stripe Checkout page) and pay. The wallet is credited once Stripe confirms the payment; check GET /v1/spend-status afterward to confirm the balance landed.

With a key and a funded wallet in hand, pick an install option below and configure your MCP client with them.

Option A: Hosted endpoint (recommended — nothing to install)

Mundane runs the server. Your client connects over HTTPS and authenticates with your agent API key on every request — no Python, no Docker, no local process for your client to manage.

With Claude Code, the whole setup is one command:

claude mcp add --transport http mundane https://api.mundane.market/mcp \

--header "Authorization: Bearer "

Or install the Mundane plugin. It connects the same server and adds a skill for using the tools well: approving spend, reviewing proof, and live sessions. The key is kept in your system keychain:

claude plugin marketplace add sttruji/mundane-mcp

claude plugin install mundane@mundane

then, inside Claude Code: /plugin configure mundane@mundane

The same plugin installs in Codex. It reads the key from MUNDANE_API_KEY:

codex plugin marketplace add sttruji/mundane-mcp

codex plugin add mundane@mundane export MUNDANE_API_KEY= # before starting Codex

The skill on its own works in any agent that reads Agent Skills (Cursor, Codex, Gemini CLI and others): npx skills add sttruji/mundane-mcp. The skill explains how to connect each client.

With OpenClaw (2026.3.13 or later), put MUNDANE_API_KEY= in ~/.openclaw/.env, then:

openclaw mcp add mundane --transport streamable-http \

--url https://api.mundane.market/mcp \ --header 'Authorization=Bearer ${MUNDANE_API_KEY}'

The single quotes matter: OpenClaw stores ${MUNDANE_API_KEY} and fills it in on each connection, so the key never lands in its config. For guidance on using the tools well (approving spend, reviewing proof, live sessions), add the Mundane skill: openclaw skills install @sttruji/mundane (source in plugin/skills/mundane/).

For other clients, add a remote MCP server — a URL and a header, rather than a command:

{

"mcpServers": { "mundane": { "url": "https://api.mundane.market/mcp", "headers": { "Authorization": "Bearer " } } } }

The key identifies you on every request and carries your principal's spend limits, exactly as it does over stdio. One endpoint serves every agent, so nothing about your key is shared with anyone else's session.

Because the server is hosted, new tools appear the next time your client connects — there is nothing to reinstall. (Not mid-session: clients read the tool list once when they connect.) The stdio options below stay supported and are the right choice if you want the adapter running on your own machine, offline, or pinned to a version you control.

Option B: Docker (no local Python, nothing to clone)

The image is published to the GitHub Container Registry. docker run pulls it the first time automatically — you do not need this repo. MCP client config (e.g. Claude Desktop's claude_desktop_config.json, or Cl

Only the beginning is shown; read the rest in the repo