https://github.com/micro/mu
A personal app platform — blog, chat, news, mail, video and more
https://github.com/micro/mu
apps mcp micro mu
Last synced: 28 days ago
JSON representation
A personal app platform — blog, chat, news, mail, video and more
- Host: GitHub
- URL: https://github.com/micro/mu
- Owner: micro
- License: agpl-3.0
- Created: 2025-11-06T09:21:18.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2026-05-26T08:49:37.000Z (29 days ago)
- Last Synced: 2026-05-26T10:28:06.211Z (29 days ago)
- Topics: apps, mcp, micro, mu
- Language: Go
- Homepage: https://mu.xyz
- Size: 22.6 MB
- Stars: 91
- Watchers: 0
- Forks: 1
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Changelog: news/digest/digest.go
- License: LICENSE
Awesome Lists containing this project
README
# mu
A personal app platform — blog, chat, news, mail, video and more.
## Overview
The current tech ecosystem is totally broken. All the app platform are filled with ads and addictive content. I'm tired of it. You probably are too.
So here's a personal app platform. Blog, chat, news, mail, video and more. No ads, no tracking, no algorithms. Built in the open. It's called Mu for short.
### 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
The home screen has two modes: **Overview** (cards at a glance) and **Console** (command the system — ask Micro anything and get an instant answer). A public **event stream** at `/stream` lets agents and tools subscribe to platform activity.
Runs as a single Go binary. Self-host or use [mu.xyz](https://mu.xyz).
## Screenshots
### Home
[View more](docs/SCREENSHOTS.md)
## 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](https://modelcontextprotocol.io) server at `/mcp` so AI agents and tools can connect directly.
```json
{
"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](https://x402.org). No API keys. No accounts. Just call and pay.
See [API docs](https://mu.xyz/api) · [MCP docs](docs/MCP.md)
## 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`.
```bash
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
```bash
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](docs/CLI.md) 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](https://x402.org). No account needed.
See [Wallet & Credits](docs/WALLET_AND_CREDITS.md) for details.
## Self-hosting
```bash
# 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](docs/INSTALLATION.md) 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](docs/ENVIRONMENT_VARIABLES.md) for all options.
## Documentation
Full docs at [mu.xyz/docs](https://mu.xyz/docs) or in the [docs](docs/) folder.
## License
[AGPL-3.0](LICENSE) — use, modify, distribute. If you run a modified version as a service, share the source.