How to connect

Agent Gateway

v1.0.0

Bommel Bot is an AI bookmark platform — each saved item is a Bommel. This page is the human doorway into the agent gateway.

Door 1 is public read only: the home feed, public profiles (/@handle), and comments on published Bommels — six MCP tools, no account. Door 2 is your private library via bbt_ keys from /connect. Vaults, private Bommels, and admin surfaces stay off the public door.

Gateway index last updated

YOUR AI AGENT enters the Agent Gateway to read public Bommels.

  1. 1 · Copy

    Copy the GATEWAY PROMPT.

  2. 2 · Paste

    Paste it into YOUR AI AGENT.

  3. 3 · Done

    That is it.

GATEWAY PROMPT

GATEWAY PROMPT — Bommel Bot Agent Gateway

Public read only. No account. No API key.

Doors
- Human: https://bommel.bot/agents
- MCP (Streamable HTTP): https://bommel.bot/api/mcp
- REST: https://bommel.bot/api/mcp/tool
- Discovery: https://bommel.bot/.well-known/mcp.json
- WebMCP on this origin: document.modelContext
- MCP server name: bommel-public
- Gateway version: 1.0.0

Private library (save, search your vault)
- Not this door. Human registers on https://bommel.bot, signs in, mints Bearer bbt_… on https://bommel.bot/connect.
- Give YOUR AI AGENT https://bommel.bot/api/agent/mcp with Authorization: Bearer bbt_…
- The agent never gets its own login, email, or @handle.

Greetings
Call get_site_info, or POST https://bommel.bot/api/mcp/tool with { "name": "get_site_info" }.
The reply confirms YOUR AI AGENT is connected via the Bommel Bot Agent Gateway.

Then
- search_feed — public Bommels. Empty query lists recent.
- get_public_bommel — one published Bommel by shareId.
- list_directory — public people.
- explore_hive — one person's public Bommels by @handle.
- list_talk — comments on a public Bommel.

Everything public on this site can be read through the Gateway.
If it is not published, YOUR AI AGENT does not have it. Do not invent records.
Empty search means count 0.

When connected, try: "List recent public Bommels."
Human
https://bommel.bot/agents
MCPLive
https://bommel.bot/api/mcp
RESTLive
https://bommel.bot/api/mcp/tool
Discovery
https://bommel.bot/.well-known/mcp.json
Agent GWLive
https://bommel.bot/.well-known/agent-gateway.json
Index MD
https://bommel.bot/agents.md
WebMCPLive
document.modelContext

Gateway rooms

Structured shelves for visiting agents (plain text at each link).

Well-known map: /.well-known/agent-gateway/

Advanced: Cursor / Claude MCP

Cursor mcp.json

mcp.json

{
  "mcpServers": {
    "bommel-public": {
      "url": "https://bommel.bot/api/mcp"
    }
  }
}

Claude Code

Claude Code

claude mcp add --transport http bommel-public https://bommel.bot/api/mcp

Then what

This door is public read only. When YOUR AI AGENT knocks, it may read what people published. If it is not public, YOUR AI AGENT does not have it. Do not invent the rest.

  • 6Read tools
  • 3Protocols
  • No account

Door 2: save into a private library

To file links into your library, the human registers on Bommel Bot, signs in, and mints a Bearer key (bbt_…) on /connect. Give YOUR AI AGENT https://bommel.bot/api/agent/mcp with Authorization: Bearer bbt_…. The agent never gets its own login, email, or @handle.

Connect / mint keyPairing guide

Public read tools

  • get_site_info

    Connection test. Confirms the Gateway is live.

  • search_feed

    Search public Bommels. Empty query lists recent.

  • get_public_bommel

    Read one published Bommel by id.

  • list_directory

    Public people on this site.

  • explore_hive

    One person's public Bommels by @handle.

  • list_talk

    Comments on a public Bommel.