mu
Tools for agents
Overview
Mu is an MCP server and web app for agents and humans. It provides access to the real world through MCP for the agentsand let's humans browse or interact with same content in a web app. Access news, web search, mail,markets, weather, video, places, images, files, calendar, contacts and more.
Use it live at micro.mu, or self-host.
Usage
{
"mcpServers": {
"mu": {
"url": "https://micro.mu/mcp"
}
}
}
Create a Personal Access Token at/token and send it as Authorization: Bearer.
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
That's what gets listed to your agent. Everything else is still callable.
Browse the tools: micro.mu/tools — every tool,grouped by service, with what each call costs.
See MCP docs for the protocol details.
The tools
| Area | Tools |
|---|---|
| Agent | agent · chat — ask the whole thing a question and let it compose |
| Apps | apps_build · apps_run · apps_edit — build and run small web tools |
| Calendar | events_create · events_free · events_list — schedule, and find when you are free |
| Contacts | contacts_find · contacts_add · contacts_list — turn a name into an address |
| Files | files_put · files_get · files_list · files_share — keep a file, get a URL |
| Faith | islam_today · islam_prayer · islam_qibla · quran · hadith |
| Index | index_search — everything this instance holds for you |
| Images | images_generate · images_search |
mail_inbox · mail_send · mail_address — a real SMTP server with DKIM, and an address per agent |
|
| Markets | markets_list — crypto, futures, commodities, currencies |
| News | news_list · news_read · news_search — RSS aggregation, full articles |
| Places | places_search · places_nearby · places_eta — points of interest, geocoding, travel time |
| Storage | db_create · db_get · db_list · db_update · db_delete — per-caller records |
| Writing | blog_* · social_* · stream_* — publish, read, discuss |
| Wallet | wallet_balance — credits, and where to send USDC to top up |
| Weather | weather_forecast — conditions, forecast, pollen |
| Web | web_search · web_fetch — search the web, read a page as clean text |
| Video | video_list · video_search — curated channels, no ads or recommendations |
Request a tool
Open an issue and say what it should do.
The app
The server includes a web app with a home screen. Cards render each service at a glance (headlines,prices, weather, unread mail) and the agent sits inline to act on what you'relooking at. Logged-out visitors get a public version with live data.
An LLM — Claude, Atlas Cloud (DeepSeek), or a local Ollama / OpenAI-compatibleendpoint — calls the services as tools, composes answers, and keeps per-usermemory across sessions.
Sign in with a username and password, a passkey (WebAuthn), or Google.For the CLI, generate a Personal Access Token at /token.
CLI
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 agent "what is the btc price?" # run the full agent
mu weather_forecast --lat 51.5 --lon -0.12
mu wallet # your balance
mu help # full tool list
The CLI is registry-driven — a tool added to the server automatically becomes aCLI 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 environment
See CLI docs.
Discord & Telegram
Talk to the agent from Discord or Telegram — questions, markets, news, all fromchat. Join the Discord
Discord: /agent, /news, /markets, /weather, /mail, /social, /blog,/video, /search, /apps, /balance, /usage.Telegram: /agent, /ask, /news, /markets, /weather, /usage.
Setup for both is in Installation.
Self-hosting
curl -fsSL https://raw.githubusercontent.com/micro/mu/main/install.sh | sh
# 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 --serve
First-run setup
Open http://localhost:8080 and Mu walks you through a one-time setup: createyour admin account and pick an AI provider (Claude, Atlas Cloud, or a localOllama / OpenAI-compatible endpoint). That's enough to have a working agent.
For terminal setup. Configure the provider headless, then start the server:
mu setup # pick a provider, paste a key
mu --serve # first account you create becomes admin
Or set everything by hand:
export [email protected] # who's admin (else: first account)
export ATLAS_API_KEY=xxx # or ANTHROPIC_API_KEY, or OPENAI_BASE_URL
mu --serve
Once you're admin, every other key (YouTube, Brave search, weather, mail/DKIM,Google sign-in…) is configurable from /admin/env in the browser.
See Installation guide.
Configuration
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 Environment Variables for all options.
Documentation
Full docs in the docs folder. Start with MCP for agents,Architecture for the code. The live tool catalogue is at/tools.
License
AGPL-3.0 — use, modify, distribute. If you run a modified version as aservice, share the source.
