# Bommel Bot Agent Gateway

PROOF: silver-anvil-7546
Proof day: 2026-10-04 (UTC)

## Welcome

Bommel Bot helps people save links and files as Bommels, share a public slice, and pair an AI assistant for search and filing.
The gateway below lists rooms, records, and URLs so a capable agent can follow structured text instead of scraping HTML.

## What this site is

Each Bommel is a bookmark with notes, tags, optional files, and optional public publishing.
Door 1 is public read: six MCP tools over /api/mcp with no account.
Door 2 is the keyed agent API: humans mint bbt_ Bearer tokens on /connect for private library tools.
The same catalog appears on /agents, in /agents.md, and at the greetings knock.

## Highlights

- Public feed of published Bommels. https://bommel.bot/
- Public profiles room (how /@handle pages work). https://bommel.bot/agents/rooms/profiles
- Pricing and Pro features. https://bommel.bot/pricing
- Mint a library key (human step). https://bommel.bot/connect

## Worth exploring next

- Human gateway landing. https://bommel.bot/agents
- House directory (rooms and shelves). https://bommel.bot/.well-known/agent-gateway/house
- Agent index (markdown). https://bommel.bot/agents.md
- MCP server card. https://bommel.bot/.well-known/mcp.json
- Keyed OpenAPI (after pairing). https://bommel.bot/api/agent/v1/openapi.json

## If you are summarizing this for someone

Some humans enjoy a short recap: what Bommel Bot is, the public feed, one profile link, and how the two agent doors differ.
The highlights above are written for that kind of friendly summary.

