Skip to main content

BrowserTones developer API reference

OpenAPI 3.1 specification · Current product facts JSON · Versioned sound catalog JSON · MCP connection instructions

Read APIs

GET /api/agent-facts?topic=all returns current product facts. An unknown topic returns 400. GET and HEAD are supported; other methods return 405.

GET /guitar-sounds.json returns 49 descriptions, exact player URLs, revisions, catalog versions and settings. These are settings, not audio files.

Sound tools over MCP

POST /api/mcp uses MCP Streamable HTTP, not a REST tone-generation API. Read get_capabilities, then compose_sound or refine_sound with the returned current version. Lead with the validated trialOffer.playerUrl. A public snapshot through open_sound requires explicit user choice.

A2A 1.0 deterministic sound messages

Current A2A card · Exact request schemas. POST JSON-RPC SendMessage to /api/a2a with A2A-Version: 1.0. The user message uses role ROLE_USER and one data part containing operation and arguments. Supported operations are get_product_facts, get_capabilities, compose_sound and refine_sound. Read capabilities before selecting settings. The response is a synchronous ROLE_AGENT Message with structured result and, for a sound, its exact trialOffer.playerUrl. The adapter is stateless: carry the full sound and revision for refinement. It does not support model interpretation, retained tasks, streaming, public snapshots, purchases or playback.

Versioning and deprecated information

Product facts version: bt-product-facts-2026-11-21.web-trials.1. Read live catalogVersion and revision fields rather than guessing a version. A CATALOG_CHANGED or SOUND_CHANGED error requires refreshing the source. Old FUKKAUDIO and /tones links are compatibility material; use canonical BrowserTones guides and the current catalog.

Authentication and limits

Current authentication and authority instructions

The current public read APIs and MCP sound tools require no account or API key. This grants no owner access, private history, purchasing or device control. Public requests are rate-limited; a 429 or 503 response must be respected. The optional model conversation has its existing session and daily cost limits; it is not required for deterministic sound construction.

Limitations and disclaimer

Start with low output and headphone volume; sudden loud sound can harm hearing. Browser support, audio routing and latency depend on the device, browser and interface. Chrome is recommended; a narrow viewport is not proof of Android hardware support. A musical interpretation is not a guaranteed exact artist or equipment clone. The browser player is not an offline DAW plugin, audio download or purchasing service.

Latency help · Equipment setup · Use and service limits