MCP

Model Context Protocol

Connect AI clients (e.g. Claude Desktop) to this MCP server.

Endpoint: /mcp — API Docs

Authentication

Two ways to call, the same as the REST API:

Pay per call (x402) — no login. Call a metered tool with no auth and you get an HTTP 402 with the price and pay-to address; your x402 wallet pays in USDC and retries. Your first calls per wallet are free.
Token & credits — log in and pass a token; metered calls draw from your credit balance:
```
Authorization: Bearer YOUR_TOKEN
```
Create a Personal Access Token, or call the signup / login tool to get one programmatically.

Non-metered tools are free to call. A few tools that touch your account (wallet, mail, editing your apps) always need a logged-in session.

Playground

Pick a tool, fill in parameters, and run it.

Response

Raw JSON-RPC

Payments

Metered tools are pay-per-call. Two ways to pay:

x402 — agents pay per call in USDC on Base. Call a metered tool with no auth and you get an HTTP 402 whose body lists the price and pay-to address; pay and retry. No account needed.
Credits — log in with a token and calls draw from your credit balance instead.

Prices are shown per tool below.

Get the current authenticated user's identity, account ID, and admin status

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"me"}}

$0.05 / callchat

Chat with AI assistant

Pay per call with x402, or use credits when logged in.

Param	Type	Description
prompt *	string	The message to send to the AI

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"prompt":"prompt"},"name":"chat"}}

news

Read the latest news feed

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"news"}}

$0.01 / callnews_search

Search for news articles

Pay per call with x402, or use credits when logged in.

Param	Type	Description
query *	string	News search query

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"query":"query"},"name":"news_search"}}

blog_read

Read a specific blog post by ID

Param	Type	Description
id *	string	The blog post ID

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id"},"name":"blog_read"}}

$0.01 / callblog_create

Create a new blog post

Pay per call with x402, or use credits when logged in.

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

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"content":"content"},"name":"blog_create"}}

blog_update

Update an existing blog post (author only)

Param	Type	Description
id *	string	The blog post ID to update
title	string	New post title
content	string	New post content (minimum 50 characters)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id"},"name":"blog_update"}}

blog_delete

Delete a blog post (author only)

Param	Type	Description
id *	string	The blog post ID to delete

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id"},"name":"blog_delete"}}

$0.01 / callsocial_search

Search social media posts

Pay per call with x402, or use credits when logged in.

Param	Type	Description
query *	string	Search query for social posts

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"query":"query"},"name":"social_search"}}

$0.02 / callvideo_search

Search for videos

Pay per call with x402, or use credits when logged in.

Param	Type	Description
query *	string	Video search query

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"query":"query"},"name":"video_search"}}

mail_read

Read mail inbox

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"mail_read"}}

$0.04 / callmail_send

Send a mail message

Pay per call with x402, or use credits when logged in.

Param	Type	Description
to *	string	Recipient username or email
subject *	string	Message subject
body *	string	Message body

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"body":"body","subject":"subject","to":"to"},"name":"mail_send"}}

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

Param	Type	Description
q *	string	Search query

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"q":"q"},"name":"search"}}

wallet_balance

Get wallet credit balance

Param	Type	Description
balance	string	Set to 1 to get balance

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"wallet_balance"}}

wallet_transfer

Transfer credits to another user by username

Param	Type	Description
to *	string	Recipient username
amount *	number	Number of credits to transfer

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"amount":1,"to":"to"},"name":"wallet_transfer"}}

wallet_topup

Get available wallet topup payment methods with crypto deposit address and card payment tiers

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"wallet_topup"}}

stream

Read the platform event stream — user messages, agent responses, system events (markets, news, reminders)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"stream"}}

$0.01 / callstream_post

Post a message to the stream. Mention @micro to get an AI response. Costs 1 credit.

Pay per call with x402, or use credits when logged in.

Param	Type	Description
content *	string	Message text (max 1024 chars). Use @micro to invoke the AI agent.

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"content":"content"},"name":"stream_post"}}

flag

Flag content for moderation

Param	Type	Description
type *	string	Content type (e.g. post, work, app)
id *	string	Content ID

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id","type":"type"},"name":"flag"}}

save

Bookmark content for later

Param	Type	Description
type *	string	Content type (e.g. post, work, app)
id *	string	Content ID

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id","type":"type"},"name":"save"}}

unsave

Remove a saved bookmark

