Skip to content

micro/mu

Repository files navigation

mu

The everything app — blog, chat, news, mail, weather and more — all in one place. No ads. No tracking. No algorithm.

Overview

Micro is the everything app. Blog, chat, news, mail, and more — all in one place. No ads, no tracking, no algorithms. Built in the open. We call the app Mu for short.

Pay for the tools, not with your attention.

What's included

  • News — Headlines from RSS feeds, chronological, with AI summaries
  • Markets — Live crypto, futures, and commodity prices
  • Weather — Forecasts and conditions
  • Mail — Private messaging and email
  • Blog — Microblogging with daily AI-generated digests
  • Chat — AI-powered conversation on any topic
  • Video — YouTube without ads, algorithms, or shorts
  • Web — Search the web without tracking
  • Agent — AI assistant that can search, answer, and build across every service
  • Apps — Build and use small, useful tools

Runs as a single Go binary. Self-host or use mu.xyz.

Screenshots

Home

image

View more

How it works

The home screen shows cards — a summary of each service. Each card links to a full page. News card shows headlines, links to /news. Markets card shows prices, links to /markets. Everything at a glance, details one tap away.

For developers

Mu exposes a REST API and MCP server at /mcp so AI agents and tools can connect directly.

{
  "mcpServers": {
    "mu": {
      "url": "https://mu.xyz/mcp"
    }
  }
}

30+ tools — news, search, weather, places, video, email, markets — accessible via MCP. AI agents can pay per-request with USDC through the x402 protocol. No API keys. No accounts. Just call and pay.

See API docs · MCP docs

CLI

Every MCP tool is also available as a mu subcommand. The same binary runs the server (mu --serve) and the CLI — with no arguments it becomes a thin client that talks to /mcp.

mu news                                 # latest news feed
mu news_search "ai safety"              # search news
mu chat "hello"                         # chat with the AI
mu agent "what is the btc price?"       # run the full agent
mu web_search "claude code"             # search the web
mu weather_forecast --lat 51.5 --lon -0.12
mu blog_create --title "Hi" --content "..."
mu apps_build --prompt "a pomodoro timer"
mu me                                   # your account
mu help                                 # full tool list
mu help apps_build                      # parameters for a specific tool

The CLI is registry-driven — every tool added to the MCP server automatically becomes a CLI command. Flags map to tool parameters.

Authentication

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

Config

Loaded from $XDG_CONFIG_HOME/mu/config.json (default ~/.config/mu/config.json). Override with MU_URL / MU_TOKEN or --url / --token flags.

Output

Pretty-printed JSON when attached to a terminal, raw JSON when piped — so mu news | jq '.feed[0]' works. Use --table to render list results as a text table.

See CLI docs for more.

Pricing

Browsing is included. AI and search features use credits — 1 credit = 1p, pay as you go.

  • Card — Top up via Stripe. 1 credit = 1p.
  • Crypto — AI agents pay per-request with USDC via x402. No account needed.

See Wallet & Credits for details.

Self-hosting

# Install
git clone https://github.com/micro/mu
cd mu && go install

# Configure
export ANTHROPIC_API_KEY=xxx    # AI features (Claude)
export YOUTUBE_API_KEY=xxx      # Video search

# Run
mu --serve

Go to localhost:8081. See Installation guide for full setup.

Configuration

Customise feeds, prompts, and cards by editing JSON files:

  • news/feeds.json — RSS news feeds
  • chat/prompts.json — Chat topics
  • home/cards.json — Home screen cards
  • video/channels.json — YouTube channels
  • places/locations.json — Saved locations

See Environment Variables for all options.

Documentation

Full docs at mu.xyz/docs or in the docs folder.

License

AGPL-3.0 — use, modify, distribute. If you run a modified version as a service, share the source.

About

A personal app platform — blog, chat, news, mail, weather and more. No ads. No tracking. No algorithm.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors