MCP App Store
by KeenEthics
Anam AI Avatars icon

Anam AI Avatars MCP Server for ChatGPT

By Anam

Overview

Anam makes personas: real-time AI avatars that talk with people over video, for uses such as customer support, sales, reception, tutoring and interview practice. Connect your Anam account to build and manage them from ChatGPT. With Anam you can: - Create a persona from a short brief, with a recommended avatar, voice and language model, and get a link to talk to it. - Browse the avatars, voices and language models your organization can use. - Add knowledge from text or web pages so a persona can answer questions about your product. - Create and manage share links. - Find past sessions by date, persona or what was said, and read their transcripts. - Look up how to add a persona to a website or app, from Anam's documentation. Who it's for: teams that build or run Anam personas, and developers adding them to their products. Limitations: you need an Anam account. Each connection acts on one Anam organization that you choose when you sign in, and reaches only that organization. Read-only access still reads everything in it, including session transcripts and knowledge. Full access can also change and delete things and start billed work. Conversations with a persona happen in a browser or your own app, not inside ChatGPT. Only use images and voices you have the right to use, and don't recreate a real person without their consent.

How to connect

  1. ChatGPT: Open the Anam AI Avatars listing in the ChatGPT app directory and choose Connect. ChatGPT listing Anam AI Avatars exposes 87 tools here.

Tools

anam_app

ChatGPT
Shows the organization’s Anam personas as a gallery with their avatar images, in an interactive app. From it the user can talk to a persona, open it in Lab, or ask to change it. Use it when the user wants to see or browse their personas; anam_persona_list and anam_persona_get return the same personas as data.

anam_app_avatars

ChatGPT
For the Anam app’s Avatars tab: one page of the avatars the organization can use (its own first, then Anam’s stock), 24 at a time, with a still and a preview clip. anam_avatar_list returns avatars as data.

anam_app_personas

ChatGPT
For the Anam app’s persona picker: one page of the organization’s personas whose names match, 48 at a time, newest first. anam_persona_list returns personas as data.

anam_app_set_persona_media

ChatGPT
For the Anam app: gives a persona another voice or avatar, one per call, and returns the persona with what it replaced. Published at once, as with anam_persona_update: new sessions and share links use it straight away. A new voice resets the persona’s voice generation settings, and a new avatar resets an avatar model it can’t run; previous.restore has what was reset, for the app’s Undo to send back.

anam_app_voices

ChatGPT
For the Anam app’s Voices tab: one page of the voices the organization can use (its own first, then Anam’s stock), 40 at a time, with a sample to play. anam_voice_list returns voices as data.

anam_avatar_create

ChatGPT
Create a one-shot avatar from a public image URL (imageUrl); this server cannot read files from the user’s computer. Image moderation and creation capacity limits apply. Only use images of people who have consented. Check status with anam_avatar_get after about 10 seconds.

anam_avatar_delete

ChatGPT
Deletes an avatar. By default the delete is soft: the avatar is hidden, with no restore in Lab or the API, and its files are kept. hard: true also erases its stored image and versions (for data-erasure requests; it also purges a soft-deleted one), except assets another avatar uses. A hard delete is refused with 409 and the persona IDs while personas use the avatar: move them with anam_persona_update first.

anam_avatar_get

ChatGPT
Returns an avatar: status (processing until its preview videos exist, then ready), name, description, tags, style, image and versions. Its id is a persona’s avatarId.

anam_avatar_list

ChatGPT
Lists the avatars the organization can use (Anam’s stock ones and its own): name, description, tags, style and image. Filter by search, tags and renderStyle; no match is an empty data list. An avatar’s id is a persona’s avatarId; anam_options lists avatars, voices and LLMs with recommendations.

anam_avatar_update

ChatGPT
Renames an avatar and returns it. Fields to update on the avatar. Only displayName is editable.

anam_avatar_video_cancel

ChatGPT
Stops an avatar video that is still rendering and returns the job. A job that has already ended is returned unchanged, and a recording that finishes after the cancel stays available.

anam_avatar_video_create

ChatGPT
Creates an asynchronous avatar-video render backed by a normal recorded Anam session. A saved persona contributes only its snapshotted avatar, voice, language, model and director notes; its greeting, brain, prompt and tools never run. The request is rejected rather than queued when either concurrency limit is full. Send exactly one of these shapes: 1. personaId; 2. avatarId, voiceId.

