aiponge

Return the canonical aiponge MCP tool map, workflow order, account/role requirements, and UI panel capabilities. Use only to choose tools for supported reflection, journal, music, or book requests. Do not call this or any aiponge tool for account deletion, unrelated local search such as restaurants, or invitations and group membership. For account deletion, direct the user to aiponge account setti

Show the user's account profile and saved settings: "what's on my profile?", "what language am I set to?", "my account settings". Returns account details, profile, general preferences, and activity counts, including saved song genre, vocals, and instruments when configured. Unset preference fields may be absent; do not infer values for missing fields. Use list_audio_preference_profiles to select a

List the user's saved song sound profiles, including each profile ID and label. Use this before generate_track when the user asks to create a song with a named saved sound. Read-only.

Change / set / update the user's saved AUDIO (music) preferences — the defaults generate_track applies automatically to every new song (genre, vocal gender, language, instruments, default audio content type). Supplied fields replace their saved defaults without an undo history; omitted fields are preserved. Use this when the user wants to change their music style GOING FORWARD (e.g. "from now on m

Show / list the user's OWN books — "what books do I have?", "my library", "my books". Returns only the books they own or created, NOT the shared aiponge catalog. To discover or search the wider aiponge book catalog, use browse_books instead.

Browse / search / discover / find books in the shared aiponge library catalog (not just the user's own — for those use list_books). "Find me a book about gratitude", "what books are there on sleep?", "browse the library". Optionally filter by `search` text or `typeId`. Searches all languages by default. Returns matching books with their ids — then use read_book to read one, or play_audiobook to li

Read / open a book's text content — its chapters and the prose of each — so you can summarize, quote, or discuss it. "Read me that book", "what does the book say?", "summarize this book". Resolve the bookId via browse_books or list_books first. Set chapterOffset and chapterLimit for a bounded chapter read. To LISTEN to it as narrated audio instead, use play_audiobook.

Play / listen to a book as an audiobook — its chapters narrated as TTS audio, in order, with clickable stream links. "Read this book aloud", "play the audiobook", "I want to listen to a book". Resolve the bookId via browse_books or list_books first. Many catalog books are narrated; if a book isn't, this says so (read its text with read_book instead).

Show / list / browse the user's songs — "what songs do I have?", "show me my music", "my tracks", "my library", "my playlist of songs". Returns the user's private music tracks. Each item includes its `title`, `themes` (canonical topic tags the track was generated around, e.g. ["travel", "solitude"]), and `inspiration` (a short hint about what the song is ABOUT, derived from the original generation

Play / listen to / put on ONE specific song the user already has — returns a fresh, clickable stream link for that track by its id. The user normally refers to a track by NAME, not id: when the requested title is approximate, partial, or possibly misspelled, FIRST call list_tracks (request the full library, e.g. limit 100), pick the closest matching title, then call this tool with its id. If sever

Check on a song/track/music that is still being generated — "is my song ready?", "how is it coming along?". Takes the requestId returned by generate_track. Returns progress while generating, a play link when complete, or the failure reason. When complete, you can also call play_track with the returned trackId. When polling, wait at least 30 seconds between calls — generation takes 1–3 minutes, so

Create / make / write / generate a SONG, a TRACK, or a piece of MUSIC for the user from a topic (e.g. "a calm morning walk", "write me a song about my mom", "make me some music about the sea"). This is THE tool for any "create/make/write a song|track|music" request. Provide EITHER a `topic` OR an `entryId` — do NOT ask the user for, or invent, a genre / mood / vocal style / language. The user's sa

Read the lyrics, source entry ID and context of a saved song. Use a real trackId from list_tracks or generation. Does not start playback.

Read available account allowances and reset time before planning creation. This is advisory; the server still reserves usage atomically. Unavailable counters are identified explicitly; do not assume their remaining allowance.

For clients without a journal panel: save the exact reflection the user has reviewed and explicitly confirmed. Never set confirmed from silence or inferred intent. Use compose_entry to prepare a draft; show it to the user, then save only after confirmation. Reuse operationId for retries of the same text. In interactive ChatGPT, prefer the journal panel Save action.

Record only explicit user feedback on a saved song: understood, partial or missed. Never infer recognition or helpfulness from playback. Replaces the user's previous feedback for this song. Resolve trackId first.

Record the user's explicit correction to a specific inferred dimension/value they have seen in aiponge. Do not invent a dimension or value, and do not treat this as a diagnosis. Use only when the user confirms the correction. The backend validates the canonical dimension and reaction.

Find the account's active song generation requests after reconnecting or losing a requestId. Inspect them before retrying generation. Completed songs can be found with list_tracks.

Open / read the full text of ONE specific journal entry by its id. Resolve the id via list_entries or search_entries first; never invent an entry id.

THE DEFAULT WAY TO SAVE A REFLECTION OR JOURNAL ENTRY. Use this — NOT create_entry — for any request like "save this as a journal entry", "journal this", "add a journal entry", "save my reflection", "put this in my diary", "write this down". It opens an in-chat journal composer PRE-FILLED with a draft you write from the conversation, for the user to edit and save. It does NOT persist on its own; t

Search the user-owned journal by words in any supported language, tag, personal date, or import source. Returns matching entry IDs and short excerpts. Use get_entry for full text. Follow nextCursor with identical filters until hasMore is false before claiming there are no older matches. total counts only this response. Journal resolution errors do not broaden the search to other books.

Persist a journal entry DIRECTLY to the journal, with NO review step. This is the silent/import-only path — for an ordinary chat request like "save this as a journal entry" / "journal this" / "add a journal entry", do NOT use this; use `compose_entry`, which opens an editable composer the user confirms. Reach for `create_entry` ONLY for silent/automated saves: structured memory-inventory imports,

Surface what aiponge has NOTICED about the user: the observations, recurring patterns, and wellness signal drawn from their self-model, inferred from their reflections. Read-only. Use it when the user asks "what has aiponge learned about me?", "what patterns do you see in me?", "what are my themes?", "how am I doing?", or to understand the user before suggesting actions. This is the INFERRED pictu