Developer docs

MCP server

Remote agents use Kinetune through the Model Context Protocol — one tool per API operation, Streamable HTTP, sign-in with your account.

Server URL
https://kinetune.com/mcp

Also listed in the official MCP Registry (com.kinetune/kinetune), on Smithery, Glama, mcp.so, Cursor Directory and mcpservers.org.

Connect

  1. In ChatGPT, open Settings → Apps & Connectors → Advanced and turn on Developer mode (it depends on your plan and workspace settings).
  2. Choose Create, name it Kinetune, paste the server URL and pick OAuth.
  3. Sign in, choose the workspace and approve. Then enable it in a chat from the tools menu.

Tools

The server is stateless (JSON responses, protocol 2025-11-25). Tools that create videos spend credits, so agents are instructed to quote first and ask. wait_for_video waits up to 55 seconds per call.

ToolWhat it does
get_accountWho you are signed in as, the organization (workspace) and its credit balance
get_optionsVideo types, Look categories, background sources, formats and the current credit prices
list_organizationsThe organizations you belong to, your role in each and the one these credentials act for
create_organizationA new organization owned by you, with its own music, videos, Looks and credits
update_organizationRename the organization (workspace) these credentials act for, or switch it between artist and label
list_artistsArtists by name, with their song and photo counts and a picture
create_artistAdd an artist by name
get_artistOne artist
rename_artistChange an artist’s name
archive_artistdestructiveRemove an artist that has no songs
set_artist_pictureChoose which photo is the artist’s picture, and how it is cropped to a square
list_artist_photosThe artist’s photos (identity references)
add_artist_photosUpload one or more photos of the artist (JPEG, PNG or WebP)
delete_artist_photodestructiveRemove one photo
list_kitOutfits, places and props a music video brief can mention
add_kit_pieceAn outfit, place or prop from an image, a link or a stock photo, cropped
get_kit_pieceOne outfit, place or prop
update_kit_pieceRename it, change its handle or description, or crop it again
delete_kit_piecedestructiveRemove an outfit, place or prop
list_songsSongs with their cover, duration and analysis status
create_songAdd a song: master audio and square cover art
get_songOne song and its analysis status
rename_songChange a song’s title
archive_songdestructiveRemove a song (its videos stay)
get_song_analysisWord-timed lyrics, tempo, beats, sections, hook and the parts a video can be cut to
reanalyze_songRetry a failed analysis
set_song_lyricsdestructiveGive a song its own lyrics, or replace them
clear_song_lyricsdestructiveGo back to the transcribed words
list_looksBrowse Official, Community and your own Looks
get_lookOne Look with its design and preview images
rename_lookRename one of your Looks
delete_lookdestructiveRemove one of your Looks (videos made with it stay)
set_look_visibilityMake one of your Looks public (earns 10 credits) or private
upload_backgroundUpload your own photo or video to design a New Look around
search_stockFind stock photos or clips to use as a background
quote_lyric_videoThe exact credits for a lyric video, before anything is charged
quote_canvasThe exact credits for a Spotify Canvas, before anything is charged
plan_music_videoThe director's shot list for a music video, the idea and every shot, before anything is charged
swap_music_video_placeAnother stock photo for one of a plan's places
design_music_video_shootThe director designs the outfits, places and props the brief leaves to it as pictures, before the shot list
get_music_video_lookbookA lookbook with its pictures as they are drawn
update_music_video_lookbookWhether its kept pieces join the kit when a video is planned from it
render_music_video_lookbookDraws the pieces not drawn yet (spends credits)
redesign_music_video_lookbookRedesigns the director's pieces with a note and draws them again (spends credits)
keep_music_video_lookbook_pieceWhether a piece goes into the video
redraw_music_video_lookbook_pieceDraws one of the director's pieces again, with an optional note (spends credits)
get_music_video_planA plan made earlier
quote_music_videoThe exact credits for an AI music video, before anything is charged
create_lyric_videoMake the lyric video a quote priced (spends credits)
create_canvasMake the Canvas a quote priced (spends credits)
create_music_videoMake the music video a quote priced (spends credits)
list_videosVideos, newest first, with status and thumbnails
get_videoStatus, progress, credits and, when completed, the download links
cancel_videodestructiveStop a queued or processing video (credits released)
retry_videoRun a finished, failed or cancelled video again (new charge)
delete_videodestructiveDelete a finished video and its files
suggest_ideaSuggest a feature or change to Kinetune for others to vote on
wait_for_videoWaits for a video to finish (up to 55 s per call), then returns it like get_video
show_looksShows Looks as a gallery to play and pick from (with a sample song, or the person's own with song_id)
show_songsShows songs with covers and analysis status, each offering a lyric video, a Canvas or a music video
show_videoShows videos as players that follow the render, with a download per format

Cards in chat apps

In apps that draw MCP Apps (ChatGPT, Claude, VS Code and others), results arrive as Kinetune cards instead of text: a gallery where each Look plays as the real render, the quote as an order ticket with a Make it button (tapping it is the go-ahead, and the card creates the videos), and the video as a player that follows the render and offers a download per format. The cards run in the app's sandbox, call the same tools, and load media only from Kinetune and its storage. Other clients get the same results as JSON.

Prompts and resources

Clients that show prompts as commands get four ready-made starts: make_lyric_video, make_canvas, make_music_video and browse_looks. Each one follows the quote-first workflow.

Read-only resources mirror the API reads: kinetune://account and kinetune://options, plus templates for kinetune://songs/{song_id}, …/analysis, kinetune://looks/{look_id}, kinetune://videos/{video_id} and kinetune://artists/{artist_id}, all returned as JSON.