Developers
Use Tune.Toys from scripts, publisher automation and agents: API keys, limits, webhooks, embeds, MCP and schemas.
Status: The developer platform is implemented locally. Third-party OAuth, a hosted MCP endpoint, paid usage packs and CORS for browser-side keys are planned. Rate-limit numbers are proposed defaults pending an owner decision.
The API is described by an OpenAPI 3.1 document generated from the same route declarations the server runs. Use the route index here, or the interactive Swagger UI on tune.toys, which can send requests with your key. Download openapi.json for code generation.
| I want to | Go to |
|---|---|
| Make my first call | Quickstart |
| Understand keys and scopes | Authentication |
| Know how fast I can call | Rate limits |
| Handle failures | Errors |
| Page through lists | Pagination |
| Retry writes safely | Idempotency |
| React to events | Webhooks |
| Put a Toy on my site | Embed API |
| Drive Tune.Toys from an agent | MCP server and agent documents |
| Use TypeScript | SDK |
| Validate a Toy | JSON Schemas |
- QuickstartCreate an API key and make your first authenticated request.
- Authentication and keysKey format, scopes, lifetime, rotation, revocation and what keys can never do.
- Rate limits and quotasBuckets, weights, headers and the 429 response.
- ErrorsThe error envelope and the stable error codes.
- PaginationOffset catalog pages, keyset cursors and sync cursors.
- IdempotencyRetry writes safely with an Idempotency-Key.
- WebhooksSigned event deliveries for product events (pro apps).
- Embed APIEmbed a playable Frame, a read-only Patch or a node card with an iframe and control it with postMessage.
- MCP serverLet a local agent search the catalog, read node docs, validate Toys and edit your drafts.
- SDKThe TypeScript client for the Tune.Toys API.
- Agent documents and llms.txtMachine-readable entry points for agents and crawlers.
- JSON SchemasPublished JSON Schemas for the Toy format and every platform contract.
- API route indexAll 271 public operations of the Tune.Toys API 0.1.0, grouped by tag.