Param	Type	Description
type *	string	Content type
id *	string	Content ID

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id","type":"type"},"name":"unsave"}}

dismiss

Hide content from your view

Param	Type	Description
type *	string	Content type
id *	string	Content ID

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id","type":"type"},"name":"dismiss"}}

block_user

Block a user — hides all their content from your view

Param	Type	Description
user *	string	User ID to block

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"user":"user"},"name":"block_user"}}

unblock_user

Unblock a previously blocked user

Param	Type	Description
user *	string	User ID to unblock

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"user":"user"},"name":"unblock_user"}}

$0.05 / callplaces_search

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

Pay per call with x402, or use credits when logged in.

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

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"q":"q"},"name":"places_search"}}

$0.02 / callplaces_nearby

Find all places of interest near a given location

Pay per call with x402, or use credits when logged in.

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

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"places_nearby"}}

reminder

Get today's daily Islamic reminder with verse, hadith, and name of Allah

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"reminder"}}

quran

Look up a Quran chapter or verse. Pass chapter number (1-114) and optionally a verse number.

Param	Type	Description
chapter *	number	Chapter number (1-114)
verse	number	Verse number (optional, returns full chapter if omitted)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"chapter":1},"name":"quran"}}

hadith

Look up hadith from Sahih Al Bukhari. Pass a book number to get hadiths from that book.

Param	Type	Description
book	number	Book number

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"hadith"}}

$0.01 / callquran_search

Search the Quran, Hadith, and names of Allah using semantic search. Ask a question in natural language.

Pay per call with x402, or use credits when logged in.

Param	Type	Description
q *	string	Question or search query

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"q":"q"},"name":"quran_search"}}

signup

Create a new account and return a session token. When invite-only mode is enabled, a valid invite code is required.

Param	Type	Description
id *	string	Username (4-24 chars, lowercase, starts with letter)
secret *	string	Password (minimum 6 characters)
name	string	Display name (optional, defaults to username)
invite	string	Invite code (required when instance is invite-only)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id","secret":"secret"},"name":"signup"}}

Param	Type	Description
id *	string	Username
secret *	string	Password

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id","secret":"secret"},"name":"login"}}

$0.05 / callweb_search

Search the web for current information and news

Pay per call with x402, or use credits when logged in.

Param	Type	Description
q *	string	Search query

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"q":"q"},"name":"web_search"}}

$0.03 / callweb_fetch

Fetch a web page and return its cleaned readable content (strips ads, popups, navigation)

Pay per call with x402, or use credits when logged in.

Param	Type	Description
url *	string	The URL to fetch

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"url":"url"},"name":"web_fetch"}}

news_headlines

Get recent news headlines with short summaries balanced across all topics (not dominated by one topic like crypto). Use for general news and briefing requests, then news_read for any article worth expanding.

Param	Type	Description
topic	string	Optional topic/category filter (e.g. tech, world, business)
limit	string	Optional max number of headlines (default 30)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"news_headlines"}}

news_read

Read one news article in full (title, source, summary and body) by its id from news_headlines, or by article URL.

Param	Type	Description
id *	string	Article id (from news_headlines) or article URL

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"id":"id"},"name":"news_read"}}

recall

Search across everything mu knows — indexed news, blog, social and video, plus the user's own mail — and return the most relevant items with ids. Use for 'do you remember', 'what did I get about X', 'search my stuff' and cross-source lookups.

Param	Type	Description
query *	string	What to look for
limit	string	Optional max results (default 12)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"query":"query"},"name":"recall"}}

$0.01 / calldb_set

Store a record in your database (a named collection). Private by default; set public=true to share it. Pass an id to update a record you own.

Pay per call with x402, or use credits when logged in.

Param	Type	Description
collection *	string	Collection name (e.g. notes, tasks)
data *	object	The record's fields as a JSON object
public	boolean	Share the record publicly (default false)
id	string	Existing record id to update (optional)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"collection":"collection","data":"data"},"name":"db_set"}}

db_get

Get one record by id from a collection (must be yours, or public).

Param	Type	Description
collection *	string	Collection name
id *	string	Record id

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"collection":"collection","id":"id"},"name":"db_get"}}

db_list

List records in a collection. scope: 'mine' (default), 'public', or 'all' (mine + public). Optional where filter, sort field and limit.

Param	Type	Description
collection *	string	Collection name
scope	string	mine \| public \| all (default mine)
where	object	Filter on data fields, e.g. {"done":false,"priority":{"gte":2}}
sort	string	Data field to sort by
order	string	asc \| desc (default desc)
limit	number	Max records (default 50, max 200)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"collection":"collection"},"name":"db_list"}}

