bron-api-toolkit

module

v0.1.1 Latest Latest Go to latest Published: Jul 22, 2026 License: MIT

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/bronlabs/bron-api-toolkit

Links

Open Source Insights

README ¶

bron-api-toolkit

This is an internal Go library, not a runnable program. To use the Bron MCP server, run bron mcp from bron-cli, or open Bron Desktop → MCP Server.

Shared, spec-driven API tooling generated from the Bron public API's OpenAPI spec:

catalog — the API distilled into data (resources, verbs, path/query params, body fields, types, enums, descriptions) plus the embedded spec.
helpers — request/response utilities the CLI and MCP tools both use (query params, request bodies, output projection, date humanization, jq filtering, embeds, untrusted-field wrapping).
mcptools — builds MCP tools from the catalog at runtime.

Consumed by bron-cli (its command tree and bron mcp) and by Bron Desktop's embedded MCP server, so the agent tooling never diverges between them.

Directories ¶

Path	Synopsis
body Package body parses and composes the request body for write operations.	Package body parses and composes the request body for write operations.
catalog Code generated by cligen.	Code generated by cligen.
cmd
cligen command cligen reads the OpenAPI spec and emits the command catalog under catalog/ (`package catalog`: HelpEntries + TxShortcuts + the embedded spec.json).	cligen reads the OpenAPI spec and emits the command catalog under catalog/ (`package catalog`: HelpEntries + TxShortcuts + the embedded spec.json).
jqfilter Package jqfilter runs a jq program over an already-decoded JSON value in a locked-down sandbox.	Package jqfilter runs a jq program over an already-decoded JSON value in a locked-down sandbox.
mcptools
output Package output renders API responses in one of four formats: json (default), yaml, jsonl, table — optionally narrowed by --columns (dotted-path projection).	Package output renders API responses in one of four formats: json (default), yaml, jsonl, table — optionally narrowed by --columns (dotted-path projection).
qparam Package qparam normalizes URL query-parameter values before they hit the wire.	Package qparam normalizes URL query-parameter values before they hit the wire.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL