API

REST API for programmatic access to Mu.

Authentication: Authorization: Bearer YOUR_TOKEN — Get a token | MCP Server

Playground

Pick an endpoint, fill in parameters, and send the request.

curl command

Response

GET /chat

Get Chat Info — Get available chat topics and summaries

Response: JSON

Field	Type	Description
topics	array	Available chat topics/categories
summaries	object	Topic summaries and context information

POST /chat

Chat — Chat with AI

Param	Type	Description
context	array	Past messages to use as context; [{'prompt': xxx, 'answer': xxx}]
prompt	string	Prompt to send the AI

Response: JSON

Field	Type	Description
answer	string	The response from the AI

GET /news

News — Read the news

Response: JSON

Field	Type	Description
feed	array	The news feed

POST /news

News Search — Search for news articles

Param	Type	Description
query	string	News search query

Response: JSON

Field	Type	Description
query	string	The search query
results	array	Array of news article objects with id, title, description, url, category, image, published
count	number	Number of results returned

GET /blog/post/{id}

Get Post — Get a single blog post by ID

Response: JSON

Field	Type	Description
id	string	Post ID
title	string	Post title
content	string	Post content (raw markdown)
author	string	Author name
author_id	string	Author ID
created_at	string	Post creation timestamp

PATCH /blog/post/{id}

Update Post — Update an existing blog post (author only)

Param	Type	Description
title	string	Post title (optional)
content	string	Post content (minimum 50 characters)

Response: JSON

Field	Type	Description
success	boolean	Whether the post was updated successfully
id	string	The ID of the updated post

POST /blog/post

Create Post — Create a new blog post

Param	Type	Description
title	string	Post title (optional)
content	string	Post content (minimum 50 characters)

Response: JSON

Field	Type	Description
success	boolean	Whether the post was created successfully
id	string	The ID of the created post

GET /blog

Blog — Get all blog posts

Response: JSON

Field	Type	Description
posts	array	Array of post objects

GET /video

Video — Latest videos

Response: JSON

Field	Type	Description
channels	array	Latest videos

POST /video

Video Search — Search for videos

Param	Type	Description
query	string	Video search query

Response: JSON

Field	Type	Description
results	array	Video search results
html	string	Pre-rendered html string of results

GET /token

List Tokens — List all Personal Access Tokens for authenticated user

Response: JSON

Field	Type	Description
tokens	array	Array of token objects with id, name, created, last_used, expires_at, permissions

POST /token

Create Token — Create a new Personal Access Token for API automation

Param	Type	Description
name	string	Token name/description
permissions	array	Permissions array (e.g., ['read', 'write']). Default: ['read', 'write']
expires_in	number	Expiration in days (0 = never expires). Default: 0

Response: JSON

Field	Type	Description
success	boolean	Whether token was created
id	string	Token ID
token	string	The actual token (SAVE IT - shown only once!)
name	string	Token name
created	string	Creation timestamp
expires_at	string	Expiration timestamp (if set)
permissions	array	Token permissions

DELETE /token/{id}

Delete Token — Delete a Personal Access Token

Response: JSON

Field	Type	Description
success	boolean	Whether token was deleted
message	string	Success message

DELETE /blog/post/{id}

Delete Post — Delete a blog post (author only)

Response: JSON

Field	Type	Description
success	boolean	Whether the post was deleted

GET /@{username}

User Profile — Get user profile and their posts

Response: HTML

Field	Type	Description
html	string	Rendered user profile page

POST /@{username}

Update User Status — Update user status message (own profile only)

Param	Type	Description
status	string	Status message (max 100 characters)

Response: Redirect

Field	Type	Description
location	string	Redirects to user profile

POST /blog/post/{id}/comment

Add Comment — Add a comment to a blog post

Param	Type	Description
content	string	Comment content (minimum 10 characters)

Response: Redirect

Field	Type	Description
location	string	Redirects back to the post

GET /search

Search Data — Search across all indexed content (posts, news, videos)

Param	Type	Description
q	string	Search query

Response: JSON

Field	Type	Description
results	array	Search results with type, id, title, content, score

POST /admin/flag

Flag Content — Flag inappropriate content

Param	Type	Description
type	string	Content type (post, comment)
id	string	Content ID

Response: JSON