db_del

Delete a record you own by id.

Param	Type	Description
collection *	string	Collection name
id *	string	Record id

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"collection":"collection","id":"id"},"name":"db_del"}}

markets

Get live market prices for cryptocurrencies, futures, commodities and currencies.

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

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"markets"}}

$0.01 / callweather_forecast

Get the weather forecast for a location (current conditions plus the next few days).

Pay per call with x402, or use credits when logged in.

Param	Type	Description
lat *	number	Latitude of the location
lon *	number	Longitude of the location

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"lat":1,"lon":1},"name":"weather_forecast"}}

social

Get the latest social posts from the network.

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"social"}}

video

Get the latest videos from curated channels.

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"video"}}

blog_list

Get recent blog posts (titles, snippets and ids; use blog_read for one in full).

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"blog_list"}}

apps_search

Search the apps directory for small, useful tools

Param	Type	Description
q	string	Search query (name, description, or tag)
tag	string	Filter by tag

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"apps_search"}}

apps_read

Read details of a specific app by its slug

Param	Type	Description
slug *	string	The app's URL slug (e.g. pomodoro-timer)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"slug":"slug"},"name":"apps_read"}}

apps_create

Create a new app — a small, self-contained HTML tool hosted on Mu

Param	Type	Description
name *	string	App name (e.g. Pomodoro Timer)
slug *	string	URL-friendly ID (e.g. pomodoro-timer)
description *	string	Short description of what the app does
tags	string	Comma-separated tags (optional)
html *	string	The app's HTML content (can include inline CSS and JavaScript, max 256KB)
price	number	Credits charged per use (0 = free, max 1000)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"description":"description","html":"html","name":"name","slug":"slug"},"name":"apps_create"}}

apps_edit

Edit an existing app you own — update its name, description, tags, icon, HTML code, or price

Param	Type	Description
slug *	string	The app's URL slug (e.g. pomodoro-timer)
name	string	New app name
description	string	New description
tags	string	New comma-separated tags
html	string	New HTML content (max 256KB)
icon	string	New SVG icon
price	number	Credits charged per use (0 = free, max 1000)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"slug":"slug"},"name":"apps_edit"}}

$1.00 / callapps_build

Build a small app from a natural language description, save it, and return the app details with URL. Apps are one of: a tracker (a list you add entries to, optionally totalling a number), a checklist, or a counter.

Pay per call with x402, or use credits when logged in.

Param	Type	Description
prompt *	string	Description of the app to build (e.g. 'an expense tracker', 'a packing checklist', 'a water intake counter')

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"prompt":"prompt"},"name":"apps_build"}}

apps_fork

Fork an existing app — creates a copy under your account that you can modify independently

Param	Type	Description
slug *	string	Slug of the app to fork
new_slug	string	Slug for the forked copy (optional, auto-generated if empty)

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"slug":"slug"},"name":"apps_fork"}}

$0.03 / callapps_run

Run JavaScript code in a sandboxed environment and return the result. Use for calculations, data processing, or any computation the user needs.

Pay per call with x402, or use credits when logged in.

Param	Type	Description
code *	string	JavaScript code to execute. The code runs as a function body — use 'return' to output a value. Has access to mu.ai(), mu.web.fetch(), mu.db and mu.store for platform features.

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"code":"code"},"name":"apps_run"}}

apps_test

Test an app by checking its HTML structure and executing its mu.api calls server-side. Returns which API calls work and which fail.

Param	Type	Description
slug *	string	The app's URL slug

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"slug":"slug"},"name":"apps_test"}}

$0.03 / callagent

Ask the AI agent a question. The agent can search news, markets, web, video, weather, places, and more to answer your question.

Pay per call with x402, or use credits when logged in.

Param	Type	Description
prompt *	string	Your question or request

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"prompt":"prompt"},"name":"agent"}}

wallet

Get your Base wallet address and USDC balance. This wallet pays for metered MCP tools via x402.

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{},"name":"wallet"}}

pay

Call a metered tool on an MCP server and pay for it from your Base wallet via x402. Works on this server and any other server in the registry.

Param	Type	Description
tool *	string	Name of the tool to call
server	string	Server name from the registry, or a base URL (default: self)
arguments	object	Arguments to pass to the tool

{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"tool":"tool"},"name":"pay"}}