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.