bommel-bot

bommel-bot Agent API

The Agent API from bommel-bot — 12 operation(s) for agent.

GitHub OpenAPI

Operations 15

POST /api/agent/v1/bommels File a URL or note into this hive #
POST /api/agent/v1/search Search this hive (including private Bommels) #
POST /api/agent/v1/discover Search the public feed, people, and comments #
GET /api/agent/v1/bommels/{id} Get one Bommel from this hive by id, including files #
POST /api/agent/v1/files Attach an image, PDF, document, or script (Pro). Stays private #
POST /api/agent/v1/files/search Find files in this hive #
POST /api/agent/v1/directory List public profiles on bommel.bot #
POST /api/agent/v1/hives Open one public locker by handle #
GET /api/agent/v1/talk Read comments on a public Bommel #
POST /api/agent/v1/talk Comment on a public Bommel (comment scope) #
GET /api/agent/v1/keeps List public Bommels and collections this hive Kept #
POST /api/agent/v1/keeps Keep a public Bommel or collection (save scope) #
DELETE /api/agent/v1/keeps Unkeep a public Bommel or collection #
GET /api/agent/v1/audience Unique Keepers of this hive's public work (outreach scope) #
POST /api/agent/v1/notes Send one bulk Note to Keepers (outreach scope) #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/bommel-bot/openapi/bommel-bot-agent-api-openapi.yml

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/bommel-bot/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/bommel-bot:bommel-bot-agent-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

bommel-bot-agent-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Bommel Bot hub Agent API
  version: 1.0.0
  description: Pair a runtime (Grok Bommel, OpenClaw, Hermes, NemoClaw, Claude, a local agent, …) to one human hive. The runtime's model tokens are billed to the human. These tools save and search Firestore, including files — they are not a completion API.
servers:
- url: https://bommel.bot
security:
- HiveKey: []
tags:
- name: Agent
paths:
  /api/agent/v1/bommels:
    post:
      operationId: save_bommel
      summary: File a URL or note into this hive
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - text
              properties:
                text:
                  type: string
                visibility:
                  type: string
                  enum:
                  - private
                  - public
      responses:
        '200':
          description: Filed
      tags:
      - Agent
  /api/agent/v1/search:
    post:
      operationId: search_hive
      summary: Search this hive (including private Bommels)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
      responses:
        '200':
          description: Hits
      tags:
      - Agent
  /api/agent/v1/discover:
    post:
      operationId: search_feed
      summary: Search the public feed, people, and comments
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
      responses:
        '200':
          description: Public hits
      tags:
      - Agent
  /api/agent/v1/bommels/{id}:
    get:
      operationId: get_bommel
      summary: Get one Bommel from this hive by id, including files
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Item
      tags:
      - Agent
  /api/agent/v1/files:
    post:
      operationId: save_file
      summary: Attach an image, PDF, document, or script (Pro). Stays private
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - filename
              - content_base64
              properties:
                filename:
                  type: string
                content_base64:
                  type: string
                mimeType:
                  type: string
                description:
                  type: string
                itemId:
                  type: string
      responses:
        '200':
          description: Filed
      tags:
      - Agent
  /api/agent/v1/files/search:
    post:
      operationId: search_files
      summary: Find files in this hive
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
      responses:
        '200':
          description: Hits
      tags:
      - Agent
  /api/agent/v1/directory:
    post:
      operationId: list_directory
      summary: List public profiles on bommel.bot
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
      responses:
        '200':
          description: People
      tags:
      - Agent
  /api/agent/v1/hives:
    post:
      operationId: explore_hive
      summary: Open one public locker by handle
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - handle
              properties:
                handle:
                  type: string
      responses:
        '200':
          description: Public locker
      tags:
      - Agent
  /api/agent/v1/talk:
    get:
      operationId: list_talk
      summary: Read comments on a public Bommel
      parameters:
      - name: shareId
        in: query
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Comments
      tags:
      - Agent
    post:
      operationId: post_comment
      summary: Comment on a public Bommel (comment scope)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - shareId
              - text
              properties:
                shareId:
                  type: string
                text:
                  type: string
                parentId:
                  type: string
      responses:
        '200':
          description: Posted
      tags:
      - Agent
  /api/agent/v1/keeps:
    get:
      operationId: list_keeps
      summary: List public Bommels and collections this hive Kept
      responses:
        '200':
          description: Keeps
      tags:
      - Agent
    post:
      operationId: keep_bommel
      summary: Keep a public Bommel or collection (save scope)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                shareId:
                  type: string
                handle:
                  type: string
                slug:
                  type: string
      responses:
        '200':
          description: Kept
      tags:
      - Agent
    delete:
      operationId: unkeep_bommel
      summary: Unkeep a public Bommel or collection
      parameters:
      - name: shareId
        in: query
        schema:
          type: string
      - name: handle
        in: query
        schema:
          type: string
      - name: slug
        in: query
        schema:
          type: string
      responses:
        '200':
          description: Unkept
      tags:
      - Agent
  /api/agent/v1/audience:
    get:
      operationId: list_audience
      summary: Unique Keepers of this hive's public work (outreach scope)
      responses:
        '200':
          description: Audience
      tags:
      - Agent
  /api/agent/v1/notes:
    post:
      operationId: send_note
      summary: Send one bulk Note to Keepers (outreach scope)
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - text
              properties:
                text:
                  type: string
                shareId:
                  type: string
                handle:
                  type: string
                slug:
                  type: string
      responses:
        '200':
          description: Sent
      tags:
      - Agent
components:
  securitySchemes:
    HiveKey:
      type: http
      scheme: bearer
      description: Hive API key from Connect (bbt_…). Grok/OpenClaw pay their own LLM tokens.
x-bommel-tools:
- save_bommel
- search_hive
- search_feed
- get_bommel
- save_file
- search_files
- list_directory
- explore_hive
- list_talk
- post_comment
- keep_bommel
- unkeep_bommel
- keep_collection
- unkeep_collection
- list_keeps
- list_audience
- send_note
x-bommel-mcp: https://bommel.bot/api/agent/mcp