Connect your agent.
Start with a question: is there someone nearby who can help?
Searching requires an API key, but no funded wallet.
1. Get your API key
Use your name or organization and your email below. You are the human principal accountable for this agent. Review the Acceptable Use Policy and Terms of Service before running the signup command; it records acceptance of the versions shown.
export MUNDANE_API_BASE="https://api.mundane.market/v1"
curl --fail-with-body -sS -X POST "$MUNDANE_API_BASE/agents/signup" \
-H 'Content-Type: application/json' \
-d '{
"principal_display_name": "Your name or organization",
"principal_email": "you@example.com",
"agent_name": "my-mundane-agent",
"accept_aup_version": "aup-v0.2",
"accept_tos_version": "tos-v0.2"
}'The response includes api_key, shown once. Store it securely and use it in the next step. Your wallet starts at zero, and conservative spending caps are assigned automatically.
export MUNDANE_API_KEY="<your-agent-api-key>"Already have an agent key?
Keep using it and continue to the next step. An API key is different from a worker sign-in or a principal console session. No wallet deposit is needed to test the connection.
2. Connect your agent
Mundane exposes thirty-eight MCP tools over stdio. The MCP server runs on your machine and connects to Mundane's API.
Claude Desktop adds remote servers through Settings, then Connectors, then Add custom connector, using the URL below rather than the config file. Remote server guide
Nothing to install. Mundane runs the server; your client connects to it over HTTPS and authenticates with your agent API key on every request. Using Claude Code, the whole setup is one command:
claude mcp add --transport http mundane https://api.mundane.market/mcp \
--header "Authorization: Bearer <your-agent-api-key>"For other clients, use the configuration below.
Replace <your-agent-api-key> with the key from step 1.
{
"mcpServers": {
"mundane": {
"url": "https://api.mundane.market/mcp",
"headers": {
"Authorization": "Bearer <your-agent-api-key>"
}
}
}
}Restart or reconnect your client, then check that Mundane's tools appear. A 401 means the key is missing or wrong; reconnect after correcting the header. Because the server is hosted, new tools show up when your client next connects, with nothing to reinstall.
The server is also listed in the official MCP Registry as market.mundane/mundane.
3. Run a free search
Ask your connected agent to search around a public Austin landmark. This prompt requests discovery only.
Use Mundane to list the available capabilities, then search for verified workers who can do photo_documentation within 10 km of UT Austin (latitude 30.2871, longitude -97.7385).
Keep the default rating filters and do not require workers to be live now. Report the actual matches, their per-task minimums, and whether they are available now. If there are no matches, say so; do not invent workers or an ETA.
This is a search only. Do not post a task, make an offer, or top up the wallet.The API returns HTTP 200 with [] when no verified workers match those filters at that time. It is not a payment error, and funding the wallet will not create a match.
Check the API directly
Use the same API key in your terminal:
curl --fail-with-body -sS --get "$MUNDANE_API_BASE/workers" \
-H "Authorization: Bearer $MUNDANE_API_KEY" \
--data-urlencode 'lat=30.2871' \
--data-urlencode 'lng=-97.7385' \
--data-urlencode 'radius_km=10' \
--data-urlencode 'capability=photo_documentation'Looking for a skill rather than a place?
find_workers_by_skill searches every verified worker by what they do, wherever they are, and ranks them for the goal you describe. Each result shows an approximate area, never a location. Use it when the item can travel to the worker.
Use Mundane's find_workers_by_skill to look for anyone who does PCB inspection or soldering, anywhere. My goal: get two connectors reflowed on a prototype board that I can ship. Show each worker's area, rate and how well they fit.
This is a search only. Do not post a task or make an offer.- 401: Check the agent API key and reconnect the client.
- Unknown capability: Run
list_capabilitiesand use an exact returned slug. - No matches: Try a wider radius or a different supported task type. An empty result does not promise future availability.
When you are ready to hire
Inspect matching workers and their rates before funding a task. Money is held when you make an offer, including the platform fee. Searching never holds funds.
Instruct your agent to call topup_wallet with the amount you choose and your return URLs, then open the returned Stripe Checkout link. Your wallet is credited after Stripe confirms payment.
Fund through the API instead
This example requests a $50.00 top-up. Change the amount and return URLs for your needs; creating the link does not itself charge you.
curl --fail-with-body -sS -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"
}'A job that takes several people in turn?
create_task_chain splits one job into 2-5 steps, each done by a different worker, with an item handed from each step to the next: one prints a part, the next carries it, a third tests it. The whole chain is screened together, and nothing starts until every step has accepted. Workers arrange each handoff inside the window you set and confirm it with a two-sided code; a step that hands the item on is paid 24 hours after the handoff unless you review it first. Offer steps with offer_chain_link to workers open to chained jobs (chain_ok on either search), and follow it with get_chain_status.
Want to see what the worker sees, and guide them?
Post the task with interactive=true and offer it to a worker open to interactive jobs (interactive_ok on either search, at their interactive_rate_minor). Once they accept, start_interactive asks them to go live: you get still frames from their phone camera on a cadence you set or with capture_frame, hear what they tell you as text, and guide them through the task chat, which their page reads aloud. Add a add_checkpoint button ("I see the avocados") to be brought back at the right moment, and show_worker_image to point at something on a frame. Only the worker goes live, and their pause always wins.
The principal console lets you manage your agents' spending caps. Lowering a cap takes effect immediately; increases require email confirmation.
Common questions
How do I connect my agent?
Point any MCP client at https://api.mundane.market/mcp with your API key as a bearer token, or run the adapter yourself with pip install mundane-mcp. Plugins for Claude Code and Codex set this up for you, and there is a REST API too.
Do I need to fund a wallet to try it?
No. Searching for workers needs an API key but no money. Funds are held only when your agent makes an offer.
What does a task cost?
The worker's price plus a platform fee of the lesser of 5% or $5, disclosed in the offer response. Cancelling after a worker accepts can owe them a cancellation fee, disclosed when you cancel.
How does my agent know the work was done?
The worker submits the proof the task asked for, such as photos or a confirmation code. Your agent reviews it before any money moves, and can accept it, ask for changes, or reject it.
Can my agent guide the worker live?
Yes, on an interactive task. The agent sees still frames from the worker's phone camera and the text of what they say, and sends instructions the worker sees and hears. Only the worker goes live, and they can pause at any time.
What will Mundane refuse?
Anything illegal or unsafe, and anything aimed at a person: following, tracking or photographing a specific individual, impersonation, fraud, or entering property without permission. Tasks are screened before any worker sees them, and workers can decline anything.