Skip to main content
Version: FINAL-1.0.0

Tools reference

All MCP tools exposed by @bunnystudio/mcp. The server maps these to the Bunny Studio API.

Authentication

ToolDescription
bunnystudio_loginAuthenticate with email/password. Token is stored for the session.

Projects

ToolDescription
bunnystudio_preview_projectValidate inputs and get a price quote before creating (read-only)
bunnystudio_create_projectCreate a voice over or audio ads project (requires confirmation)
bunnystudio_get_projectGet a project by ID
bunnystudio_list_projectsList your projects (paginated, filterable)
bunnystudio_cancel_projectCancel a project with reason
bunnystudio_get_quoteGet a price estimate without creating a project

Deliverables

ToolDescription
bunnystudio_get_deliverableGet a single deliverable
bunnystudio_get_deliverables_by_projectGet all deliverables for a project
bunnystudio_approve_deliverableApprove a single deliverable
bunnystudio_select_winner_deliverableSelect winner (contest fulfillment only)
bunnystudio_approve_deliverables_by_projectApprove all pending deliverables at once
bunnystudio_reject_deliverableReject a deliverable with reason code
bunnystudio_create_revisionRequest a revision with instructions
bunnystudio_get_deliverable_versionsGet all versions of a deliverable

Categories

ToolDescription
bunnystudio_get_categoriesAll categories and subcategories
bunnystudio_get_category_attributesAttributes for a subcategory (language, gender/age, etc.)
bunnystudio_get_category_attribute_valuesValid values for a category attribute
bunnystudio_get_available_voice_overAvailable voice over sub-categories
bunnystudio_get_available_audio_adsAvailable audio ads sub-categories

Music / Tracks

ToolDescription
bunnystudio_get_track_typesAll music track types
bunnystudio_get_track_subtypesSubtypes for a track type
bunnystudio_get_trackGet a specific track by ID
bunnystudio_get_all_tracksBrowse tracks with filters and pagination
bunnystudio_get_music_libraryCombined mode-based music library browser
ToolDescription
bunnystudio_searchSearch talents/samples by category, filters, and purpose (numeric ID, auto-inferred)

Definitions (reference data)

ToolDescription
bunnystudio_get_status_typesAll status types
bunnystudio_get_project_status_typesProject status types
bunnystudio_get_service_status_typesService status types
bunnystudio_get_deliverable_status_typesDeliverable status types
bunnystudio_get_revision_reasonsReasons for requesting revisions
bunnystudio_get_cancellation_reasonsReasons for canceling projects
bunnystudio_get_rejection_reasonsReasons for rejecting deliverables

Response format

Every tool accepts an optional response_format parameter:

  • "markdown" (default) — human-readable output
  • "json" — raw JSON for programmatic use

Important validation rules

  • Only voice_over and audio_ads are available as mainService
  • services array is required — at least one service object must be provided when creating projects
  • title max length — 100 characters
  • purpose (search) — numeric ID, not a string. Valid IDs: 6 (Movie trailers), 7 (Phone systems), 9 (Product videos), 10 (Presentations/Educational), 11 (Commercials/Advertising), 14 (Characters/Videogames), 16 (Live announcements), 19 (Audiobooks/Podcasts), 20 (Radio/TV tags). The AI auto-infers purpose from context
  • Two-phase project creation — For creating projects, the AI calls bunnystudio_preview_project first (validates inputs, returns price quote), then waits for your confirmation before calling bunnystudio_create_project