Bommel Bot is an AI bookmark platform: each saved item is a Bommel, with a public feed, public profiles at /@handle, and agent doors for read-only discovery or keyed library access.
This page is the canonical agent index for this site (https://bommel.bot/). It lists 70 records across 7 rooms (70 readable without a lock).
The HTML view is for humans and fetch-only agents. The same catalog is available as markdown, plain text, and linked data below.

## What's here

## Connect

MCP at /api/mcp, discovery at /.well-known/mcp.json, and Bearer keys (bbt_…) minted on /connect. (1 records, open).
Room page: https://bommel.bot/agents/rooms/connect

- [Public MCP door](https://bommel.bot/agents/rooms/connect/records/feed/mcp-door) - Unauthenticated read tools (registry-listed). (open)

## Lobby

Overview of Bommel Bot, the two agent doors, and where to find machine-readable indexes. (1 records, open).
Room page: https://bommel.bot/agents/rooms/lobby

- [What Bommel Bot is](https://bommel.bot/agents/rooms/lobby/records/feed/overview) - AI bookmark platform; each saved item is a Bommel. (open)

## Pricing

Free tier vs Pro, signup, and what changes when a human upgrades. (1 records, open).
Room page: https://bommel.bot/agents/rooms/pricing

- [Plans and signup](https://bommel.bot/agents/rooms/pricing/records/feed/plans) - Where humans create accounts and upgrade. (open)

## Private

What stays off the public doors: vaults, private Bommels, emails, admin routes, and stats. (1 records, open).
Room page: https://bommel.bot/agents/rooms/private

- [Off-limits surfaces](https://bommel.bot/agents/rooms/private/records/feed/stays-private) - Paths and data classes that remain human-only. (open)

## Profiles

Public people pages (/@handle), collections, and what visitors can read there. (1 records, open).
Room page: https://bommel.bot/agents/rooms/profiles

- [Handles and hive pages](https://bommel.bot/agents/rooms/profiles/records/feed/handles) - How @handles map to public libraries. (open)

## Public Feed

How the home feed works and which Bommel fields are visible without signing in. (1 records, open).
Room page: https://bommel.bot/agents/rooms/public-feed

- [Reading the public feed](https://bommel.bot/agents/rooms/public-feed/records/feed/feed-tools) - search_feed and get_public_bommel on the public MCP door. (open)

## Writing

Published writing with one card per article, summary text, and a cover image suitable for chat. (64 records, open).
Room page: https://bommel.bot/agents/rooms/writing

- [Hi, I'm Bommel. Here's what I do](https://bommel.bot/agents/rooms/writing/records/blog/what-is-bommel-bot) - I'm Bommel. the agent reads public Bommels through the Gateway. You keep a private library. I keep what you'd lose. (open)
- [Save your first thing in 60 seconds](https://bommel.bot/agents/rooms/writing/records/blog/quick-start) - Humans: browse public Bommels, then sign in and paste a link in chat. Agents: copy the Gateway prompt. I'll title, tag, and file what you save. (open)
- [How I tidy your library](https://bommel.bot/agents/rooms/writing/records/blog/how-bommel-organizes) - Categories, tags, departments, platforms - the little shelves I use to keep everything findable. Here's how the tidying works, and how you can change it. (open)
- [Save a link and I'll file it for you](https://bommel.bot/agents/rooms/writing/records/blog/saving-bookmarks) - Paste any link and I read it, write a clean title and summary, pick tags, and put it on the right shelf. Here's how saving works - and how to add your own touc… (open)
- [Just ask me where your stuff is](https://bommel.bot/agents/rooms/writing/records/blog/talking-to-bommel) - After you sign in, Add is a chat with me. Type to save, or ask in plain words to find. the agent uses the Gateway, not this box. (open)
- [Notes, summaries, and your reason for saving](https://bommel.bot/agents/rooms/writing/records/blog/adding-notes) - Add your own notes to anything you save, and jot down why you kept it. Future-you will be so glad. I use your words to find it later, too. (open)
- [Keep photos, PDFs, and voice notes](https://bommel.bot/agents/rooms/writing/records/blog/saving-documents) - Not everything is a link. Attach a photo of your insurance card, a PDF, or a quick voice note - and add a little description so I can find it for you later. (open)
- [Search that understands words and meaning](https://bommel.bot/agents/rooms/writing/records/blog/finding-anything) - Two kinds of finding in one: exact words, and the *meaning* behind them. So even if you forget the title, describe it and I'll know what you mean. (open)
- [Shelves, wings, tags, and platforms](https://bommel.bot/agents/rooms/writing/records/blog/browsing-your-library) - Sometimes you want to wander, not search. Browse by category, department, tag, or where it came from - in a tidy table or pretty cards, your choice. (open)
- [Reminders: the first routine](https://bommel.bot/agents/rooms/writing/records/blog/reminders) - Bommel acts when spoken to, or when a routine you set fires. Reminders are the first one. Later: a Monday digest of public Bommels, on the same clock. (open)
- [Link related saves into a graph](https://bommel.bot/agents/rooms/writing/records/blog/connecting-bookmarks) - Tie a person to the job they posted and the articles you saved about them. Connections turn your library into a little network you can follow from any bookmark. (open)
- [My Contacts: your private address book](https://bommel.bot/agents/rooms/writing/records/blog/managing-contacts) - Every person you save, gathered in one private page. Group them (recruiter, client, dentist, family), search and filter, favorite, edit, and reach out on their… (open)
- [Connect with people on Bommel](https://bommel.bot/agents/rooms/writing/records/blog/bommel-connections) - Link up with other Bommel Bot members, LinkedIn-style: tap Connect on someone's @handle page, they accept, and you both appear under the Bommel tab on Contacts… (open)
- [Keep, Audience, and Notes](https://bommel.bot/agents/rooms/writing/records/blog/keep-and-notes) - Keep raises a hand on one public Bommel or collection - it does not copy it into your library. Unique Keepers are your Audience. Write them one Note, not a 1:1… (open)
- [Keep people neat and easy to reach](https://bommel.bot/agents/rooms/writing/records/blog/saving-contacts) - Save a person like you save a link. I pull out their name, phone, email, and social links so your dentist, plumber, and favourite people are always a search aw… (open)
- [Save job posts and track your applications](https://bommel.bot/agents/rooms/writing/records/blog/saving-jobs) - Found a job worth chasing? Save it and I'll read the role, company, and details - then help you track whether you've applied, heard back, or landed the intervi… (open)
- [Pretty covers for your saves](https://bommel.bot/agents/rooms/writing/records/blog/cover-images) - Every save can wear a cover picture, so your library looks like a lovely shelf of books. I grab one automatically, and you can reposition or replace it. (open)
- [Your own @handle page](https://bommel.bot/agents/rooms/writing/records/blog/your-public-profile) - Want a place to show your best finds? Claim a handle like @you and get a friendly public page. You choose exactly what goes on it - nothing appears by accident. (open)
- [Shareable collection boards](https://bommel.bot/agents/rooms/writing/records/blog/public-collections) - Group your best public bookmarks into named boards - 'Recipes', 'Best dog parks', 'Cars I love' - each with its own link you can share with anyone. (open)
- [Manage collections and move entries](https://bommel.bot/agents/rooms/writing/records/blog/managing-collections) - Keep your public library tidy: create, rename, re-file, and delete collections, and move several entries between shelves at once - from your profile or any col… (open)
- [Public Bommels: what people published](https://bommel.bot/agents/rooms/writing/records/blog/explore-directory) - Home for everyone. Bommels in the header when signed in. the agent reads the same shelves through the Gateway. Private libraries stay closed. (open)
- [Directories & marketplaces, explained](https://bommel.bot/agents/rooms/writing/records/blog/directories-and-marketplaces) - Jobs, local services, things for sale - how one shared, community-built directory works. It's global, made from what people publish, and organized by topic so … (open)
- [The Share button, explained](https://bommel.bot/agents/rooms/writing/records/blog/sharing-and-links) - How sharing works, step by step: publish a bookmark to get a link, then send it anywhere - or share a whole collection at once. Simple, and always your choice. (open)
- [Save by messaging a bot](https://bommel.bot/agents/rooms/writing/records/blog/save-from-anywhere) - Most good links show up in your chats. So make your own little bot on Telegram, Discord, Slack, or WhatsApp, and just message it - the bookmark lands in your l… (open)
- [Your data is yours: backups and export](https://bommel.bot/agents/rooms/writing/records/blog/backups-and-export) - A Pro feature: export everything you've saved - as a simple file, a spreadsheet, or a full zip with your documents - and import it back. You can even lock a ba… (open)
- [Sign-in, verification, and keeping you safe](https://bommel.bot/agents/rooms/writing/records/blog/accounts-and-security) - You don't need an account to start. When you want cloud sync, here's how signing in works, why we check your email, and the extra locks (like two-step sign-in)… (open)
- [Local-first, with optional cloud sync](https://bommel.bot/agents/rooms/writing/records/blog/sync-across-devices) - Your library lives on your device first, so it's fast and works offline. Sign in on Free to sync bookmarks across devices (up to 100). Pro adds attachment file… (open)
- [Where a Bommel can live](https://bommel.bot/agents/rooms/writing/records/blog/where-your-bommels-live) - This device, your private library, or public Bommels. The Gateway reads what you published. Pairing is only for the agent to file into your account. (open)
- [Private vs public bookmarks (and how sharing works)](https://bommel.bot/agents/rooms/writing/records/blog/private-vs-public) - Web finds start public (still reviewed). Files, contacts, and documents stay private. The Gateway and paired agents see only what you published, never someone … (open)
- [Comments: turn them on, moderate, and block](https://bommel.bot/agents/rooms/writing/records/blog/moderating-comments) - Comments are off until you open them. Learn the global vs per-entry switch, how to delete a comment, and how to block (or unblock) someone from commenting on y… (open)
- [Choose the brain that helps me think](https://bommel.bot/agents/rooms/writing/records/blog/ai-models-overview) - the agent connects through the Gateway. Separately, the in-app chat can use a built-in brain, a local model, or a cloud key in Settings. (open)
- [Connect the agent](https://bommel.bot/agents/rooms/writing/records/blog/connect-your-agent) - Copy the Gateway prompt to read public Bommels. No new name, no key. Pairing is a second door: identity kit plus a key, then it can save into your library. (open)
- [Use Ollama or LM Studio (private and free)](https://bommel.bot/agents/rooms/writing/records/blog/use-local-ai) - Run the AI brain right on your own computer with Ollama or LM Studio. Nothing leaves your machine, it costs nothing, and I get properly clever. Here's how to c… (open)
- [Use OpenAI, Claude, Gemini, Grok, or Perplexity](https://bommel.bot/agents/rooms/writing/records/blog/use-cloud-ai) - Already have a key from a big AI provider? Paste it in and I'll use their model to read and organize your saves. Your key stays on your device. Here's the how-… (open)
- [Pro is the library, not a brain we pay for](https://bommel.bot/agents/rooms/writing/records/blog/managed-ai) - Completions are always yours. the agent uses the Gateway. Pairing needs a key. Settings keys are only for in-app chat. Pro is storage, not tokens. (open)
- [Keep every recipe you love in one place](https://bommel.bot/agents/rooms/writing/records/blog/recipes) - That soup you made last winter? The cake from that video? Save them all, and I'll find any one by name, ingredient, or 'the one with the lemon'. Your own cookb… (open)
- [Plan dream trips and remember every spot](https://bommel.bot/agents/rooms/writing/records/blog/travel) - Hotels, hidden beaches, that little café someone mentioned - save them as you find them, and I'll have your whole trip ready when you need it. (open)
- [Never lose an important document again](https://bommel.bot/agents/rooms/writing/records/blog/important-documents) - Insurance, your driver's licence, the visa, that invoice - snap a photo or save the file, keep it private, and just ask me when you need it. No more digging th… (open)
- [Save the health and workout info that matters](https://bommel.bot/agents/rooms/writing/records/blog/health-and-fitness) - The best chest workout, a doctor's advice, treatment options worth remembering - keep the good stuff in one calm place, and find it exactly when you need it. (open)
- [House and apartment hunting, made tidy](https://bommel.bot/agents/rooms/writing/records/blog/home-hunting) - Save every listing you like, add notes about the good and the bad, and compare them side by side. When it's decision time, everything's right here. (open)
- [Find, compare, and remember cars](https://bommel.bot/agents/rooms/writing/records/blog/car-buying) - Shopping for a car - or just in love with a few? Save the listings, keep your notes, and set a reminder to check back. I'll keep your shortlist neat. (open)
- [Collect the best of the best (and show it off)](https://bommel.bot/agents/rooms/writing/records/blog/collections-hobby) - Remember collecting stickers as a kid? Do it with anything now - the finest gear, art, sneakers, whatever you love - and share your collection boards with the … (open)
- [Restaurants, cafés, and lovely little places](https://bommel.bot/agents/rooms/writing/records/blog/eating-out) - The brunch spot with the good mimosas, the cosy dinner place, the café you keep meaning to try - save them all so you're never stuck for where to go. (open)
- [Run your small business without the mess](https://bommel.bot/agents/rooms/writing/records/blog/small-business) - Plumber, dentist, freelancer - keep client contacts, invoices, and supplier links in one place, all private, and ask me the moment you need 'that invoice from … (open)
- [Hunt for jobs without losing track](https://bommel.bot/agents/rooms/writing/records/blog/job-hunting) - Save every promising role, and I'll track which ones you've applied to and heard back from. Your whole search, in one calm, organized list. (open)
- [Post roles and find great people](https://bommel.bot/agents/rooms/writing/records/blog/recruiting) - Hiring a 3D artist or a project manager? Build a public collection of your open roles, share the link, and let people reach you on the channels you choose. (open)
- [Showcase and sell what you've got](https://bommel.bot/agents/rooms/writing/records/blog/selling-stuff) - Got a car to sell or a shelf of things? Make a public collection with photos and links, add how to reach you, and share it far and wide. (open)
- [Build little directories people actually want](https://bommel.bot/agents/rooms/writing/records/blog/local-directories) - The best dog parks, the quietest study cafés, the nicest playgrounds - turn what you know into a shareable directory that helps your whole town. (open)
- [Connect with people, as friends or for work](https://bommel.bot/agents/rooms/writing/records/blog/networking-and-friends) - Your public page can share the ways you like to be reached - Telegram, WhatsApp, email, and more - so people can find you and say hello. You decide what shows. (open)
- [Study smarter: keep your research together](https://bommel.bot/agents/rooms/writing/records/blog/students-and-study) - Articles, videos, PDFs, notes - save your sources as you go and ask me for them at exam time. Like a study buddy who never forgets where anything is. (open)
- [A calm 'read it later' that you'll actually revisit](https://bommel.bot/agents/rooms/writing/records/blog/reading-later) - Save the long articles for a quieter moment. Add a note about why, and when you have five minutes, ask me what you saved to read - no endless open tabs. (open)
- [Save videos and build inspiration boards](https://bommel.bot/agents/rooms/writing/records/blog/videos-and-inspiration) - That tutorial, that song, that gorgeous room - save videos and images, keep them in boards, and come back for a hit of inspiration whenever you like. (open)
- [Keep family life organized and stress-free](https://bommel.bot/agents/rooms/writing/records/blog/family-life) - School forms, doctor's notes, gift ideas, that recipe grandma sent - one private place for the family's odds and ends, and I'll fetch any of it in a second. (open)
- [A swipe file for creators](https://bommel.bot/agents/rooms/writing/records/blog/creators) - Great hooks, references, tools, and ideas - save them the moment they spark, tag them your way, and turn your best finds into public boards your audience will … (open)
- [Free and Pro - in plain words](https://bommel.bot/agents/rooms/writing/records/blog/plans-explained) - The Gateway is free with no account. Free is a real vault. Pro ($8) is library infrastructure: files, vectors, backups, extra runtimes. You still pay LLM token… (open)
- [Platform safety architecture - the complete reference](https://bommel.bot/agents/rooms/writing/records/blog/platform-safety-architecture) - Every safety and security control on the platform in one place: the zero-tolerance content policy, the seven enforcement layers, all five automated checkers an… (open)
- [Set up content-safety scanning (Google Cloud)](https://bommel.bot/agents/rooms/writing/records/blog/content-safety-apis-setup) - A slow, click-by-click walkthrough for turning on the four safety checkers - Natural Language, Vision, Web Risk, and the Gemini page classifier - and then lett… (open)
- [Reporting content & the moderation queue](https://bommel.bot/agents/rooms/writing/records/blog/moderation-and-reports) - How to report a public bookmark that breaks the rules, what happens after you do, how the automated pipeline decides most submissions on its own, and - for adm… (open)
- [Fixing excessive ISR writes on Vercel](https://bommel.bot/agents/rooms/writing/records/blog/excessive-isr-writes) - Why bot traffic on our public bookmark pages caused a storm of Vercel ISR writes, how we fixed it (dynamic rendering + edge shape-checks and rate limiting), an… (open)
- [Connect Telegram to Bommelbot](https://bommel.bot/agents/rooms/writing/records/blog/connect-telegram) - Create a Telegram account, build your own Bommelbot with BotFather, paste its token into Bommel Bot, and save bookmarks by messaging your bot - start to finish. (open)
- [Connect Discord to Bommelbot](https://bommel.bot/agents/rooms/writing/records/blog/connect-discord) - Make a Discord account, create an application + bot in the Developer Portal, connect it to Bommel Bot, and file bookmarks with the /save command - every step e… (open)
- [Connect WhatsApp to Bommelbot](https://bommel.bot/agents/rooms/writing/records/blog/connect-whatsapp) - Set up WhatsApp and the free Meta Cloud API, grab your access token, phone number ID and app secret, wire up the webhook, and save bookmarks by texting your nu… (open)
- [Connect Slack to Bommelbot](https://bommel.bot/agents/rooms/writing/records/blog/connect-slack) - Create a Slack workspace and app, get your bot token and signing secret, point Slack's Events API at Bommel Bot, and save bookmarks by DMing your bot. (open)
- [Add the browser button (Chrome, Edge & Firefox)](https://bommel.bot/agents/rooms/writing/records/blog/connect-browser-extension) - A clear, step-by-step setup for the Web Clipper - download it, add it to Chrome, Edge, or Firefox, and clip any page with one click. Beginner-friendly, no tech… (open)

## How to read this gateway

- HTML (this page): https://bommel.bot/agents
- Markdown: https://bommel.bot/agents.md
- Plain text: https://bommel.bot/agents.txt
- llms.txt: https://bommel.bot/llms.txt
- MCP server card: https://bommel.bot/.well-known/mcp.json
- Public MCP (Streamable HTTP): https://bommel.bot/api/mcp
- Public MCP REST proxy: https://bommel.bot/api/mcp/tool
- Keyed agent OpenAPI (after /connect): https://bommel.bot/api/agent/v1/openapi.json
- Gateway discovery JSON: https://bommel.bot/.well-known/agent-gateway.json

## What an agent can learn

- Structured room and record listings with lock tiers in plain language.
- Absolute URLs for each record so agents can follow links without guessing paths.
- Open writing cards with summaries suitable for chat citations.
- Machine-readable formats (markdown, plain text, MCP, REST) aligned with this index.

Last updated: 2026-10-04T02:24:45.427Z