Endpoints: 76,849MCP servers: 32,730Payout addresses: 3,825Paid calls: 6,160Letters: 84Defects: 3,898counted 4 min ago
teppi

Server definition

Hash
sha256:521ecec8978c5d8fe0a85e49d3189a48e1a692ce26f907e97957b0ad8345fc8c
What it is
What a remote MCP server returned when asked what it offers: 38 tools

The blob, as servednamed by its sha256

{ "instructions": "Gomo Sounds keeps the sound effects of the user's games: game → folders → sounds (the tools call them events) → versions (AI variations; the game raffles among the chosen ones). An entity is a thing of the game (a scene): on the site it is a folder with its image, holding its own sounds. Talk to the user in the site's words: folder, sound, version; never 'event' or 'entity'. Always talk in the user's language. FIRST, in every conversation, call gomo_guide and follow it: it has the full rules (some apps cut these instructions short). Rules you never break: 1) Never generate without the user's yes to the EXACT total cost; only then approve_spending. 2) A new project is ALWAYS a new game (create_game); for a video, podcast or app, kind=project (same screen, under Projects). One sound, no game: loose_sounds. Never use, change or rename an existing game unless the user says so in this conversation; a game linked in project.godot is not permission. 3) Every thing that makes noise (player, enemy, item, projectile, button) is an ENTITY (a label on its sounds), never a folder. Create EVERYTHING the user approved (create_game with entities); never leave approved events out to wait for a plugin sync: give each entity its scene path as external_id and the sync merges it. 4) One-shots at least 2 s, loops at least 6 s. 5) Never read the Godot plugin key, and never put files in the user's project before they chose: plugin or only the conversation. 6) Give the site link (url) of everything you create; a sound is its page, never the audio file link. 7) Tool responses may carry a note field: read it and follow it. 8) Voice lines (generate_voice) are never chosen automatically: tell the user to listen and pick them on the site (url). 9) If a response says this app has the tools of an older MCP version, tell the user to reconnect the Gomo Sounds connector.", "tools": [ { "description": "Accepts the current Terms of Use and Privacy Policy for the account, like the button on the site. Call it ONLY after a tool answered terms_required, you asked the user that exact question with the links and the user explicitly said yes in this conversation. Never call it on your own or because the user asked for something else. Then retry what you were doing.", "inputSchema": { "properties": { "accepted": { "description": "true only when the user said yes to accepting.", "type": "boolean" } }, "required": [ "accepted" ], "type": "object" }, "name": "accept_terms", "outputSchema": null }, { "description": "Records that the USER approved spending credits: valid until that total is spent, for up to 6 hours (a whole batch of tracks fits in one yes); generate_sounds, generate_voice, generate_music and sounds_for_folder refuse without it. Call it ONLY after you showed the user the whole plan with the total cost (\"Posso gerar <plan> por <total> créditos? Você tem <balance>.\") and the user explicitly said yes to THAT cost in their last message. Never call it on your own, never because the user asked for a game or said 'do everything' before seeing the cost. credits = the total the user approved (it replaces any earlier approval).", "inputSchema": { "properties": { "credits": { "description": "The total the user approved.", "minimum": 1, "type": "integer" }, "plan": { "description": "What you asked the user to approve (the events, variations and durations).", "maxLength": 2000, "type": "string" }, "user_reply": { "description": "The user's own words saying yes, copied exactly.", "maxLength": 500, "type": "string" } }, "required": [ "credits", "plan", "user_reply" ], "type": "object" }, "name": "approve_spending", "outputSchema": null }, { "description": "Edits the event's LIST of sounds the game picks from at random. Pass generation_ids to set the whole list at once (2-3 is a good amount for variety); or generation_id with mode: 'add' adds one, 'remove' removes one, 'only' replaces the list with one, null empties it. After choosing, the UNCHOSEN variations of this event are DELETED to keep the account clean (favorites, edited sounds and sounds used in another event are always kept); emptying the list deletes nothing.", "inputSchema": { "properties": { "event_id": { "description": "The event (sound) whose list you edit, from get_entity, find_sounds or list_folders.", "type": "string" }, "generation_id": { "description": "One variation; with mode. Use generation_ids to pick several.", "type": [ "string", "null" ] }, "generation_ids": { "description": "The full list to use, set at once (the unchosen rest is deleted).", "items": { "type": "string" }, "type": "array" }, "mode": { "default": "add", "description": "Only with generation_id: add (default) puts it in the list, remove takes it out, only makes it the single chosen one.", "enum": [ "add", "remove", "only" ], "type": "string" }, "prune": { "default": true, "description": "false keeps the unchosen variations (the user may still pick another one).", "type": "boolean" } }, "required": [ "event_id" ], "type": "object" }, "name": "choose_sound", "outputSchema": { "properties": { "chosenGenerationIds": { "items": { "type": "string" }, "type": "array" }, "deleted": { "type": "integer" }, "eventId": { "type": "string" } }, "required": [ "eventId", "chosenGenerationIds", "deleted" ], "type": "object" } }, { "description": "Creates an entity in a game: a THING that exists in the game and makes noise (unit, enemy, building, object, block, character, button or screen). NEVER an action or moment: 'Undo', 'Snap', 'Level complete', 'Jump' are EVENTS of something (of Interface, of Blocks, of the Character), not entities. Inside a folder, it inherits the folder's events. On the site it is a folder with its image and name, holding its own sounds, so to the user say 'the Player's sounds' or 'the Player folder', not 'entity'.", "inputSchema": { "properties": { "description": { "default": "", "description": "How it sounds; goes into the prompts.", "maxLength": 400, "type": "string" }, "external_id": { "description": "The engine scene of this thing (e.g. res://player/player.tscn). With it, the plugin sync merges into this entity instead of creating another: create entities before the sync without fear of duplicates.", "maxLength": 300, "type": "string" }, "folder_id": { "description": "Folder (see list_folders). Without it, the entity goes into Sound effects.", "type": "string" }, "game_id": { "description": "The game id, from list_games or create_game.", "type": "string" }, "name": { "description": "The thing's name shown on the site, in the game's language (e.g. Player, Slime, Wooden door). Up to 80 characters.", "maxLength": 80, "minLength": 1, "type": "string" } }, "required": [ "game_id", "name" ], "type": "object" }, "name": "create_entity", "outputSchema": null }, { "description": "Adds an event to an entity OR to a folder. The event name is WHAT happens (Move, Attack, Die, Land, Click, Undo, Level complete), never 'Sound' or 'Som'. A folder event applies to all entities inside it (e.g. 'Select' once for all units); an entity can have its own with the same name, which wins. Game actions with no owner (Undo, Victory, Level complete) go as events of the Interface folder. Ambience (wind, rain, forest) goes in the Ambience folder (\"Ambiente\" in Portuguese games). Always say whether it is a loop. LOOP OR ONE-SHOT, decided from what the sound is in the game: a LOOP is anything that lasts while something keeps happening and the game plays on repeat: ambience and weather, music, engines and machines, fire burning, flowing water, AND movement cycles: footsteps, walking, running, crawling, galloping, sustained wing flapping, rolling. Footsteps are a walk cycle with several steps (6-10 s), never a single step. A ONE-SHOT is one discrete action: hit, swing, click, cry, death, explosion, door, item, sting. DURATION: one-shots at least 2 s even for a tiny click, since shorter clips come out thin (hits, clicks and swings 2 s; cries, deaths, collapses and stings 3-5 s); movement loops 6-10 s; ambience, engine and fire loops 10-16 s. A music TRACK (Music folder) is not a sound effect: it is generated with generate_music and lasts up to the user's plan limit (generate_music duration_sec says it), usually 1-3 min for a theme and 30-60 s for a short loop. The server refuses one-shots under 2 s and loops under 6 s. COST = seconds rounded up × the account price per second (creditsPerSecond in list_games) × variations. Omit duration_sec and a loop is born at 12 s, a one-shot at 2 s. A TRACK in the Music folder follows the music limits instead (a longer prompt, duration up to the user's plan; see duration_sec; omitted: 1 min or the plan limit) and takes the same form as generate_music (genres, bpm, key_scale, time_signature...), saved on it so the site shows it before generating; the form is ignored for other sounds. Several tracks: create_tracks. Generate it with generate_music. On the site an event is a SOUND card (its variations are the versions): call it a sound when talking to the user. Creating an event spends no credits and generates nothing: generate it with generate_sounds (or generate_music). Returns the event id and its site page (url).", "inputSchema": { "properties": { "bpm": { "description": "Compose (\"Andamento\"): tempo in beats per minute (60 to 180 sound best).", "maximum": 300, "minimum": 30, "type": "integer" }, "duration_sec": { "description": "Sounds (up to 30 s): one-shot at least 2 s (hits 2 s, cries and deaths 3-5 s); movement loops like footsteps 6-10 s; ambience 10-16 s. Omitted: loop 12 s, one-shot 2 s. A track in the Music folder: Whole seconds, 10 to 240 (4 min). The user's plan may allow less: the server refuses a longer track. Omitted: 1 min (or the plan limit, if lower).", "maximum": 240, "minimum": 2, "type": "number" }, "entity_id": { "description": "The entity that owns the event (from get_game). Pass entity_id OR folder_id, never both.", "type": "string" }, "folder_id": { "description": "The folder that owns the event (from list_folders): every entity inside inherits it. Pass entity_id OR folder_id, never both.", "type": "string" }, "genres": { "description": "Musical style (the site's \"Estilo musical\"): ONE genre as a one-item list. Its words are written at the start of the prompt (empty = only your prompt).", "items": { "enum": [ "folk", "synthwave", "rock", "metal", "thrash", "power", "death", "black", "doom", "pop", "epic", "orchestral", "classical", "choral", "medieval", "celtic", "tribal", "pirate", "western", "japanese", "desert", "chiptune", "electronic", "cyberpunk", "ambient", "horror", "lofi", "comic", "military", "jazz", "hiphop", "blues", "funk", "bossa", "samba", "latin" ], "type": "string" }, "maxItems": 1, "type": "array" }, "instrumental": { "default": true, "description": "false = sung, with the lyrics below.", "type": "boolean" }, "key_scale": { "description": "Compose (\"Tom\"): the key, e.g. \"A minor\".", "enum": [ "C major", "C minor", "C# major", "C# minor", "D major", "D minor", "Eb major", "Eb minor", "E major", "E minor", "F major", "F minor", "F# major", "F# minor", "G major", "G minor", "Ab major", "Ab minor", "A major", "A minor", "Bb major", "Bb minor", "B major", "B minor" ], "type": "string" }, "language": { "description": "Language of the lyrics.", "enum": [ "pt-BR", "en" ], "type": "string" }, "loop": { "description": "Required. true for anything continuous the game repeats: ambience, music, engines, fire, water and movement cycles (footsteps, running, flapping). false for one discrete action (hit, click, cry, death).", "type": "boolean" }, "lyrics": { "description": "The lyrics, one line per row, parts marked with [Verse], [Chorus], [Bridge]... Only with instrumental=false.", "maxLength": 4096, "type": "string" }, "mode": { "description": "describe = only the prompt; compose = you also set the tempo, key and meter. Omitted: compose when bpm, key_scale, time_signature, genres or sung lyrics are sent, otherwise the track keeps its current mode.", "enum": [ "describe", "compose" ], "type": "string" }, "name": { "description": "What happens, in the game's language (Attack, Die, Click, Level complete). Up to 60 characters. If the owner already has an event with this name, that one is returned instead of a new one.", "maxLength": 60, "minLength": 1, "type": "string" }, "prompt": { "description": "What the sound should sound like, preferably in English, saved on the event for generating later. Up to 450 characters for a sound; up to 512 for a track in the Music folder.", "maxLength": 512, "minLength": 1, "type": "string" }, "quality": { "description": "draft (fast and cheap, to test the idea), good, high (the approved default), max (large model; may be unavailable). The price per minute follows the level.", "enum": [ "draft", "good", "high", "max" ], "type": "string" }, "time_signature": { "description": "Compose (\"Compasso\"): beats per bar (2, 3 = waltz, 4 = most music, 6 = compound like 6/8).", "enum": [ 2, 3, 4, 6 ], "type": "integer" }, "vocal_level": { "description": "Sung tracks: the voice behind the band (back), even (balanced, default, adds nothing) or up front (front); written at the end of the prompt.", "enum": [ "back", "balanced", "front" ], "type": "string" }, "voice": { "description": "Sung tracks: who sings (gender), how deep (timbre) and up to 2 singing styles, written at the end of the prompt. Omitted: the model picks.", "properties": { "gender": { "enum": [ "male", "female", "duet", "choir" ], "type": "string" }, "styles": { "items": { "enum": [ "breathy", "powerful", "raspy", "falsetto", "spoken", "screamed" ], "type": "string" }, "maxItems": 2, "type": "array" }, "timbre": { "enum": [ "low", "mid", "high" ], "type": "string" } }, "type": "object" } }, "required": [ "name", "prompt", "loop" ], "type": "object" }, "name": "create_event", "outputSchema": null }, { "description": "Creates a folder (free name) in a game, to GROUP several entities (Enemies, Items) or, in Ambience and Interface, sounds by place or screen. Never a folder for a single thing like the player: that is an entity (create_entity). It goes at the root of a tab (section) or inside another folder (parent_id), and can already take entities (entity_ids), which then inherit its events. Every tab takes subfolders: ambience by place (Forest, Cave), interface by screen (Menus, HUD), effects by kind of thing (Units, Weapons). A small game keeps ambience and interface events straight in the tab, without subfolders. Spends no credits; returns the folder id and its site page (url). To see the existing folders first, use list_folders; to move entities later, move_entities.", "inputSchema": { "properties": { "entity_ids": { "description": "Optional: entities of this game (ids from get_game) to move into the new folder. Up to 500.", "items": { "type": "string" }, "maxItems": 500, "type": "array" }, "game_id": { "description": "The game id, from list_games or create_game.", "type": "string" }, "name": { "description": "The folder name shown on the site, in the game's language (e.g. Enemies, Forest, Menus). Up to 60 characters.", "maxLength": 60, "minLength": 1, "type": "string" }, "parent_id": { "description": "Parent folder (a subfolder of any tab). Without it, the folder goes at the root of section.", "type": "string" }, "section": { "description": "The tab the folder goes in, at its root: ambience, effects (Sound effects), interface or music. Ignored with parent_id. Without both: effects.", "enum": [ "ambience", "effects", "interface", "music" ], "type": "string" } }, "required": [ "game_id", "name" ], "type": "object" }, "name": "create_folder", "outputSchema": null }, { "description": "Creates a game in the account. It's the FIRST step: without a game there are no folders or entities. A new project ALWAYS gets a new game: never reuse an existing game because its name matches the project. If the account has a game with the same or a similar name, the call is refused with the list: ask the user whether to use that game or create a new one (suggest a different name when it is the same, so the user can tell them apart in the lists), and only call again with new_game_confirmed=true after they say so. It's born with the root folders Ambience, Sound effects, Interface, Voices and Music (named in the game's language; template adds ready-made folders by genre). sound_direction is the style that EVERY generation in the game follows (e.g. 'cartoon, dry, no reverb'); profile describes the game (genre, camera, world, tone). language sets the language of the born folders and events (the root folders and the starter events, and the template's folders); set it to the game's own language, which is usually the one the user is writing in. Omit it to follow the account's saved language. folders: the reviewed proposal from suggest_game_setup (each folder with its tab and events), created exactly like the site's \"maximum refinement\"; with from_ai=true the game gets no starter events (the proposal already covers the tabs). Engine godot: before touching the project, ask the user whether to bring the sounds with the plugin or only through the conversation (see the instructions). entities: the things of the game (player, enemies, items) with their events and scene path, created in the same call, so everything the user approved exists at once. kind: 'project' for anything that is not a game (a video, a podcast, an app, an ad...): the same screen and folders on the site, under Projects, with no engine and no plugin, and it never shows in Sounds or Packs; omitted, a game. Returns the id, the game page (url: share it with the user), the entities and the folders created.", "inputSchema": { "properties": { "description": { "maxLength": 500, "type": "string" }, "engine": { "default": "other", "enum": [ "godot", "unity", "unreal", "other" ], "type": "string" }, "entities": { "description": "The things of the game that make noise (player, enemies, items, projectiles), each with its own events, created in the same call. A folder the site assistant proposed for ONE thing (Player, Crab Enemy) goes here as an entity.", "items": { "properties": { "description": { "description": "How it sounds; goes into its prompts.", "maxLength": 400, "type": "string" }, "events": { "items": { "properties": { "durationSec": { "description": "One-shots at least 2 s, loops at least 6 s.", "maximum": 30, "minimum": 2, "type": "number" }, "loop": { "type": "boolean" }, "name": { "maxLength": 60, "type": "string" }, "prompt": { "maxLength": 450, "type": "string" } }, "required": [ "name", "prompt" ], "type": "object" }, "maxItems": 12, "type": "array" }, "external_id": { "description": "Its engine scene (res://player/player.tscn): the plugin sync merges into this entity.", "maxLength": 300, "type": "string" }, "folder": { "description": "Name of the folder it goes in (one of folders, or an existing one like Sound effects). A new name creates that folder inside Sound effects. Omitted: Sound effects.", "maxLength": 60, "type": "string" }, "name": { "maxLength": 80, "type": "string" } }, "required": [ "name" ], "type": "object" }, "maxItems": 60, "type": "array" }, "folders": { "description": "The folders and events to create (the proposal from suggest_game_setup, as the user approved it). Replaces template.", "items": { "properties": { "events": { "items": { "properties": { "durationSec": { "description": "One-shots at least 2 s, loops at least 6 s.", "maximum": 30, "minimum": 2, "type": "number" }, "loop": { "type": "boolean" }, "name": { "maxLength": 60, "type": "string" }, "prompt": { "maxLength": 450, "type": "string" } }, "required": [ "name", "prompt" ], "type": "object" }, "maxItems": 12, "type": "array" }, "name": { "description": "A folder named exactly like its tab puts its events straight in the tab.", "maxLength": 60, "type": "string" }, "section": { "description": "The tab: ambience, effects, interface or music. Omitted: effects.", "enum": [ "ambience", "effects", "interface", "music" ], "type": "string" } }, "required": [ "name" ], "type": "object" }, "maxItems": 16, "type": "array" }, "from_ai": { "default": false, "description": "true when folders come from suggest_game_setup: no starter events on top (Wind, Rain, Click, Error).", "type": "boolean" }, "kind": { "default": "game", "description": "project: not a game (video, podcast, app...). No engine, no plugin, no starter events.", "enum": [ "game", "project" ], "type": "string" }, "language": { "enum": [ "en", "pt-BR" ], "type": "string" }, "name": { "maxLength": 80, "minLength": 1, "type": "string" }, "new_game_confirmed": { "default": false, "description": "true only after the user said, in this conversation, to create a new game although the account has one with the same or a similar name.", "type": "boolean" }, "profile": { "maxLength": 1500, "type": "string" }, "sound_direction": { "maxLength": 1200, "type": "string" }, "template": { "default": "empty", "enum": [ "empty", "strategy", "platformer", "board", "puzzle" ], "type": "string" } }, "required": [ "name" ], "type": "object" }, "name": "create_game", "outputSchema": { "properties": { "folders": { "items": { "properties": { "events": { "type": "array" }, "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name", "events" ], "type": "object" }, "type": "array" }, "id": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" } }, "required": [ "id", "name", "url", "folders" ], "type": "object" } }, { "description": "Creates several tracks at once in the game's Music folder (created with the first track) or in one of its subfolders: free, nothing is generated. Each track has a name (what it is in the game: Main theme, Forest, Boss fight), a prompt (how it sounds, sent to the model as is: English comma-separated tags such as genre, mood, instruments, tempo), a duration, loop AND the same form as generate_music, saved on the track so the site shows it before generating: genres (musical style), bpm, key_scale, time_signature, mode, instrumental/lyrics/language, vocal_level, voice, quality (a genre and a voice are also written into the prompt as words, as the site does). A name that already exists there is UPDATED with what you send (prompt, duration, loop and the form; what you omit stays): use it to fill or fix existing tracks. Returns each track with its page and the cost of generating it, plus the total per quality level: show the user the plan and the total, and after their yes generate them (generate_music with wait=false for each, then job_status).", "inputSchema": { "properties": { "folder_id": { "description": "A subfolder of the Music folder (create_folder with section \"music\"). Omitted: the Music folder itself.", "type": "string" }, "game_id": { "description": "The game id, from list_games or create_game.", "type": "string" }, "tracks": { "description": "The tracks to create or update, 1 to 30. Creating is free; generate each one later with generate_music.", "items": { "properties": { "bpm": { "description": "Compose (\"Andamento\"): tempo in beats per minute (60 to 180 sound best).", "maximum": 300, "minimum": 30, "type": "integer" }, "duration_sec": { "description": "Whole seconds, 10 to 240 (4 min). The user's plan may allow less: the server refuses a longer track. Omitted: 1 min (or the plan limit, if lower).", "maximum": 240, "minimum": 10, "type": "integer" }, "genres": { "description": "Musical style (the site's \"Estilo musical\"): ONE genre as a one-item list. Its words are written at the start of the prompt (empty = only your prompt).", "items": { "enum": [ "folk", "synthwave", "rock", "metal", "thrash", "power", "death", "black", "doom", "pop", "epic", "orchestral", "classical", "choral", "medieval", "celtic", "tribal", "pirate", "western", "japanese", "desert", "chiptune", "electronic", "cyberpunk", "ambient", "horror", "lofi", "comic", "military", "jazz", "hiphop", "blues", "funk", "bossa", "samba", "latin" ], "type": "string" }, "maxItems": 1, "type": "array" }, "instrumental": { "default": true, "description": "false = sung, with the lyrics below.", "type": "boolean" }, "key_scale": { "description": "Compose (\"Tom\"): the key, e.g. \"A minor\".", "enum": [ "C major", "C minor", "C# major", "C# minor", "D major", "D minor", "Eb major", "Eb minor", "E major", "E minor", "F major", "F minor", "F# major", "F# minor", "G major", "G minor", "Ab major", "Ab minor", "A major", "A minor", "Bb major", "Bb minor", "B major", "B minor" ], "type": "string" }, "language": { "description": "Language of the lyrics.", "enum": [ "pt-BR", "en" ], "type": "string" }, "loop": { "description": "true for a track the game repeats (level and menu themes). Default true.", "type": "boolean" }, "lyrics": { "description": "The lyrics, one line per row, parts marked with [Verse], [Chorus], [Bridge]... Only with instrumental=false.", "maxLength": 4096, "type": "string" }, "mode": { "description": "describe = only the prompt; compose = you also set the tempo, key and meter. Omitted: compose when bpm, key_scale, time_signature, genres or sung lyrics are sent, otherwise the track keeps its current mode.", "enum": [ "describe", "compose" ], "type": "string" }, "name": { "description": "What the track is in the game (Main theme, Forest, Boss fight). Up to 60 characters; a name that already exists is updated.", "maxLength": 60, "minLength": 1, "type": "string" }, "prompt": { "description": "How it sounds, sent to the model as written: English comma-separated tags (genre, mood, instruments, tempo).", "maxLength": 512, "minLength": 1, "type": "string" }, "quality": { "description": "draft (fast and cheap, to test the idea), good, high (the approved default), max (large model; may be unavailable). The price per minute follows the level.", "enum": [ "draft", "good", "high", "max" ], "type": "string" }, "time_signature": { "description": "Compose (\"Compasso\"): beats per bar (2, 3 = waltz, 4 = most music, 6 = compound like 6/8).", "enum": [ 2, 3, 4, 6 ], "type": "integer" }, "vocal_level": { "description": "Sung tracks: the voice behind the band (back), even (balanced, default, adds nothing) or up front (front); written at the end of the prompt.", "enum": [ "back", "balanced", "front" ], "type": "string" }, "voice": { "description": "Sung tracks: who sings (gender), how deep (timbre) and up to 2 singing styles, written at the end of the prompt. Omitted: the model picks.", "properties": { "gender": { "enum": [ "male", "female", "duet", "choir" ], "type": "string" }, "styles": { "items": { "enum": [ "breathy", "powerful", "raspy", "falsetto", "spoken", "screamed" ], "type": "string" }, "maxItems": 2, "type": "array" }, "timbre": { "enum": [ "low", "mid", "high" ], "type": "string" } }, "type": "object" } }, "required": [ "name", "prompt" ], "type": "object" }, "maxItems": 30, "minItems": 1, "type": "array" } }, "required": [ "game_id", "tracks" ], "type": "object" }, "name": "create_tracks", "outputSchema": null }, { "description": "Creates ONE voice sound (a character line) in a game, in its Voices folder (\"Vozes\" in Portuguese games), created with the first line. Free: nothing is generated yet. name = what the game calls it (e.g. \"Victory line\", \"Groovy\"); text = exactly what the character says, as written (up to maxChars of list_voices; split longer speeches into several lines). Pick the voice, register and emotion from list_voices; language defaults to the game's. Returns the sound page (url) and the cost per version; then ask the user and generate it with generate_voice.", "inputSchema": { "properties": { "emotion": { "description": "calmo (calm), normal (the default) or intenso (intense).", "enum": [ "calmo", "normal", "intenso" ], "type": "string" }, "game_id": { "description": "The game id, from list_games or create_game.", "type": "string" }, "language": { "description": "Language of the line. Omitted: the game's language.", "enum": [ "pt-BR", "en" ], "type": "string" }, "name": { "description": "The sound name the game calls (e.g. \"Victory line\").", "maxLength": 60, "minLength": 1, "type": "string" }, "register": { "description": "coloquial (loose, the default), conversa (conversational) or formal (read). A voice without the register speaks formal.", "enum": [ "coloquial", "conversa", "formal" ], "type": "string" }, "text": { "description": "The exact line the character says.", "maxLength": 500, "minLength": 1, "type": "string" }, "voice_id": { "description": "A voice id from list_voices. Omitted: the first voice of the library.", "type": "string" } }, "required": [ "game_id", "name", "text" ], "type": "object" }, "name": "create_voice", "outputSchema": null }, { "description": "Deletes a sound (event) or a track for good, with its versions, like the Delete button on its page: the game stops playing it. Versions that are favorites or also chosen in another sound stay there. While it has a generation queued or running, it is refused: wait for it (job_status). ONLY when the user asked, in this conversation, to delete THIS sound (say its name and game before); never to tidy up on your own, never several at once without listing them and getting a yes. name must be the sound's current name, as a check.", "inputSchema": { "properties": { "event_id": { "description": "The sound (event) or track to delete, from get_entity, find_sounds or list_folders.", "type": "string" }, "name": { "description": "The sound's current name (from find_sounds or list_folders): if it does not match, nothing is deleted.", "type": "string" } }, "required": [ "event_id", "name" ], "type": "object" }, "name": "delete_sound", "outputSchema": null }, { "description": "Makes a NEW version of a track from an existing version (spends credits: refused until the user approved the cost, see approve_spending). origin=repaint regenerates only the section [start, end] seconds (at least 3 s) and keeps the rest; origin=extend adds `seconds` of new music after the end, in the same mood (the final length must fit the user's plan); origin=cover makes a similar track from this one (closeness: close, medium or loose). `note` says what should change and is added to the end of the source prompt as written, so write it in English tags. Lyrics, tempo and key come from the source version. Charges the generated seconds (the section, the tail; cover charges the whole track) at the version's quality level. Same response as generate_music.", "inputSchema": { "properties": { "auto_choose": { "default": true, "description": "true (default): if the event has no chosen version yet, the new one becomes chosen, so the game plays it. false leaves the choice to the user.", "type": "boolean" }, "closeness": { "description": "cover: how close to the source (default medium).", "enum": [ "close", "medium", "loose" ], "type": "string" }, "end": { "description": "repaint: end of the section, in seconds (at least 3 s after start).", "minimum": 0, "type": "number" }, "note": { "description": "What should change, added to the source prompt as is (English tags).", "maxLength": 512, "type": "string" }, "origin": { "description": "repaint: regenerates only the section from start to end; extend: adds `seconds` of music after the end; cover: makes a similar track.", "enum": [ "repaint", "extend", "cover" ], "type": "string" }, "quality": { "description": "Quality level; omitted: the track's current level.", "enum": [ "draft", "good", "high", "max" ], "type": "string" }, "seconds": { "description": "extend: how many seconds to add (3 to 90; more, in steps). The final length must fit the plan: up to 4 min for this account.", "maximum": 90, "minimum": 3, "type": "integer" }, "start": { "description": "repaint: start of the section, in seconds.", "minimum": 0, "type": "number" }, "version_id": { "description": "The source version (a generationId of a track from generate_music, get_entity or find_sounds).", "type": "string" }, "wait": { "default": true, "description": "false = only queues it and returns the jobId for job_status (see generate_music).", "type": "boolean" } }, "required": [ "version_id", "origin" ], "type": "object" }, "name": "derive_music", "outputSchema": { "properties": { "created": { "type": "integer" }, "credits": { "type": "integer" }, "generationIds": { "items": { "type": "string" }, "type": "array" }, "refunded": { "type": "integer" }, "studioUrl": { "type": "string" }, "url": { "type": "string" } }, "required": [ "created", "refunded", "credits", "generationIds", "url", "studioUrl" ], "type": "object" } }, { "description": "For the user to download all the chosen sounds at once (other engines, or when they ask). Link to the .zip with the game's CHOSEN sounds and the manifest.json (neutral format for any engine): show it to the user, who opens it in any browser (it works for 24 hours). In Godot, the plugin installs it directly. An event with more than one sound (e.g. 3 sword hits) must be played by picking one of its files at random each time, never only the first: write the playback code that way and tell the user. Download tools: export_game gives the whole game as one .zip; get_manifest lists every chosen file with its project path (to save them one by one, or for a plugin); save_sound gives one single file.", "inputSchema": { "properties": { "game_id": { "description": "The game id, from list_games or create_game.", "type": "string" } }, "required": [ "game_id" ], "type": "object" }, "name": "export_game", "outputSchema": null }, { "description": "Searches entities (units, mobs, buildings, screens) by name, game, event or prompt, ignoring accents/case, and returns EVERYTHING about each one: image, events (Attack, Death...), each generated variation with id, prompt used, duration, cost, date, whether it's the chosen one, the audio URL and the editor link (editUrl), plus the page of the entity and of each event on the site (url). Also finds folder events (music, ambience, interface sounds like 'Main theme' or 'Click') by event name, prompt or folder name. Use it whenever the user talks about the sounds of something (e.g. 'the dragon sounds') or asks for the link of a sound: give the event's url. A track (Music folder) also shows what is saved in its form (track: mode, quality, genre, bpm, key) and the tags of its downloaded file (music: artist, title, album).", "inputSchema": { "properties": { "include_images": { "default": true, "description": "Attach each entity's image (up to 3).", "type": "boolean" }, "query": { "description": "Name or part of the name. E.g. 'dragon', 'castle', 'attack'.", "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "query" ], "type": "object" }, "name": "find_sounds", "outputSchema": null }, { "description": "How much of the game already has a chosen sound (what goes into the game), in % and per tab (Ambience, Sound effects, Interface), and EVERY missing event, with its id. Call it at the end of any setup or bulk generation and whenever the user asks what's missing. Below 100%: show what's missing and the cost to complete it, and ask whether to generate.", "inputSchema": { "properties": { "game_id": { "description": "The game id, from list_games or create_game.", "type": "string" } }, "required": [ "game_id" ], "type": "object" }, "name": "game_progress", "outputSchema": null }, { "description": "What the engine plugin synced into the game: when the last sync was, the scenes waiting in the Inbox (not in any tab yet; each has a suggested tab from its project path) and the scenes that are already entities, with their folder. Call it after the user clicks Sync in the plugin, to confirm it worked, and before creating entities by hand for a Godot game: a synced scene must not be created twice. Inbox not empty: place them with place_scenes. Plugin flow, in order: sync_scenes (the plugin sends its scenes), game_scenes (see what arrived), place_scenes (turn them into entities), mark_installed (the plugin reports the install).", "inputSchema": { "properties": { "game_id": { "description": "The game id, from list_games or create_game.", "type": "string" } }, "required": [ "game_id" ], "type": "object" }, "name": "game_scenes", "outputSchema": { "properties": { "entities": { "items": { "properties": { "externalId": { "type": "string" }, "folder": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "externalId", "name", "folder" ], "type": "object" }, "type": "array" }, "inbox": { "items": { "properties": { "description": { "type": "string" }, "externalId": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "suggestedSection": { "type": "string" } }, "required": [ "id", "externalId", "name", "description", "suggestedSection" ], "type": "object" }, "type": "array" }, "syncedAt": { "type": [ "string", "null" ] } }, "required": [ "syncedAt", "inbox", "entities" ], "type": "object" } }, { "description": "Generates ONE version of a track for an event of the Music tab (spends credits: refused until the user approved the cost in the conversation, see approve_spending). Without prompt/duration/loop, uses the event's. The prompt goes to the music model exactly as written (nothing is rewritten or added behind it), so write it in English as comma-separated tags: genre, mood, instruments, tempo, production (e.g. \"medieval folk, lute, warm, 90 bpm, intimate\"). A genre, voice or vocal_level you pass is written into the prompt as words (genre first, voice last). Parts, bpm, key_scale and time_signature are optional structure. Instrumental by default; with lyrics, pass them with [Verse]/[Chorus] tags, or ask the user to write them on the site. The duration must fit the user's plan: duration_sec says this account's limit, never ask for more. A track takes minutes: the tool waits up to 10 minutes and, if still generating, tells you to check later; with wait=false it only queues and returns a jobId for job_status (use it for several tracks: queue them all, the account generates one at a time). Before the FIRST track, the user must accept the rights notice on the site (the tool says so). Returns the new version (with the music page url), like generate_sounds. The game only plays chosen versions: if the event has none yet, the new one becomes chosen (auto_choose=false turns this off).", "inputSchema": { "properties": { "auto_choose": { "default": true, "description": "true (default): if the event has no chosen version yet, the new one becomes chosen, so the game plays it. false leaves the choice to the user.", "type": "boolean" }, "bpm": { "description": "Compose (\"Andamento\"): tempo in beats per minute (60 to 180 sound best).", "maximum": 300, "minimum": 30, "type": "integer" }, "duration_sec": { "description": "Whole seconds, 10 to 240 (4 min). The user's plan may allow less: the server refuses a longer track.", "maximum": 240, "minimum": 10, "type": "integer" }, "event_id": { "description": "An event in the Music tab (root folder of kind \"music\", its subfolders or entities).", "type": "string" }, "genres": { "description": "Musical style (the site's \"Estilo musical\"): ONE genre as a one-item list. Its words are written at the start of the prompt (empty = only your prompt).", "items": { "enum": [ "folk", "synthwave", "rock", "metal", "thrash", "power", "death", "black", "doom", "pop", "epic", "orchestral", "classical", "choral", "medieval", "celtic", "tribal", "pirate", "western", "japanese", "desert", "chiptune", "electronic", "cyberpunk", "ambient", "horror", "lofi", "comic", "military", "jazz", "hiphop", "blues", "funk", "bossa", "samba", "latin" ], "type": "string" }, "maxItems": 1, "type": "array" }, "instrumental": { "default": true, "description": "false = sung, with the lyrics below.", "type": "boolean" }, "key_scale": { "description": "Compose (\"Tom\"): the key, e.g. \"A minor\".", "enum": [ "C major", "C minor", "C# major", "C# minor", "D major", "D minor", "Eb major", "Eb minor", "E major", "E minor", "F major", "F minor", "F# major", "F# minor", "G major", "G minor", "Ab major", "Ab minor", "A major", "A minor", "Bb major", "Bb minor", "B major", "B minor" ], "type": "string" }, "language": { "description": "Language of the lyrics.", "enum": [ "pt-BR", "en" ], "type": "string" }, "loop": { "description": "true = the end is blended into the start, for a track the game repeats. Saved on the event.", "type": "boolean" }, "lyrics": { "description": "The lyrics, one line per row, parts marked with [Verse], [Chorus], [Bridge]... Only with instrumental=false.", "maxLength": 4096, "type": "string" }, "mode": { "description": "describe = only the prompt; compose = you also set the tempo, key and meter. Omitted: compose when bpm, key_scale, time_signature, genres or sung lyrics are sent, otherwise the track keeps its current mode.", "enum": [ "describe", "compose" ], "type": "string" }, "prompt": { "description": "How it sounds, sent to the model as is: English tags (genre, mood, instruments, tempo, production).", "maxLength": 512, "minLength": 1, "type": "string" }, "quality": { "description": "draft (fast and cheap, to test the idea), good, high (the approved default), max (large model; may be unavailable). The price per minute follows the level.", "enum": [ "draft", "good", "high", "max" ], "type": "string" }, "time_signature": { "description": "Compose (\"Compasso\"): beats per bar (2, 3 = waltz, 4 = most music, 6 = compound like 6/8).", "enum": [ 2, 3, 4, 6 ], "type": "integer" }, "vocal_level": { "description": "Sung tracks: the voice behind the band (back), even (balanced, default, adds nothing) or up front (front); written at the end of the prompt.", "enum": [ "back", "balanced", "front" ], "type": "string" }, "voice": { "description": "Sung tracks: who sings (gender), how deep (timbre) and up to 2 singing styles, written at the end of the prompt. Omitted: the model picks.", "properties": { "gender": { "enum": [ "male", "female", "duet", "choir" ], "type": "string" }, "styles": { "items": { "enum": [ "breathy", "powerful", "raspy", "falsetto", "spoken", "screamed" ], "type": "string" }, "maxItems": 2, "type": "array" }, "timbre": { "enum": [ "low", "mid", "high" ], "type": "string" } }, "type": "object" }, "wait": { "default": true, "description": "true = waits for the track (up to 10 min). false = only puts it in the queue and answers at once with the jobId: for several tracks, queue them all with wait=false (the account generates one at a time, the rest wait their turn) and check them with job_status.", "type": "boolean" } }, "required": [ "event_id" ], "type": "object" }, "name": "generate_music", "outputSchema": { "properties": { "created": { "type": "integer" }, "credits": { "type": "integer" }, "generationIds": { "items": { "type": "string" }, "type": "array" }, "refunded": { "type": "integer" }, "studioUrl": { "type": "string" }, "url": { "type": "string" } }, "required": [ "created", "refunded", "credits", "generationIds", "url", "studioUrl" ], "type": "object" } }, { "description": "Generates sound variations for an event (spends credits: refused until the user approved the cost in the conversation, see approve_spending). Without prompt/duration/loop, uses the event's. LOOP OR ONE-SHOT, decided from what the sound is in the game: a LOOP is anything that lasts while something keeps happening and the game plays on repeat: ambience and weather, music, engines and machines, fire burning, flowing water, AND movement cycles: footsteps, walking, running, crawling, galloping, sustained wing flapping, rolling. Footsteps are a walk cycle with several steps (6-10 s), never a single step. A ONE-SHOT is one discrete action: hit, swing, click, cry, death, explosion, door, item, sting. DURATION: one-shots at least 2 s even for a tiny click, since shorter clips come out thin (hits, clicks and swings 2 s; cries, deaths, collapses and stings 3-5 s); movement loops 6-10 s; ambience, engine and fire loops 10-16 s. A music TRACK (Music folder) is not a sound effect: it is generated with generate_music and lasts up to the user's plan limit (generate_music duration_sec says it), usually 1-3 min for a theme and 30-60 s for a short loop. The server refuses one-shots under 2 s and loops under 6 s. COST = seconds rounded up × the account price per second (creditsPerSecond in list_games) × variations. The request can be in any language: the AI understands it and describes the sound for the generator (exact=true: translate only, literal). Returns the new variations (each with its editor link), the event page (url) and the game's studio (studioUrl). The game only plays chosen sounds: if the event has none yet, ALL the new variations become chosen and the game picks one at random (auto_choose=false turns this off; voice lines are never chosen automatically, generate them with generate_voice); an existing choice doesn't change. To switch or trim the list, use choose_sound.", "inputSchema": { "properties": { "auto_choose": { "default": true, "description": "true (default): if the event has no chosen sound yet, all the new variations become chosen and the game picks one at random. false leaves the choice to the user.", "type": "boolean" }, "channels": { "description": "Audio channels. auto (default): mono for everything the game positions (footsteps, hits, creatures, interface), stereo for Ambience backgrounds and for music in any folder. stereo: for a sound that does not come from a spot on the map (a sting, a screen whoosh). The choice is saved on the event.", "enum": [ "auto", "mono", "stereo" ], "type": "string" }, "duration_sec": { "description": "One-shot at least 2 s; movement loops 6-10 s; ambience 10-16 s. A music track is generate_music, not this.", "maximum": 30, "minimum": 2, "type": "number" }, "event_id": { "description": "The event to generate in, from create_event, get_entity, find_sounds or list_folders.", "type": "string" }, "exact": { "description": "true = literal mode: only translates to English, without the AI filling out the description.", "type": "boolean" }, "loop": { "description": "true for anything continuous the game repeats (ambience, music, engines, fire, footsteps, running, flapping). Saved on the event.", "type": "boolean" }, "prompt": { "description": "Description of the sound, preferably in English.", "maxLength": 450, "minLength": 1, "type": "string" }, "variations": { "description": "If omitted: 1 for a looping sound (ambience), 3 for everything else.", "maximum": 4, "minimum": 1, "type": "integer" } }, "required": [ "event_id" ], "type": "object" }, "name": "generate_sounds", "outputSchema": { "properties": { "created": { "type": "integer" }, "credits": { "type": "integer" }, "generationIds": { "items": { "type": "string" }, "type": "array" }, "refunded": { "type": "integer" }, "studioUrl": { "type": "string" }, "url": { "type": "string" } }, "required": [ "created", "refunded", "credits", "generationIds", "url", "studioUrl" ], "type": "object" } }, { "description": "Generates versions (1 to 4) of a voice line created with create_voice, with its text, voice, register and emotion (spends credits: refused until the user approved the cost in the conversation, see approve_spending). A line costs its estimated seconds (characters / charsPerSecond of list_voices, at least 1 s) × creditsPerSecond × versions. Voice versions are NEVER chosen automatically, not even the first ones: the user must listen to them on the site and pick the ones that go to the game. Returns the new versions and the sound page (url): give the user that link and tell them to listen and choose there.", "inputSchema": { "properties": { "event_id": { "description": "The voice line (the id create_voice returned).", "type": "string" }, "variations": { "description": "How many versions. Omitted: 3.", "maximum": 4, "minimum": 1, "type": "integer" } }, "required": [ "event_id" ], "type": "object" }, "name": "generate_voice", "outputSchema": null }, { "description": "Reads one entity (a thing of the game that makes noise) with everything about its sounds: its image, its events and every generated variation of each event (prompt, duration, chosen or not, audio link). Also returns the site pages to give the user: the entity (url: opens it, with its sound cards), each event (url: the player to listen, choose, trim and combine) and each variation's editor (editUrl). Read-only, costs nothing. Use it before choose_sound, save_sound or generating again, to see what already exists. To find an entity's id, use get_game; for the events of a folder, list_folders.", "inputSchema": { "properties": { "entity_id": { "description": "The entity id, from get_game or create_entity.", "type": "string" }, "include_image": { "default": true, "description": "Sends the entity image along (default true). false saves tokens when you only need the sounds.", "type": "boolean" } }, "required": [ "entity_id" ], "type": "object" }, "name": "get_entity", "outputSchema": { "properties": { "entity": { "properties": { "events": { "items": { "properties": { "chosenGenerationIds": { "type": "array" }, "durationSec": { "type": "number" }, "generations": { "items": { "properties": { "audioUrl": { "type": [ "string", "null" ] }, "chosen": { "type": "boolean" }, "durationSec": { "type": "number" }, "editUrl": { "type": "string" }, "id": { "type": "string" }, "prompt": { "type": "string" } }, "required": [ "id", "prompt", "durationSec", "chosen", "audioUrl", "editUrl" ], "type": "object" }, "type": "array" }, "id": { "type": "string" }, "name": { "type": "string" }, "prompt": { "type": "string" }, "shared": { "type": "array" }, "source": { "type": "string" }, "url": { "type": "string" } }, "required": [ "id", "name", "url", "source", "prompt", "durationSec", "chosenGenerationIds", "shared", "generations" ], "type": "object" }, "type": "array" }, "folderPath": { "type": "array" }, "id": { "type": "string" }, "imageUrl": { "type": [ "string", "null" ] }, "name": { "type": "string" }, "url": { "type": "string" } }, "required": [ "id", "name", "url", "folderPath", "imageUrl", "events" ], "type": "object" } }, "required": [ "entity" ], "type": "object" } }, { "description": "Reads one game: its settings (engine, description, visibility, sound direction), its entities (the things that make noise, like the player or an enemy) with how many of their events already have a chosen sound, and the inbox (scenes the engine plugin sent that are not placed yet). Returns the site link (url) of the game and of each entity. Read-only, costs nothing. Use it after list_games to see what is inside a game. For an entity's events and versions use get_entity; for folders and folder events, list_folders; for what is still missing, game_progress.", "inputSchema": { "properties": { "game_id": { "description": "The game id, from list_games or create_game.", "type": "string" } }, "required": [ "game_id" ], "type": "object" }, "name": "get_game", "outputSchema": { "properties": { "entities": { "items": { "properties": { "doneCount": { "type": "integer" }, "externalId": { "type": [ "string", "null" ] }, "id": { "type": "string" }, "name": { "type": "string" }, "slotCount": { "type": "integer" }, "url": { "type": "string" } }, "required": [ "id", "name", "externalId", "slotCount", "doneCount", "url" ], "type": "object" }, "type": "array" }, "game": { "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" } }, "required": [ "id", "name", "url" ], "type": "object" }, "inbox": { "items": { "properties": { "externalId": { "type": "string" }, "name": { "type": "string" } }, "required": [ "externalId", "name" ], "type": "object" }, "type": "array" } }, "required": [ "game", "entities", "inbox" ], "type": "object" } }, { "description": "For engine plugins, and for you when the user chose to bring the sounds only through the conversation (save each sound to its suggested path, next to its scene; never before that choice): the game's CHOSEN sounds in the neutral manifest format (gomo-sounds/manifest@1), each with a download link valid for 24 hours and the suggested path in the project. To hand the user a ready .zip, use export_game. An event with more than one sound (e.g. 3 sword hits) must be played by picking one of its files at random each time, never only the first: write the playback code that way and tell the user. Download tools: export_game gives the whole game as one .zip; get_manifest lists every chosen file with its project path (to save them one by one, or for a plugin); save_sound gives one single file.", "inputSchema": { "properties": { "game_id": { "description": "The game id, from list_games or create_game.", "type": "string" } }, "required": [ "game_id" ], "type": "object" }, "name": "get_manifest", "outputSchema": { "properties": { "format": { "type": "string" }, "game": { "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name" ], "type": "object" }, "sounds": { "items": { "properties": { "artist": { "type": [ "string", "null" ] }, "bpms": { "items": { "type": [ "integer", "null" ] }, "type": "array" }, "entity": { "type": "string" }, "event": { "type": "string" }, "externalId": { "type": [ "string", "null" ] }, "fileIds": { "items": { "type": "string" }, "type": "array" }, "files": { "items": { "type": "string" }, "type": "array" }, "generationIds": { "items": { "type": "string" }, "type": "array" }, "key": { "type": "string" }, "loops": { "items": { "type": "boolean" }, "type": "array" }, "path": { "type": "string" }, "paths": { "items": { "type": "string" }, "type": "array" }, "title": { "type": [ "string", "null" ] } }, "required": [ "key", "entity", "externalId", "event", "files", "fileIds", "generationIds", "loops", "paths", "path" ], "type": "object" }, "type": "array" } }, "required": [ "format", "game", "sounds" ], "type": "object" } }, { "description": "The kit to put the Gomo Sounds plugin into the user's Godot project, with the rules to do it without breaking anything, AND the version check: call it only when the user chose the plugin (it is optional: the conversation alone also works) or asks for it, and ALWAYS before telling the user to Sync or to Install sounds. Returns the current version, the versions the plugin of this account has reported (installed) with the verdict (status: up_to_date, outdated, blocked, unknown), the .zip link, the folder it goes to, whether the plan allows connecting it, and the steps: YOU download and extract it (after the user says yes), the USER enables it in Godot and connects (once per computer); then you offer to bring the project scenes in as entities (asking about images) and confirm with game_scenes. Also compare with addons/gomo_sounds/plugin.cfg in the project when you can read it. Never delete the addons folder or any project file.", "inputSchema": { "properties": { "game_id": { "description": "The game the project will link to (its name is what the user picks in the dock). Optional.", "type": "string" } }, "type": "object" }, "name": "godot_plugin", "outputSchema": { "properties": { "docsUrl": { "type": "string" }, "downloadUrl": { "type": "string" }, "folder": { "type": "string" }, "game": { "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name" ], "type": [ "object", "null" ] }, "installed": { "items": { "properties": { "key": { "type": "string" }, "lastUsedAt": { "type": [ "string", "null" ] }, "version": { "type": "string" } }, "required": [ "version", "key", "lastUsedAt" ], "type": "object" }, "type": "array" }, "minimum": { "type": "string" }, "planOk": { "type": "boolean" }, "plansUrl": { "type": "string" }, "status": { "enum": [ "up_to_date", "outdated", "blocked", "unknown" ], "type": "string" }, "steps": { "items": { "type": "string" }, "type": "array" }, "version": { "type": "string" } }, "required": [ "version", "minimum", "downloadUrl", "folder", "docsUrl", "planOk", "plansUrl", "status", "installed", "game", "steps" ], "type": "object" } }, { "description": "The full rules of Gomo Sounds: how games, folders, entities and events work, loop and duration, cost and the yes before spending, the two doors of a new game, the quality bar, Godot (plugin or only the conversation), links and downloads. Call it FIRST in every conversation, before any other tool, and follow it.", "inputSchema": { "properties": {}, "type": "object" }, "name": "gomo_guide", "outputSchema": null }, { "description": "Where the user's generations are: pass the jobIds from generate_music/derive_music with wait=false (or omit job_ids to list every unfinished one of the account). Each job is waiting (its turn in the account's queue: the account generates one track at a time and the rest follow on their own), queued (with the engine), running, done (with the new versions; if the event had no chosen version, the new one was chosen when it finished, like wait=true) or failed (the reason; nothing is charged for a failure). A track takes minutes: check every few minutes, not in a loop, and tell the user the music pages meanwhile.", "inputSchema": { "properties": { "job_ids": { "description": "The jobIds to check (up to 50). Omitted: every unfinished generation of the account.", "items": { "type": "string" }, "maxItems": 50, "type": "array" } }, "type": "object" }, "name": "job_status", "outputSchema": null }, { "description": "Reads the folder tree of one game, one line per folder (path and id), with each folder's events: name, id, ✓ when a sound is chosen, duration and loop, and for a Music track the settings saved in its form (mode, quality, genre, bpm, key, beats per bar, sung or instrumental). Entities inside a folder inherit its events. Read-only, costs nothing. Use it to find a folder_id or parent_id before create_folder, create_event, create_entity or move_entities, and to see Ambience, Interface and Music sounds, which live in folders. For the entities themselves use get_game.", "inputSchema": { "properties": { "game_id": { "description": "The game id, from list_games or create_game.", "type": "string" } }, "required": [ "game_id" ], "type": "object" }, "name": "list_folders", "outputSchema": null }, { "description": "The account's games and projects (kind: game or project; a project is the same thing for anything that is not a game) with how much is in each (entities, events and generated sounds; a game can have every sound in folder events and no entity), the credit balance and the prices: account.creditsPerSecond for sounds, account.music.creditsPerMinute per quality level for tracks (cost = seconds × that ÷ 60, rounded up). Each game has its page on the site (url): when you mention a game, give the user its link. Read-only, costs nothing. Call it at the start to find the game id the other tools need and to see the balance before quoting a cost; for what is inside one game, use get_game.", "inputSchema": { "properties": {}, "type": "object" }, "name": "list_games", "outputSchema": { "properties": { "account": { "properties": { "credits": { "type": "integer" }, "creditsPerSecond": { "type": "integer" }, "music": { "properties": { "creditsPerMinute": { "description": "Quality level => credits per minute of music (only levels available now).", "type": "object" }, "defaultQuality": { "type": "string" }, "maxSeconds": { "type": "integer" } }, "type": "object" }, "plan": { "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name" ], "type": "object" }, "user": { "properties": { "email": { "type": "string" }, "name": { "type": "string" } }, "required": [ "name", "email" ], "type": "object" } }, "required": [ "user", "credits", "creditsPerSecond", "plan" ], "type": "object" }, "games": { "items": { "properties": { "engine": { "type": "string" }, "entityCount": { "type": "integer" }, "eventCount": { "type": "integer" }, "id": { "type": "string" }, "kind": { "enum": [ "game", "project" ], "type": "string" }, "name": { "type": "string" }, "soundCount": { "type": "integer" }, "url": { "type": "string" }, "visibility": { "type": "string" } }, "required": [ "id", "name", "engine", "visibility", "kind", "url", "entityCount", "eventCount", "soundCount" ], "type": "object" }, "type": "array" } }, "required": [ "account", "games" ], "type": "object" } }, { "description": "The voice library for character lines (voice sounds): each voice with its id, name, who it is (person: homem = man, mulher = woman, menino = boy, menina = girl), style (personagem = character, narracao = narrator), a description in the user's language, the registers it has (coloquial = loose, the default; conversa = conversational; formal = read) and sample links per register and language. Also the emotions (calmo = calm, normal, intenso = intense), the languages (pt-BR, en), the longest line (maxChars) and the price (a line is charged by its estimated seconds: characters / charsPerSecond, at least 1 s, × creditsPerSecond × versions). available=false: voice is off, do not offer it. Read-only, costs nothing. Call it before create_voice to pick the voice, register and emotion, and to quote the cost of a line.", "inputSchema": { "properties": {}, "type": "object" }, "name": "list_voices", "outputSchema": null }, { "description": "For a one-off sound that does not belong to a game or project the user is making (\"make me a coin sound\", \"I need a rain loop\", a single track). Returns the account's \"My sounds\" project (the same place as the sound field on the site's home), created on the first call: its id, its page (url) and its root folders (Ambience, Sound effects, Interface, Voices, Music). Then use the usual tools with that id: create_event in the right folder and generate_sounds, generate_music or generate_voice (same cost rules: the user approves the exact total first). Loose sounds DO NOT go to Godot: the plugin only works with games. If the user wants the sound in a Godot project, or is making a game, use create_game instead (a sound already made here can be brought to a game on the site, with \"Bring from another game\"). A video, podcast or app with several sounds is a project (create_game with kind=project), not loose sounds. My sounds has no entities (only games and projects do) and no choosing (every version of a loose sound IS the sound: it all shows when public and downloads together; delete the versions the user does not want), and each loose sound is public or private on its own (public on the free plan; on a paid plan the user picks it with the padlock on the site; until the user picks once on the site Home, new loose sounds stay private): a public one shows in the Community list, in Sounds and on Home.", "inputSchema": { "properties": {}, "type": "object" }, "name": "loose_sounds", "outputSchema": { "properties": { "folders": { "items": { "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "tab": { "type": "string" } }, "required": [ "id", "name", "tab" ], "type": "object" }, "type": "array" }, "id": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" } }, "required": [ "id", "name", "url", "folders" ], "type": "object" } }, { "description": "For engine plugins: tells the site the chosen sounds were installed in the project now, so the site can show which changes already reached the game. Plugin flow, in order: sync_scenes (the plugin sends its scenes), game_scenes (see what arrived), place_scenes (turn them into entities), mark_installed (the plugin reports the install).", "inputSchema": { "properties": { "game_id": { "description": "The game id, from list_games or create_game.", "type": "string" } }, "required": [ "game_id" ], "type": "object" }, "name": "mark_installed", "outputSchema": { "properties": { "id": { "type": "string" }, "installedAt": { "type": "string" } }, "required": [ "id", "installedAt" ], "type": "object" } }, { "description": "Moves entities of one game into a folder (folder_id), or out of their folder (empty folder_id: back to Sound effects). In the new folder they inherit its events and stop inheriting the old folder's; their own events and sounds stay. Spends no credits, and moving again to the same folder changes nothing. Use it to reorganize after create_entity or place_scenes; find folder ids with list_folders and entity ids with get_game. To make a new group, create_folder can take the entities at once.", "inputSchema": { "properties": { "entity_ids": { "description": "The entities to move, all from the same game (ids from get_game).", "items": { "type": "string" }, "maxItems": 500, "minItems": 1, "type": "array" }, "folder_id": { "description": "The destination folder (from list_folders). Empty or omitted: back to the root of Sound effects.", "type": "string" } }, "required": [ "entity_ids" ], "type": "object" }, "name": "move_entities", "outputSchema": null }, { "description": "Turns scenes waiting in the game's Inbox (sent by the engine plugin; see game_scenes) into entities in a tab, exactly like dragging them on the site. section auto (default) puts each scene by its project path: ui/ or menus/ to Interface, maps/ or levels/ to Ambience, the rest in Sound effects inside a folder named after the project folder (res://units/x.tscn goes to Units). Or choose the tab (ambience, effects, interface) and, inside it, a folder_id. Without item_ids, every scene in the Inbox. Plugin flow, in order: sync_scenes (the plugin sends its scenes), game_scenes (see what arrived), place_scenes (turn them into entities), mark_installed (the plugin reports the install).", "inputSchema": { "properties": { "folder_id": { "description": "A folder inside the chosen tab (not with auto). Omitted: the root of the tab.", "type": "string" }, "game_id": { "description": "The game id, from list_games or create_game.", "type": "string" }, "item_ids": { "description": "Inbox ids from game_scenes. Omitted: all of them.", "items": { "type": "string" }, "maxItems": 500, "type": "array" }, "section": { "default": "auto", "description": "auto (by project path) or the tab: ambience, effects, interface.", "enum": [ "auto", "ambience", "effects", "interface" ], "type": "string" } }, "required": [ "game_id" ], "type": "object" }, "name": "place_scenes", "outputSchema": { "properties": { "entities": { "items": { "properties": { "externalId": { "type": "string" }, "folder": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "url": { "type": "string" } }, "required": [ "id", "externalId", "name", "folder", "url" ], "type": "object" }, "type": "array" }, "placed": { "type": "integer" } }, "required": [ "placed", "entities" ], "type": "object" } }, { "description": "Only when the user asked for the file or chose to bring the sounds only through the conversation; never to put files into their project before that. Link to download an audio file FROM YOUR ACCOUNT (audio URL from find_sounds/get_entity): show it to the user, who opens it in the browser (it works without logging in, for 24 hours). Community sounds (the Sounds page of the site) belong to other accounts and do NOT come out through here: tell the user to open /sounds on the site and download there (free, with an account) or generate their own. An event with more than one sound (e.g. 3 sword hits) must be played by picking one of its files at random each time, never only the first: write the playback code that way and tell the user. Download tools: export_game gives the whole game as one .zip; get_manifest lists every chosen file with its project path (to save them one by one, or for a plugin); save_sound gives one single file.", "inputSchema": { "properties": { "audio_url": { "description": "An audioUrl from find_sounds or get_entity (a file of this account).", "type": "string" }, "file_name": { "description": "Name of the downloaded file, e.g. Attack - Golem", "maxLength": 80, "type": "string" } }, "required": [ "audio_url" ], "type": "object" }, "name": "save_sound", "outputSchema": null }, { "description": "Changes who can see a game. public: its chosen sounds show in the site's Community list (Home and Sounds), with the owner's @username. private: only the owner sees it; needs a paid plan, and on the free plan the call fails with a message to show the user. Doesn't touch the sounds or spend credits, and calling it again with the same value changes nothing. Only call it when the user asks to lock or open the game.", "inputSchema": { "properties": { "game_id": { "description": "The game id, from list_games.", "type": "string" }, "visibility": { "description": "public (its sounds in the Community list) or private (owner only, paid plan).", "enum": [ "public", "private" ], "type": "string" } }, "required": [ "game_id", "visibility" ], "type": "object" }, "name": "set_game_visibility", "outputSchema": null }, { "description": "Sets the style rules every generation follows, so the game's sounds match (materials, what to avoid, duration, mixing). With game_id it applies to the whole game; with folder_id, to everything inside the folder (added to the game's). Empty text clears it. The text replaces what was there and guides only the next generations: existing sounds stay as they are. Spends no credits. Use it when the user describes the style of the game's audio, before generating; create_game already takes sound_direction for a new game.", "inputSchema": { "properties": { "folder_id": { "description": "A folder (from list_folders): the rules apply to everything inside it, on top of the game's. Pass game_id OR folder_id.", "type": "string" }, "game_id": { "description": "The game whose rules you set (from list_games). Pass game_id OR folder_id.", "type": "string" }, "text": { "description": "The style rules as plain text (materials, what to avoid, duration, mixing), e.g. 'cartoon, dry, no reverb'. Empty text clears them.", "maxLength": 1200, "type": "string" } }, "required": [ "text" ], "type": "object" }, "name": "set_sound_direction", "outputSchema": null }, { "description": "Makes several events of the same game play the sound of one variation's event (e.g. the same 'Building' sound on all buildings), instead of generating one sound per event. Live link: changing the sound on the original changes it everywhere; the variation joins the original's list if it wasn't there yet. The sounds the target events had are removed from their lists, so ask the user first if they already have chosen sounds. Doesn't generate or spend credits. Pass event_ids, or same_name=true to reach every event in the game with the source event's name. For one sound shared by all entities of a folder, a folder event (create_event with folder_id) is simpler.", "inputSchema": { "properties": { "event_ids": { "default": [], "description": "The events that will play the same sound (ids from get_entity or list_folders), in the same game. Up to 500.", "items": { "type": "string" }, "maxItems": 500, "type": "array" }, "generation_id": { "description": "A variation of the source event (generation id, from get_entity). Its event becomes the original.", "type": "string" }, "same_name": { "default": false, "description": "true also adds every event in the game with the source event's name (default false).", "type": "boolean" } }, "required": [ "generation_id" ], "type": "object" }, "name": "share_sound", "outputSchema": null }, { "description": "Creates the event event_name on EACH entity in a folder (and subfolders) and generates each one's sound, with its own prompt: {entity} and {description} in the prompt become each entity's name and description. WITHOUT max_credits it only plans: returns the entities, the total cost and the balance, without spending anything. Show the user and, with their OK, call again with max_credits equal to the cost. An entity that already has an event with that name uses the existing one. An event with no chosen sound gets ALL the new variations chosen, so the game picks one at random (auto_choose=false turns this off). For ONE sound that applies to the whole folder, use create_event with folder_id. Always say whether it is a loop. LOOP OR ONE-SHOT, decided from what the sound is in the game: a LOOP is anything that lasts while something keeps happening and the game plays on repeat: ambience and weather, music, engines and machines, fire burning, flowing water, AND movement cycles: footsteps, walking, running, crawling, galloping, sustained wing flapping, rolling. Footsteps are a walk cycle with several steps (6-10 s), never a single step. A ONE-SHOT is one discrete action: hit, swing, click, cry, death, explosion, door, item, sting. DURATION: one-shots at least 2 s even for a tiny click, since shorter clips come out thin (hits, clicks and swings 2 s; cries, deaths, collapses and stings 3-5 s); movement loops 6-10 s; ambience, engine and fire loops 10-16 s. A music TRACK (Music folder) is not a sound effect: it is generated with generate_music and lasts up to the user's plan limit (generate_music duration_sec says it), usually 1-3 min for a theme and 30-60 s for a short loop. The server refuses one-shots under 2 s and loops under 6 s. COST = seconds rounded up × the account price per second (creditsPerSecond in list_games) × variations.", "inputSchema": { "properties": { "auto_choose": { "default": true, "description": "true (default): an event with no chosen sound gets all its new variations chosen. false leaves the choice to the user.", "type": "boolean" }, "channels": { "description": "Audio channels. auto (default): mono for everything the game positions (footsteps, hits, creatures, interface), stereo for Ambience backgrounds and for music in any folder. stereo: for a sound that does not come from a spot on the map (a sting, a screen whoosh). The choice is saved on the event.", "enum": [ "auto", "mono", "stereo" ], "type": "string" }, "duration_sec": { "description": "One-shot at least 2 s; movement loops 6-10 s. Omitted: loop 12 s, one-shot 2 s.", "maximum": 30, "minimum": 2, "type": "number" }, "event_name": { "description": "The event created on each entity, in the game's language (Attack, Die). Up to 60 characters.", "maxLength": 60, "minLength": 1, "type": "string" }, "folder_id": { "description": "The folder whose entities each get the sound (from list_folders).", "type": "string" }, "include_subfolders": { "default": true, "description": "Also the entities in subfolders (default true).", "type": "boolean" }, "loop": { "description": "Required. true for a continuous sound the game repeats (footsteps, running, flapping, engine); false for one discrete action.", "type": "boolean" }, "max_credits": { "description": "Omit it to only plan (entities, total cost, balance) without spending. To generate, pass the total the user approved; the cost must fit in it.", "minimum": 1, "type": "integer" }, "prompt": { "description": "How it sounds; {entity} and {description} become each entity's name and description. Up to 400 characters.", "maxLength": 400, "minLength": 1, "type": "string" }, "variations": { "default": 1, "description": "Versions per entity, 1 to 4 (default 1). The cost grows with it.", "maximum": 4, "minimum": 1, "type": "integer" } }, "required": [ "folder_id", "event_name", "prompt", "loop" ], "type": "object" }, "name": "sounds_for_folder", "outputSchema": null }, { "description": "Call it only after the USER picked \"maximum refinement\" and answered or confirmed the six fields. Make each field rich and concrete (the look and palette, every character and what it is made of, the mood, reference games), read from the project when you can, and review the result before showing it (see the QUALITY BAR in the instructions). The same assistant as the site's \"I want maximum refinement\": from the name and \"what the game is like\" (one line per field: Genre, World, Tone, Sound style, Camera, What's in the game) it writes the description, the sound direction (with the rules every sound follows) and the folders of each tab with the events this game needs, loop and duration decided. Nothing is created: show the result to the user, let them change it, then call create_game with name, engine, description, profile, sound_direction and these folders, with from_ai=true. Uses the account's AI quota (a few per minute).", "inputSchema": { "properties": { "language": { "description": "The game's language (folder and event names). Omitted: the account's.", "enum": [ "en", "pt-BR" ], "type": "string" }, "name": { "description": "The game's name. Up to 80 characters.", "maxLength": 80, "type": "string" }, "profile": { "description": "What the game is like, one line per field in the game's language, e.g. \"Gênero: estratégia\\nMundo: floresta viva\\nTom: cartoon\\nEstilo de som: seco, retrô\\nCâmera: de cima\\nO que tem no jogo: besouros, formigas, quartel\". Fields: genre, world, tone, soundStyle, camera, contents.", "maxLength": 1500, "type": "string" }, "rules": { "description": "Rules for every sound, one per line. Omitted: the site's default rules (same loudness, natural endings, no music or voice inside effects, dry sounds).'", "maxLength": 1200, "type": "string" }, "scenes": { "description": "In an engine project: the scenes that make noise (e.g. res://player/player.tscn, res://enemy/enemy.tscn), so the proposal follows the real game.", "items": { "maxLength": 300, "type": "string" }, "maxItems": 80, "type": "array" } }, "required": [ "name", "profile" ], "type": "object" }, "name": "suggest_game_setup", "outputSchema": null }, { "description": "For engine plugins: sends the project's scenes (up to 20 per call) to the game's Inbox, matching by the engine id (externalId, e.g. res://units/spider.tscn). A scene that is already an entity only gets its image refreshed; a new one waits in the Inbox until the user places it in a tab on the site. Sending again never duplicates. Plugin flow, in order: sync_scenes (the plugin sends its scenes), game_scenes (see what arrived), place_scenes (turn them into entities), mark_installed (the plugin reports the install).", "inputSchema": { "properties": { "game_id": { "description": "The game linked in the project (from list_games).", "type": "string" }, "items": { "description": "The scenes to send, up to 20 per call. Sending the same scene again never duplicates it.", "items": { "properties": { "description": { "description": "Optional: what the thing is, so its sounds come out better. Up to 400 characters.", "maxLength": 400, "type": "string" }, "externalId": { "description": "The scene path in the engine (e.g. res://units/spider.tscn): the key that matches it to an entity.", "maxLength": 300, "type": "string" }, "image": { "description": "A thumbnail (PNG, JPG or WebP, up to 2 MB).", "properties": { "base64": { "description": "The image bytes in base64.", "type": "string" }, "mimeType": { "description": "image/png, image/jpeg or image/webp.", "type": "string" } }, "type": "object" }, "name": { "description": "The scene name shown on the site. Up to 80 characters.", "maxLength": 80, "type": "string" } }, "required": [ "externalId", "name" ], "type": "object" }, "maxItems": 20, "type": "array" } }, "required": [ "game_id", "items" ], "type": "object" }, "name": "sync_scenes", "outputSchema": { "properties": { "entities": { "items": { "properties": { "created": { "type": "boolean" }, "entityId": { "type": [ "string", "null" ] }, "externalId": { "type": "string" } }, "required": [ "externalId", "entityId", "created" ], "type": "object" }, "type": "array" }, "inboxMax": { "type": "integer" }, "skipped": { "type": "integer" } }, "required": [ "entities", "skipped", "inboxMax" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:521ecec8978c5d8fe0a85e49d3189a48e1a692ce26f907e97957b0ad8345fc8c | sha256sum