anam_avatar_video_delete

ChatGPT
Cancels the job if it is still running, then deletes its recording, session report and job content; the job stays, without content, and can’t be retried. Returns 200 once everything is deleted, or 202 while Lab finishes in the background, retrying every minute until it succeeds. Repeating the call is safe.

anam_avatar_video_get

ChatGPT
Returns an avatar video job: its status and, once completed, content.url, a link to the video that works for an hour (content.expiresAt); read the job again for a new one. A failed job’s failure says why and whether a retry can fix it (retryable).

anam_avatar_video_list

ChatGPT
Lists the organization’s avatar video jobs, newest first: status (pending, running or finalizing while rendering; completed, failed or cancelled once ended), length, failure and times. Filter by status and creation dates; pass nextCursor as cursor for the next page. anam_avatar_video_get returns a finished video’s link.

anam_avatar_video_retry

ChatGPT
Renders an ended avatar video again from its original script and settings, as a new job whose retryOf names the original, and returns that job. A job still rendering, or one whose failure.retryable is false, can’t be retried. Poll anam_avatar_video_get with the new id.

anam_connection_info

ChatGPT
Which Anam organization this connection acts on, its access (full, read only or a scoped API key), and how it connected: the answer to “which account am I connected to?”.

anam_docs_read

ChatGPT
Read a whole Anam docs page: cat /javascript-sdk/quickstart.mdx (use the path anam_docs_search links to, ending in .mdx). tree / -L 2 lists the pages; head -120 <page> reads the start; rg -il "livekit" / finds pages that mention a word. A read-only shell over the docs pages and OpenAPI spec. Sent to Mintlify, which hosts Anam’s docs: send documentation terms, not customer content or secrets.

anam_integration_guide

ChatGPT
Concise, current steps for putting a persona into the user’s app: the server-side session token pattern, the package to install, a minimal snippet and the guides to follow, plus the start of the stack’s main docs page. A persona ID fills it in.

anam_knowledge_document_create_from_text

ChatGPT
Add text you have (pasted by the user, or written with them) to a knowledge folder as a markdown document, so personas using the folder can search it. Counts towards the monthly knowledge upload quota.

anam_knowledge_document_create_from_url

ChatGPT
Fetch a public web page or file and add it to a knowledge folder, so personas using the folder can search it. Web pages are saved as markdown text; PDF, DOCX, TXT, MD, CSV and JSON files as they are, up to 10MB. Only the one URL is read, not linked pages. Counts towards the monthly knowledge upload quota.

anam_knowledge_document_delete

ChatGPT
Deletes a knowledge document and its search index, so personas searching its folder no longer find its content.

anam_knowledge_document_download

ChatGPT
Returns downloadUrl, a link to the document’s original file that works for an hour, and its filename.

anam_knowledge_document_get

ChatGPT
Returns a knowledge document: file name, type, size, folder (knowledgeFolderId), chunking and status. Only READY documents are searchable; a FAILED one has errorMessage.

anam_knowledge_document_list

ChatGPT
Lists a knowledge folder’s documents: file name, type, size and status. Only READY documents are searchable; a FAILED one has errorMessage.

anam_knowledge_document_update

ChatGPT
Renames a knowledge document and returns it. Rename the document. Only filename is editable; the stored file and its extracted chunks are unchanged. Chunk settings can only be set at upload, so a non-null chunkSize or chunkOverlap returns 400.

anam_knowledge_folder_create

ChatGPT
Creates an empty knowledge folder and returns it with its id. Add documents with anam_knowledge_document_create_from_text or anam_knowledge_document_create_from_url, then let a persona search it with anam_persona_knowledge_add.

anam_knowledge_folder_delete

ChatGPT
Deletes a knowledge folder and every document in it. Detach it from personas first with anam_persona_knowledge_remove.

anam_knowledge_folder_get

ChatGPT
Returns a knowledge folder: name, description, document count and chunking settings.

anam_knowledge_folder_list

ChatGPT
Lists the organization’s knowledge folders: name, description and document count. anam_knowledge_document_list shows each document’s processing status.

anam_knowledge_folder_update

ChatGPT
Changes a knowledge folder’s name, description or default chunk settings and returns it. Fields to update on the knowledge group. Omit a field to leave it unchanged.

anam_llm_delete

ChatGPT
Deletes a custom LLM. While personas (or their drafts) use it, the delete is refused with 409, since their sessions would fail: move them to another LLM with anam_persona_update first.

