Docs

Calling it

This is your own data, so a call has to say who you are. Make a token at /token and send it as a header.

curl -H "Authorization: Bearer $MU_TOKEN" \
  https://micro.mu/api/v1/docs/list

The same method over MCP, which is what an agent speaks: docs_list. The answer is identical.

How every call behaves →

Methods

POST /api/v1/docs/delete

Delete one of your documents, by id

Needs an account. Changes something, so POST only. Withheld from the agent — a person or a program only.

Argument	Type	Description
`id` *	string	Document id, from docs_list

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"id"}' \
  https://micro.mu/api/v1/docs/delete

id *

POST /api/v1/docs/list

List your documents, most recently changed first, with an optional search over titles and bodies. Use this to find an id

Private search terms belong in a POST body. Needs an account.

Argument	Type	Description
`query`	string	Optional text to match against titles and bodies
`limit`	number	Maximum documents to return (default 50)

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}' \
  https://micro.mu/api/v1/docs/list

querylimit

GET /api/v1/docs/read

Read one of your documents in full, by id or by exact title

Needs an account.

Argument	Type	Description
`id`	string	Document id, from docs_list
`title`	string	Exact title, if you do not have the id

curl \
  -H "Authorization: Bearer $MU_TOKEN" \
  "https://micro.mu/api/v1/docs/read"

idtitle

POST /api/v1/docs/write

Write a document — a title and a markdown body. Pass an id to replace one you already have. Private unless you set public. For something long enough to re-read; for a short thing to remember, use notes

Needs an account. Changes something, so POST only.

Argument	Type	Description
`title` *	string	The document's title
`content` *	string	The document's body, as markdown
`id`	string	Existing document id to replace. Omit to create a new one
`public`	boolean	Readable by anyone when true. Private by default

curl -X POST \
  -H "Authorization: Bearer $MU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"content":"content","title":"title"}' \
  https://micro.mu/api/v1/docs/write

title *content *idpublic

The same methods are tools over MCP, and every service on this instance is in one reference.