BearletterDocsllms.txtbearletter.comDashboard

Agents (MCP)

Tools

Every MCP tool by area, what it does and the permission it needs.

Each tool does one thing and runs as you, with the same checks, plans and limits as the dashboard. A tool that needs a permission the agent was not given asks for it.

Tools that read are marked read-only; tools that change something public are marked so agents can ask you first.

Docs and blog#

ToolDoesPermission
get_blog_guideReads these docs: the index, or a page by its path.none
get_blogThe blog's title, address, time zone and plan.read
update_blog_settingsLanguage, time zone, visit counts, AI training, address.blog

Blog files#

The site files have fixed names; only files under posts/, pages/ and podcast/ are created, renamed or moved. See The blog folder.

ToolDoesPermission
list_blog_filesFiles in the folder; kind is post, page, episode or site.read
read_blog_fileOne file with its content, its unpublished changes and writeSeq.read
save_blog_fileCreates or replaces a file as readers see it.write; blog for site files
move_blog_fileRenames or moves a post, page or episode; a public post or page keeps its old address.write
delete_blog_fileDeletes a file with its revisions.write; blog for site files

Write#

A draft is a post, page or episode with publish: false. Editing a published file keeps what readers see and stores the edit as unpublished changes until it is published.

ToolDoesPermission
create_draftA new private draft: a post, a page or a podcast episode.write
save_draftSaves a draft, or a published file's unpublished changes.write
preview_fileA 30-minute link showing a file with its changes as it would look.read
publish_filePublishes a draft or a file's unpublished changes, now or at a time.write
unpublish_fileTakes a published or scheduled file back to a draft.write
discard_changesDrops a published file's unpublished changes.write

Look#

ToolDoesPermission
list_themesThe built-in themes and the current appearance.read
preview_stylesA 30-minute link showing the blog with a theme or a new stylesheet.read
apply_themeReplaces styles.css with a built-in theme.blog
set_appearanceAccent color, text width, font, size.blog

Media#

Files never pass through the tools: they are downloaded from their public address and uploaded straight to storage.

ToolDoesPermission
list_mediaFiles with their public address and how often they are used.read
start_media_uploadReserves a file and returns an address to upload it to with HTTP PUT.media
finish_media_uploadChecks the uploaded file and adds it to the library.media

Subscribers and stats#

ToolDoesPermission
list_subscribersSubscribers and counts, 50 at a time.subscribers
export_subscribersThe list as CSV.subscribers
add_subscriberAdds one address, as you would by hand.subscribers
get_blog_statsVisits by day, top posts and referrers.read

How tools behave#

Bearletter · bearletter.com · Every page is also Markdown: llms.txt