MCP

Ask this instance's agent a question in natural language and get a written answer. It has every tool you do and will use several to answer, so reach for it to delegate a whole task — for one fact call that tool directly, and for a question about content this instance already holds use chat_ask, which answers from the index without tool calls.

Draws 7 credits from your balance per call.

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

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.

Draws 15 credits from your balance per call.

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

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

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

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

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

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

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

Read details of a specific app by its slug

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

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

Draws 7 credits from your balance per call.

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

Search the apps directory for small, useful tools

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

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

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

Block a user — hides all their content from your view

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

Publish a post to the caller's blog. Use for anything meant to be read later by other people — notes, write-ups, announcements. Returns the post and its URL. For a private note to yourself, prefer files or memory.

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

Delete one of the caller's own blog posts, by id or title. Refuses posts written by anyone else. Irreversible, so confirm with the user first.

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

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"}}

Read one blog post in full, by id or by title. Use after blog_list or blog_search has found a candidate and the summary is not enough. Returns the whole body, the author and when it was published.

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

Update an existing blog post (author only)

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

Ask a question answered from what this instance has already indexed — its news, blog posts and saved content — in one grounded model call. It calls no tools, so it is cheap and fast but can only answer from what is here already; for anything needing live lookups or several steps, use agent_ask.

Draws 5 credits from your balance per call.

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

Read the recent conversation in a discussion room

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

List discussion rooms that currently have activity

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

Save someone to your address book. Adding a name already there updates it rather than making a second card.

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

Remove someone from your address book.

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

Look someone up in your address book by name, part of a name, or address. Use this before sending mail to a person named rather than addressed.

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

List everyone in your address book.

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

Report a post, comment or message for a human moderator to look at. Takes the item id and a reason. Does not remove anything itself — use dismiss to hide something from your own view.

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

Hide an item so the caller stops seeing it, by id. Affects only this account's view; use flag to report something to a moderator instead.

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

Save an item to the caller's bookmarks so it can be found again. Takes the item id. Private to the caller, and reversible with unsave.

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

Remove an item from the caller's bookmarks, by id. Leaves the item itself untouched — this only forgets that it was saved.

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

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.

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

Delete a record you own by id.

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

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

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

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

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

Schedule a reminder or event. Pass repeat for something recurring, and prompt to have the agent do the work when it fires and mail you the answer — that is how a standing instruction like a morning briefing is set up.

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

Cancel a scheduled event or reminder by id. Use events_list to find the id.

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

Find when you have nothing booked. Give it how long you need and it returns the open slots, within working hours.

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

List your upcoming scheduled events and reminders, soonest first.

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

Delete a file you own, and its contents.

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

Read a stored file back by its id. Text comes back as text, anything else as base64.

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

List your stored files, newest first, with their URLs and ids.

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

Store a file and get a URL for it. Use it to keep something you produced — a report, a CSV, a transcript — and hand back a link.

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

Make a stored file readable by anyone holding its URL, or private again.

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

Generate an image from a text prompt. Returns a URL to the generated image.

Draws 15 credits from your balance per call.

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

Search the public image library (community stock) by description. Returns image URLs to reuse.

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

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.

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

Get an email address that reaches you. Pass a tag to get your own address (you+tag@) — give that out, then read only its mail with mail_inbox(tag).

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

Read your mail inbox. Pass a tag to read only mail sent to that plus-address (you+tag@), which is how an agent reads its own mail rather than all of yours.

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

Search the account's mail and return matching messages

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

Send an email from the caller's own address on this instance. Takes a recipient address, a subject and a body; resolve a name to an address with contacts_find first. Requires an account, and the mail really is delivered — there is no draft state to undo from.

Draws 4 credits from your balance per call.

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

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

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

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.

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

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

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

Search aggregated news headlines by keyword and return matching articles with source and time. Use when the question is about a specific topic; use news_list for what is happening generally, and news_read for the full text of one article.

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

How long it takes to travel between two places, by road rather than as the crow flies. Use it to answer whether somewhere is worth going to, or when to leave.

Draws 3 credits from your balance per call.

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

Resolve a place name or address to coordinates

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

Find all places of interest near a given location

Draws 4 credits from your balance per call.

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

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

Draws 5 credits from your balance per call.

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

Get the qibla direction (compass bearing to the Kaaba in Mecca) for a location, and the distance to Mecca.

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

Get today's Islamic reflection: a verse of the Quran, a saying of the Prophet, and a name of Allah

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

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

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

Get today's Islamic prayer times (Fajr, Dhuhr, Asr, Maghrib, Isha) for a location, and which prayer is next.

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

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

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

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

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

List the items you've saved for later (bookmarks), with their links.

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

Get the latest social posts from the network.

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

Search public posts on this instance by keyword. Returns matching posts with their author and time. This is the instance's own social feed, not the wider internet — use web_search for that.

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

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_list"}}

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

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

Add a task to your list. Set assignee to "agent" for work the agent should pick up itself.

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

Remove a task from your list.

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

List your tasks, open ones first. Filter by state to see only what is outstanding.

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

The next task assigned to the agent — what to work on now. Returns nothing when there is nothing assigned.

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

Change a task: mark it doing or done, and record what came of it. Record the result — a task with no result is work nobody can check.

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

Stop blocking another account, so their posts and messages reach the caller again. Takes their username. Reverses block_user.

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

Get the latest videos from curated channels.

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

Search videos from the channels this instance curates, by keyword. Returns titles, channels and links. A curated set rather than all of YouTube, so a miss means it is not followed here, not that it does not exist.

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

Get your credit balance — credits are what calls are charged in.

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

Deduct the cost of an operation from the caller's credit balance

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

Check whether the caller can afford an operation, without charging

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

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

Draws 1 credit from your balance per call.

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

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

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

Search the web for current information and news

Draws 2 credits from your balance per call.

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