Field	Type	Description
success	boolean	Whether the flag was recorded
count	number	Total flag count

GET /session

Session Status — Check authentication status (returns guest session if not authenticated)

Response: JSON

Field	Type	Description
type	string	Session type (account, token, anonymous)
account	string	Account username if authenticated

GET /wallet?balance=1

Wallet Balance — Get wallet credit balance

Response: JSON

Field	Type	Description
balance	number	Current credit balance (1 credit = 1p)

GET /wallet/topup

Wallet Topup — Get available wallet topup payment methods. Returns card (Stripe) preset tiers with amount, credits, and label. Requires authentication.

Response: JSON

Field	Type	Description
methods	array	Array of payment method objects. Each has a type (card) and tiers with amount, credits, and label.

GET /markets

Markets — Get live market prices for cryptocurrencies, futures, and commodities

Param	Type	Description
category	string	Category: crypto, futures, or commodities (default: crypto)

Response: JSON

Field	Type	Description
category	string	The requested category
data	array	Array of market items with symbol, price, type

GET /weather

Weather Forecast — Get the weather forecast for a location by latitude and longitude. Costs 1 credit.

Param	Type	Description
lat	number	Latitude of the location
lon	number	Longitude of the location
pollen	string	Set to 1 to include pollen forecast (+1 credit)

Response: JSON

Field	Type	Description
forecast	object	Weather forecast with current conditions, hourly and daily items
pollen	array	Pollen forecast by date (if requested)

POST /places/search

Places Search — Search for places by name or category, optionally near a location

Param	Type	Description
q	string	Search query (e.g. cafe, pharmacy, Boots)
near	string	Location name or address to search near (optional)
near_lat	number	Latitude of the search location (optional)
near_lon	number	Longitude of the search location (optional)
radius	number	Search radius in metres, 100–5000 (default 1000)

Response: JSON

Field	Type	Description
results	array	Array of place objects with id, name, category, address, lat, lon, phone, website, opening_hours, cuisine, distance
count	number	Number of results returned

POST /places/nearby

Places Nearby — Find all places of interest near a given location

Param	Type	Description
address	string	Address or postcode to search near (optional if lat/lon provided)
lat	number	Latitude of the search location
lon	number	Longitude of the search location
radius	number	Search radius in metres, 100–5000 (default 500)

Response: JSON

Field	Type	Description
results	array	Array of place objects sorted by distance
count	number	Number of results returned
lat	number	Resolved latitude
lon	number	Resolved longitude
radius	number	Search radius used

GET /web

Web Search — Search the web using Brave Search. Requires authentication. Costs credits per query.

Param	Type	Description
q	string	Search query

Response: JSON

Field	Type	Description
results	array	Array of web result objects with title, url, description, age
query	string	The search query

POST /agent

Agent Query — Query the AI agent. The agent plans and executes tool calls (news, weather, places, markets, etc.) then synthesizes a response. Requires authentication. Costs credits per query. Returns a Server-Sent Events stream.

Param	Type	Description
prompt	string	The question or request for the agent
model	string	Model tier: standard (default) or premium

Response: text/event-stream

Field	Type	Description
type	string	Event type: thinking, tool_start, tool_done, response, error, done
message	string	Human-readable status message
html	string	Rendered HTML answer (on response event)

POST /mcp

MCP Server — Model Context Protocol server for AI tool integration. Supports initialize, tools/list, tools/call, and ping methods. Tools include chat, news, blog, video, mail, search, wallet, weather, places, markets, reminder, login, and signup. Metered tools (chat: 5 credits, news_search: 1 credit, video_search: 2 credits, mail_send: 4 credits, weather_forecast: 1 credit + optional 1 credit for pollen data) use the same wallet credit system as the REST API. Pay per call via x402 or top up your account to pay with credits.

Param	Type	Description
jsonrpc	string	JSON-RPC version (must be '2.0')
id	number	Request ID
method	string	MCP method: initialize, tools/list, tools/call, ping
params	object	Method parameters (e.g. {name, arguments} for tools/call)

Response: JSON

Field	Type	Description
jsonrpc	string	JSON-RPC version '2.0'
id	number	Request ID echoed back
result	object	Method result (tools list, tool output, server info)
error	object	Error object with code and message (if failed)