anam_llm_get

ChatGPT
Returns an LLM: format, model, temperature, token limit, reasoning settings and, for a custom one, urls. API keys are never returned.

anam_llm_list

ChatGPT
Lists the LLMs personas can use, Anam’s defaults and the organization’s own: format, model and reasoning settings. Deprecated ones can’t be given to a persona. An LLM’s id is a persona’s llmId.

anam_meeting_invite_cancel

ChatGPT
Cancels a pending meeting invite and returns nothing. Cancelling one already cancelled, ended or failed succeeds too.

anam_meeting_invite_create

ChatGPT
Invite a saved persona, by its personaId, to join a Google Meet, Zoom or Microsoft Teams meeting. The invite is created in pending status. displayName gets an AI disclosure suffix before the persona joins, and the persona’s video shows an AI label. joinAt schedules the join; at least 10 minutes ahead reserves the persona a place.

anam_meeting_invite_get

ChatGPT
Returns a meeting invite: meeting URL and provider, status (pending, active, ended, cancelled or failed, with statusReason), joinState, join time and, once the persona joins, sessionId.

anam_meeting_invite_list

ChatGPT
Lists the organization’s meeting invites, newest first. Filter by status, such as pending (not joined yet) or active (in a call).

anam_options

ChatGPT
Avatars, voices and LLMs a persona can use, with Anam’s recommended picks. search matches names, descriptions and tags: use broad words (woman, office, friendly); roles such as receptionist rarely match. Voices list their languages. Use the IDs with anam_persona_create, anam_persona_update or anam_quickstart.

anam_persona_create

ChatGPT
Creates a persona and returns it with its id; anam_share_link_create gives it a link anyone can open to talk to it. systemPrompt is saved into brain. zeroDataRetention: true needs an enterprise plan and a ZDR-compatible voice, LLM and voiceDetectionOptions.sttProvider. anam_quickstart (your prompt or a role) and anam_persona_from_brief (a description) instead pick defaults and add a share link.

anam_persona_delete

ChatGPT
Deletes a persona; one that is missing or already deleted returns 404. Its tools aren’t deleted. A Knowledge_<persona> tool from anam_persona_knowledge_add is left unused: delete it with anam_tool_delete unless another persona uses it.

anam_persona_from_brief

ChatGPT
Create a persona from a plain description, when there’s no prompt yet: Lab’s Persona Design writes its name, greeting and system prompt, and may invent a character name and details for the user to review. Uses Anam’s recommended avatar and LLM and a stock voice suiting the avatar unless you pass IDs, and makes a share link (up to 10 sessions over 7 days, on the organization’s minutes). 20 designs per organization an hour.

anam_persona_get

ChatGPT
Returns a persona’s full configuration: system prompt (brain), avatar, voice, LLM, toolIds and tools, knowledge, share links and session settings.

anam_persona_knowledge_add

ChatGPT
Let a persona search more knowledge folders during calls. A persona searches its knowledge folders through a knowledge tool, as in Lab’s Build page; if other personas use the same tool, they change too. The persona’s other tools are kept.

anam_persona_knowledge_remove

ChatGPT
Stop a persona searching these knowledge folders. The folders and documents are kept. A persona searches its knowledge folders through a knowledge tool, as in Lab’s Build page; if other personas use the same tool, they change too. The persona’s other tools are kept.

anam_persona_list

ChatGPT
Lists the organization’s personas, newest first, with paging in meta: a summary of each (name, avatar, voice, llmId, language, description to 200 characters); anam_persona_get has the rest in full. search matches names.

anam_persona_update

ChatGPT
Changes a persona and returns it. Partial persona update; fields left out keep their values. A new avatarId may reset avatarModel if the avatar doesn't support it, and a new voiceId resets voiceGenerationOptions unless new ones are sent. voiceGenerationOptions sent with the current voiceId are merged into the saved ones (so a key can't be removed that way), sent without voiceId replace them, and null clears them. They must suit the voice's model, or the model override when set. Published at once, not as a draft: new sessions and share links use it straight away. toolIds replaces the whole tool list, knowledge tools included: send every ID to keep. anam_persona_knowledge_add and anam_persona_knowledge_remove attach and detach knowledge folders.

anam_persona_widget_get

ChatGPT
Returns saved widget display configuration and avatar media. Origin access controls are omitted. Missing or temporarily unavailable idle previews are null; clients should show avatarImageUrl instead. Preview availability does not indicate whether the avatar can start a call.

