Bearletter Docs
What a Bearletter blog is made of, and how people and agents work with it.
A Bearletter blog is a folder of plain text: Markdown articles and pages with a few properties at the top, some site files for the menu and footer, a handful of components, and one stylesheet. People edit it in the dashboard; scripts and AI agents can read and change the same files.
Set up with your agentYour agent reads these docs, adds Bearletter and checks the connection. You approve it in the browser.
Claude CodeCodexOpenCodeCursorClaudeChatGPT
Show prompt
Set up Bearletter for me and help me work on my blog. 1. Read https://docs.bearletter.com/llms.txt, then open only the pages you need. Every page is Markdown. 2. Know the blog's rules before writing: the site files have fixed names (home.md, nav.md, directories.md, redirects.md, social.md, blogroll.md, footer.md, post-header.md, post-footer.md, post-aside.md, styles.css, podcast.md) that you never rename or add to; only files under posts/ and pages/ are yours to name. 3. Add the Bearletter MCP server to your own configuration: a remote (HTTP) server named bearletter at https://api.bearletter.com/mcp. Use your own way of adding MCP servers (a command or your config file). If you cannot change your own settings, tell me exactly where I add it. There is no key to copy. 4. If you take skills, also install the Bearletter skill: https://docs.bearletter.com/skills/bearletter/SKILL.md (how: https://docs.bearletter.com/mcp/skills.md). 5. When you first use the server, it opens a Bearletter page in my browser. I will sign in and approve it. 6. Check the connection by calling get_blog, and tell me my blog's title and address. 7. From then on, read before you change anything, tell me what you will change, and wait for my yes before saving anything that goes public. If a save is refused, fix the lines it names and try again.
Read these docs as an agent#
- llms.txt lists every page with its Markdown address and a one-line summary. Start there and open only what you need.
- Every page is also Markdown: add
.mdto its address, or sendAccept: text/markdown. - llms-full.txt holds all pages in one file.
Pages#
Agents (MCP)
- Connect an agent: Add Bearletter as a remote MCP server, approve it in the browser, and check that it works.
- Tools: Every MCP tool by area, what it does and the permission it needs.
- Skills and plugins: The Bearletter skill and plugin, which add the MCP server and teach your agent how Bearletter works.
Blog format
- The blog folder: Which files a blog has, where posts, pages and episodes go, and how a path becomes an address.
- Properties: The key: value block at the top of a file, and every property each file accepts.
- Components: The lines that start with :: and what each one shows.
- Themes: How styles.css is laid out, the variables themes share, light and dark modes, and the page's class names.
- Podcast: The podcast (Pro): podcast.md for the show and one file per episode in podcast/, with every property.
API
Bearletter · bearletter.com · Every page is also Markdown: llms.txt