Tools for agents. News, mail, search, weather, markets, video, places, files, contacts, calendar and your own documents, as tools an agent can use via one MCP server and token — also includes a web app for humans.
curl -fsSL https://raw.githubusercontent.com/micro/mu/main/install.sh | sh
mu --serveOpen http://localhost:8080. The first account you create is the admin.
It runs with no configuration. A few things need an API key.
| For | Set | Notes |
|---|---|---|
| AI features | ANTHROPIC_API_KEY, ATLAS_API_KEY, OPENROUTER_API_KEY, or OPENAI_BASE_URL |
free if you run Ollama locally |
| Web search | BRAVE_API_KEY |
Brave has a free tier |
| Video | YOUTUBE_API_KEY |
free quota |
Follow setup in CLI
mu setup # pick an AI provider, paste a key
mu --serveEverything else — mail and DKIM, Google sign-in, Stripe, x402 — is optional,
and configurable from /admin/env once you are signed in as admin.
Other ways to run it:
# Docker
git clone https://github.com/micro/mu && cd mu
docker compose up
# From source
git clone https://github.com/micro/mu
cd mu && go install
mu --serveSee the installation guide.
Cursor, and clients with a config file. Create a token at /token:
{
"mcpServers": {
"mu": {
"url": "https://micro.mu/mcp",
"headers": {
"Authorization": "Bearer ${env:MU_TOKEN}"
}
}
}
}Claude Desktop. Settings → Connectors → Add custom connector, and paste
https://micro.mu/mcp. It registers itself, opens a browser and asks you to
sign in — no token needed. Pasting the URL into claude_desktop_config.json
will not work: that file only takes local command-line servers.
Anything else. It is JSON-RPC over HTTP POST:
curl -X POST https://micro.mu/mcp -H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Scope the connection to the services you need:
https://micro.mu/mcp?tools=news,web,mail
See micro.mu/tools for all the tools. See Help for the protocol.
Here are the tools
| Service | Tools |
|---|---|
| Apps | apps_build · apps_create · apps_edit · apps_fork · apps_read · apps_run · apps_search · apps_test — build and run small web tools |
| Blog | blog_create · blog_read · blog_list · blog_update · blog_delete — publish, with AI-generated daily digests |
| Chat | chat_rooms · chat_messages · chat_send — the live discussion rooms attached to an item, and saying something in one |
| Contacts | contacts_add · contacts_find · contacts_list · contacts_delete — turn a name into an address |
| Docs | docs_write · docs_read · docs_list · docs_delete — your own documents: a title and a markdown body, private by default. docs_write with an id replaces one. For something short to remember, use notes; apps persist through mu.db, which is a record store rather than documents |
email_send · email_history · email_sender · email_verify — email people outside, from a sending domain of its own. Capped per day, and the history says delivered or bounced rather than only accepted. email_verify is the signup code check, under your product's name |
|
| Events | events_create · events_list · events_delete · events_free — schedule, cancel, and find when you are free, counting the Google Calendar you already keep |
| Files | files_put · files_get · files_list · files_share · files_delete — keep a file, get a URL |
| Flights | flights_overhead · flights_track · flights_airport — where aircraft are, live from the positions they broadcast themselves. No schedule behind it, so it says where an aeroplane is and never why it is late |
| Food | food_product · food_search · food_hygiene — what is in a packet and whether the kitchen is clean. A barcode gives ingredients, allergens, nutrition per 100g and how processed it is, from Open Food Facts; food_hygiene gives the Food Standards Agency's inspection rating for any UK business. Where the data is silent it says so, because an absence of allergen information is not an absence of allergens. Needs no key |
| Hazards | hazards_quakes · hazards_alerts — recent earthquakes worldwide from the USGS, with magnitude, place, how long ago and any tsunami warning, and current disasters from GDACS: cyclones, floods, volcanoes and wildfires, green through red. Pass a lat/lon to ask about somewhere in particular. Needs no key |
| Images | images_generate · images_search |
mail_inbox · mail_send · mail_search · mail_info — private messages, and an inbox each of your agents can be reached at. mail_send writes as you: a username stays here, a full address leaves so a reply comes back. Write to you+name@ and that agent answers in the thread |
|
| Markets | markets_list · markets_convert — stocks, crypto, futures, commodities, currencies, and conversion between them. markets_convert takes a past date back to 1999 and converts crypto at the live price through the dollar |
| News | news_list · news_read · news_search — RSS aggregation, full articles |
| Notes | notes_add · notes_get · notes_list · notes_delete — a title and what is under it, kept between conversations and read back into every one |
| Places | places_search · places_nearby · places_geocode · places_address · places_elevation — points of interest, geocoding both directions, height above sea level |
| Prayer | prayer_times · prayer_qibla · prayer_reflection · prayer_verse · prayer_saying · prayer_search — Islamic prayer times, qibla, a daily verse and saying, and the sources by reference or by question |
| Routes | routes_eta · routes_directions · routes_nearest — travel time with traffic, turn-by-turn, and which of several places is quickest to reach |
| Search | web_search · web_fetch — search the web, read a page as clean text |
| SMS | sms_send · sms_history · sms_number · sms_verify — text somebody and read what they text back, from a real number. Priced per segment, capped per day, and STOP is honoured |
| Social | social_list · social_search — public threads and replies |
| Stream | stream_list · stream_post — this instance's own timeline |
| Tasks | tasks_create · tasks_list · tasks_next · tasks_update · tasks_delete — what is to be done, and work you can hand to the agent |
| Text | text_summarise · text_extract · text_classify · text_translate — language work at a fixed price per call: shorten it, turn it into JSON matching a schema you give, sort it into one of your labels, or put it in another language. Capped at 30,000 characters, and priced because each one is a model call we pay for |
| Transit | transit_nearby · transit_arrivals · transit_status · transit_feeds — stops near a point, what is due at one, and which lines are delayed or suspended. London is live from TfL, down to how many minutes away the bus is. Anywhere else answers from the agency's published timetable, using the same two tools and saying which kind of answer it gave — set TRANSIT_FEEDS to load one, and transit_feeds lists which are worth loading and what each costs. Needs no key either way |
| User | user_saved · user_save · user_unsave · user_hide · user_flag · user_block · user_unblock — what you do about other people's posts: keep one, stop seeing one, report one, or stop hearing from an account |
| Video | video_list · video_search — curated channels, no ads or recommendations |
| Weather | weather_forecast · weather_air · weather_marine · weather_history — conditions and the days ahead; air quality, pollutants, UV and pollen; wave height, period and direction at a coastal point; and what the weather actually was between two dates. Everything but the forecast is keyless |
whatsapp_send · whatsapp_history · whatsapp_open — reply to people on WhatsApp. Only within 24 hours of their message, which is WhatsApp's rule and not ours: whatsapp_open says who can be written to and until when |
Open an issue to request a tool.
The server includes a web app. A home screen renders each service at a glance — headlines, prices, weather, unread mail — and the agent sits inline to act on what you are looking at. Apps run sandboxed, in an opaque origin, and reach the platform through a fixed set of operations rather than your session.
Sign in with a username and password, a passkey (WebAuthn), or Google.
Every tool is a mu subcommand. The same binary runs the server (mu --serve)
and the CLI.
mu news list # latest headlines
mu news search "ai safety" # search news
mu web search "claude code" # search the web
mu markets list --category stocks # live prices
mu agent "what is the btc price?" # run the full agent
mu weather forecast --lat 51.5 --lon -0.12
mu docs list --collection notes # your own documents
mu wallet # your balance
mu help # full tool listEvery tool in the table above is a command: the service, then the method. The
underscore form works too, so mu news list and mu news_list are the same
call.
The CLI is registry-driven — a tool added to the server automatically becomes a CLI command.
mu login # opens /token in your browser, paste the PAT back
mu config set token xxx # or set it directly
export MU_TOKEN=xxx # or use the environmentRun mu --help for the list — it reads the same catalogue the agent does.
The same binary is also an agent. mu agent brings your own model and your own
wallet, reads its tools from a running instance, and pays per call — no account
on that instance and no signup.
# 1. A model. The tools are rented; the thinking is yours.
export ANTHROPIC_API_KEY=sk-ant-... # or OPENROUTER_API_KEY
# or OPENAI_BASE_URL for Ollama etc.
# 2. A wallet. Created for you on first run, or make it yourself:
mu wallet new # prints an address; send USDC on Base
# to it. No ETH — you never pay gas.
# 3. Ask.
mu agent # a conversation
mu agent "what happened in markets today?"model: anthropic/claude-sonnet-4-6
96 tools from https://micro.mu
wallet: 0x4160a863… (1.27 USDC)
> what are the top news headlines today?
· news_list
…
> of those, which matters most for markets?
… answered with no tool call, and no charge
Reading the catalogue is free, so it works before the wallet holds anything — only priced tools need funds. What a run spent is read back off the chain when it ends, not totted up from what the agent believes it authorised.
--server points it at any x402 instance; a name from X402_SERVERS works too.
--seed uses a different key.
Talk to the agent from Discord or Telegram — questions, markets, news, all from chat. Join the Discord
Every tool is a command on both, in the same two-word shape as the CLI:
/news list, /markets list category:stocks, /prayer times. Discord gets one
slash command per service with the methods as subcommands; on Telegram you type
/news list. Both also take /agent <question> for anything that needs
composing, and /usage for your own stats.
Setup for both is in Install.
A person tops up by card and spends one credit balance. A credit is 1p.
An agent can pay with USDC over x402 and never sign
up. A priced call with no credentials answers 402 Payment Required naming
the price and where to send it. The payment is the identity.
To write an agent that pays, see examples/x402-agent — a standalone module that imports none of this. It uses the x402 Foundation SDK, so the same file pays any x402 server.
To watch it work, mu is its own client too. Put a funded Base wallet's key in
~/.mu/keys/wallet.seed:
mu x402 call web_search query="x402" # 402 → signs → pays → returns the resultSelf-host with neither Stripe nor x402 and nothing is metered: every tool is free.
Customise feeds, prompts and cards by editing JSON files:
service/news/feeds.json— RSS news feedsservice/chat/prompts.json— chat topicshome/cards.json— home screen cardsservice/video/channels.json— YouTube channelsservice/places/locations.json— saved locations
See Install for every setting the code reads.
Three pages, and they are the site's: About, Help for connecting an agent, and Install for running your own. The live tool catalogue is at /tools — it is generated from what the instance runs, so it cannot go stale.
For the code, Architecture.
AGPL 3.0