anam_pronunciation_dictionary_create

ChatGPT
Creates a pronunciation dictionary. Select it for a session with voiceGenerationOptions.pronunciationDictionaryId. Entries are validated as a whole: if any entry is invalid, nothing is saved and the response lists every error by one-based row.

anam_pronunciation_dictionary_delete

ChatGPT
Archives a pronunciation dictionary for good: it leaves the API and Lab, and sessions can’t select it. Its entries and history are kept until the organization is deleted. One a persona uses is refused with 409 DICTIONARY_ATTACHED and the persona IDs; remove it from those personas in Lab first.

anam_pronunciation_dictionary_get

ChatGPT
Returns a pronunciation dictionary with its entries and current revision.

anam_pronunciation_dictionary_import

ChatGPT
Creates a pronunciation dictionary from a Cartesia pronunciation dictionary file: an array of { text, pronunciation, case_sensitive? } rows, with an optional Anam sounds_like fallback. A pronunciation containing << or >> is imported as an IPA entry, anything else as a sounds-like one. The file must hold 1 to 500 rows in at most 1 MiB of UTF-8 JSON (an array is measured without whitespace). If any row is invalid, nothing is saved and every error is listed by row.

anam_pronunciation_dictionary_list

ChatGPT
Lists your organization's pronunciation dictionaries, newest first. Archived dictionaries are not listed. Entries are omitted; read a dictionary to get them.

anam_pronunciation_dictionary_update

ChatGPT
Changes a pronunciation dictionary’s name, entries or both and returns it; entries replaces the whole list. The save is live: sessions that start afterwards use the new entries, and running ones keep theirs. With expectedRevision, the update is refused with 409 REVISION_CONFLICT if the dictionary was saved since; without it, the last write wins. If any entry is invalid, nothing is saved and every error is listed by row.

anam_quickstart

ChatGPT
Create a persona the user can talk to now, in one call, from your prompt or a common role: Anam’s recommended avatar, voice and LLM unless you pass IDs, systemPrompt or else the template’s prompt, and a share link (up to 10 sessions over 7 days, on the organization’s minutes). Returns the persona, the link’s URL and its Lab page.

anam_scaffold

ChatGPT
Starter files that put a persona in the user’s app, to write yourself: a server route that swaps the ANAM_API_KEY environment variable for a short-lived session token, a page using @anam-ai/js-sdk, an env file without the key, and install and run commands. express and fastapi come with a Vite page.

anam_session_analytics_get

ChatGPT
Returns per-turn latency for a session, where time went from transcription through the LLM and TTS to first audio, and session totals. It is 404 until the session has ended and its report has arrived, and always for LiveKit and audio-passthrough sessions. Message text needs includeMessages: true and transcripts on.

anam_session_concurrency_get

ChatGPT
Returns the organization’s concurrent-session limit, about how many sessions are in use, whether a new one can likely start and an estimated wait for a free slot. It is advisory: the count can briefly over-report, and a start can still be refused with 429.

anam_session_delete

ChatGPT
Permanently delete customer data from an ended session. scope all (default): the report (transcript, analytics, tool calls), insights, summary, recording, initial message and requester IP; recording: the video only; report: the report, insights and summary only. The session record and usage stay for billing. Irreversible; repeating it succeeds.

anam_session_get

ChatGPT
Returns a session and, once it has ended and its report has arrived, its toolCalls (never for LiveKit or audio-passthrough sessions): names, timing, status and errors, with arguments and results only when transcripts were on and the session isn’t zero-data-retention. What was said is in anam_session_transcript_get.

anam_session_insights

ChatGPT
How calls went and what stands out (findings): start here to judge one call or a period. With sessionId: reply speed, interruptions, slowest turns, failed tool calls, errors and the first and last messages. Without: a roll-up by date and persona (last 24 hours by default, up to 31 days) of durations, exit statuses, latency and failure rates. CLOSED_BY_ENGINE includes a normal end of call by the user or app.

anam_session_list

ChatGPT
Lists the organization’s sessions (conversations with a persona), newest first, with paging in meta: a summary of each (persona, client label, start, end, length, exit status); anam_session_get has the rest. CLOSED_BY_ENGINE includes a normal end of call by the user or app. anam_session_search finds calls by what was said; anam_session_insights says how they went.

anam_session_recording_get

ChatGPT
Returns a presigned URL to download the session’s recording. Zero-data-retention sessions have no recording to return.

anam_session_stats

ChatGPT
Returns latency percentiles (p50, p90, p95, p99, max, avg) for each stage from transcription through the LLM and TTS to first audio, interruption and error rates, tool call outcomes and the slowest turns, across sessions. Only sessions where Anam runs the conversation (turnkey, custom LLM, ElevenLabs agent) have analytics; LiveKit and audio-passthrough ones count in sessionCount only. It reads the 1,000 newest matching sessions with analytics; truncated says more matched. The last 24 hours by default, up to 31 days. anam_session_insights summarises the same with findings.

anam_session_stop

ChatGPT
Ends a running session at once: the engine disconnects the client. Its endTime, exit status and report follow shortly after, so anam_session_get may briefly still show it active.

anam_session_transcript_get

ChatGPT
Returns a session’s conversation, 50 messages at a time unless limit (up to 100) says otherwise: pass the returned nextOffset as offset until it is null. totalMessages counts them all. Zero-data-retention sessions have no transcript.

anam_tool_delete

ChatGPT
Deletes a persona tool. Its usageCount (anam_tool_get) says how many personas use it; take it out of their toolIds first. Anam’s system tools can’t be deleted.

anam_tool_get

ChatGPT
Returns a persona tool: name, description, type, config and usageCount. A webhook config shows its structure, not its values: header values, URL IDs and tokens, query values and body template values show as •••• (a Bearer scheme, {{placeholders}}, header names, JSON keys and the host stay). Send them back unchanged to keep them.

anam_tool_list

ChatGPT
Lists the organization’s persona tools, with paging in meta: name, type (SERVER_RAG is knowledge), config and usageCount (personas using it). A persona uses the tools whose IDs are in its toolIds.

anam_usage_get

ChatGPT
The organization’s plan and its limits now: session minutes used and left this billing period, live sessions against the concurrency limit, the longest session allowed, and knowledge uploads this calendar month (UTC) against the monthly allowance.

anam_voice_add

ChatGPT
A Lab link where the user records or uploads a sample of their own voice, or imports one from ElevenLabs, with consent; audio and keys stay out of the chat. Nothing is created until they act on the page. Then check anam_voice_add_status. Lasts 30 minutes, works once.

anam_voice_add_status

ChatGPT
An anam_voice_add link’s result: pending, completed with the new voiceId (and personaUpdated when the link named a persona this connection can read), cancelled or expired.

anam_voice_clone

ChatGPT
Clone a voice from a recording of one person speaking, fetched from a public URL, and return the new voice; its id is a persona’s voiceId. Only clone the voice of someone who has consented. Cloning runs on Anam’s voice provider and needs a plan with voice cloning. Each call creates another voice, so check anam_voice_list before retrying. It shares the organization’s hourly limit for voice imports and model changes.

anam_voice_delete

ChatGPT
Deletes a voice from Anam, then from its provider. While personas (or their drafts) use it, the delete is refused with 409, since their sessions would have no voice: move them to another voice with anam_persona_update first.

anam_voice_get

ChatGPT
Returns a voice: provider and model, gender, accent (country), description and sample URL. Its id is a persona’s voiceId.

anam_voice_import

ChatGPT
Imports a provider voice and returns it; its id is a persona’s voiceId. The voice is saved once a speech sample generates with it: up to 95 seconds, and about a minute for a first ElevenLabs Voice Library import. displayName and description default to the provider’s. Only use voices of people who have consented. An import creates a new voice and generates a speech sample on Anam’s provider account, or with useOrganizationKey: true on the organization’s saved ElevenLabs key and its credits (for its own clones and designed voices). Retrying creates another voice, so check anam_voice_list first. A shareUrl (instead of provider and providerVoiceId) imports a Professional Voice Clone shared by link; one the organization already imported on that model gets a new sample instead of a new voice.

anam_voice_list

ChatGPT
Lists the voices the organization can use (Anam’s stock ones and its own): provider, gender, accent (country), languages and sample URL. Filter by search, language, gender and country; no match is an empty data list. A voice’s id is a persona’s voiceId.

anam_voice_update

ChatGPT
Changes a voice and returns it. Fields to update on the voice. Omit a field to leave it unchanged.

Capabilities

WritesInteractive

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/anam-ai-avatars"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/anam-ai-avatars)