MCP server

The Atmee MCP server gives an agent the tools to make and change avatars, take your uploads, generate portraits and voices, and run conversations. Its address:

https://api.atmanity.us/mcp

The plugin connects it for you; to connect another client, see Install.

Frequently used toolsCopy Anchor Link

Ask in your own words; the agent picks the tool. For example:

• create_avatar“Make a receptionist avatar for our dental clinic from this photo and voice clip.”
• list_avatars“Which of my avatars are ready to talk?”
• update_avatar“Have the product guide greet visitors in Spanish and mention the spring sale.”
• create_upload“I have the photo on my phone. How do I get it to you?”
• get_balance“How many credits do I have left?”

All toolsCopy Anchor Link

Tools marked Paid spend credits, Per minute start a session billed while it runs, and Moves credits move credits between your account and an avatar. Every one of them asks you first (Paid calls).

Account and balanceCopy Anchor Link

• get_accountYour plan, limits, prices and whether the account has v2 access.
• get_balanceThe credits you have to spend.
• get_earningsWhat your monetized avatars have earned.
• redeem_codeRedeem a code, such as an invite that unlocks Atmee V2.
• get_api_keyWho this connection acts as: you, or an API key and its limits.

AvatarsCopy Anchor Link

• create_avatarMake an avatar from a name, a portrait and a voice sample.
• list_avatarsList your avatars and their status.
• get_avatarOne avatar's details, build progress and links.
• wait_for_avatarWait until an avatar is ready, or needs you.
• update_avatarChange the name, persona, language, visibility or share card.
• delete_avatarDelete an avatar (asks first).
• replace_appearanceGive the avatar a new portrait.
• replace_voiceGive the avatar a new voice sample.
• replace_knowledgeReplace the documents the avatar knows.
• replace_thumbnailSet the image on the avatar's Explore card.
• remove_thumbnailRemove the Explore card image (asks first).
• get_appearanceA link to the current portrait.
• get_voiceA link to the current voice sample.
• get_knowledgeThe avatar's facts, questionnaire and documents.
• get_monetizationWhether the avatar can earn, and what it has earned.

UploadsCopy Anchor Link

When you have a file the agent can't send by link, a photo on your phone or a recording on your computer, the agent gives you an upload page. Open it, choose the file (or record your voice in the browser), and the agent notices when it arrives.

• create_uploadA link where you upload a photo, recording or document for the agent.
• wait_for_uploadWait until your file arrives on the upload page.
• get_uploadCheck whether an upload has arrived.

Candidates and versions (v2)Copy Anchor Link

A v2 avatar is made of takes: short talking clips, each with its own lip sync. You pick the one the avatar uses. v2 is invite-only for now: get_account says whether your account has access, and without it these tools answer v2_access_required. Give the agent your invite code and it redeems it with redeem_code, or redeem it on the API page in Studio. Without one, make a v1 avatar.

• list_candidatesThe takes of a v2 avatar, each with a short talking preview.
• add_candidatesCapture more takes to choose from.
• select_candidatePick the take the avatar uses, or go back to an older one.
• delete_avatar_versionDelete an older version for good (asks first).

Portraits, voices and clipsCopy Anchor Link

For an invented character, a photo that needs help, or a short video clip. The same v2 access applies.

• generate_portraitsPortraits of an invented character from a description.Paid
• enhance_portraitClean up or restyle your own photo.Paid
• design_voiceVoice samples from a description of how it should sound.Paid
• generate_clipA video clip of up to 15 seconds from an image and a prompt.Paid

SessionsCopy Anchor Link

• start_sessionStart a conversation in a LiveKit room for your app.Per minute
• start_avatar_sessionRender the avatar into your own LiveKit room for your agent.Per minute
• get_avatar_sessionA session's state, why it ended and what it cost.
• end_sessionEnd a conversation now.
• end_avatar_sessionEnd a render session now.
• start_speech_sessionStart a voice-only conversation, with no video.Per minute
• get_speech_sessionA voice-only session's state, why it ended and what it cost.
• end_speech_sessionEnd a voice-only session now.

Conductor (v2)Copy Anchor Link

• set_conductorGive conversations an agenda: steps and when to move on.
• get_conductorRead the avatar's agenda.
• delete_conductorRemove the agenda (asks first).

SponsoringCopy Anchor Link

• get_sponsorThe avatar's sponsor pool and settings (API key only).
• update_sponsorChange sponsor settings (API key only).
• grant_sponsorMove credits into the avatar's pool (asks first).Moves credits
• withdraw_sponsorMove unused credits back to the account (asks first).Moves credits

API keysCopy Anchor Link

• list_api_keysThe account's API keys.
• create_api_keyCreate a key for your app; the secret never enters the chat.
• update_api_keyChange a key's name, scopes, avatar or caps (asks first).
• revoke_api_keyRevoke a key for good (asks first).

Sign inCopy Anchor Link

OAuth. The first time a client connects, it opens the "Connect an app to Atmee" page on atmee.ai. Sign in and allow access; the client then acts as you, on your account.

Several accounts. If your login belongs to more than one account, tools answer account_ambiguous with the list, and the agent asks you which one to use.

API keys. Clients that can't sign in send an API key in X-Api-Key instead. A key acts for the account with only the scopes you gave it, so it can't manage keys or do what its scopes don't allow. Give it the narrowest scopes, one avatar when it serves one, and a spend cap. See API keys.

Paid callsCopy Anchor Link

A tool that spends or moves credits, or deletes something, refuses to run until the agent passes confirm: true. Before that, the agent tells you what the call costs and your balance, and waits for your yes. Generation tools also take a requestId, so a retried call is never charged twice.

Prices are on the pricing page, and get_account returns the current ones for your plan.

SafetyCopy Anchor Link

• Prompt injection. When this server runs beside others, text from another tool (a web page, an email, a file) can try to instruct your agent. Keep paid and destructive actions behind a confirmation, and read what the agent asks you to approve.
• Tool approval. Leave your client's approval prompts on for tools that change or delete things, or spend credits.
• Revoke an agent. Every agent you've signed in is listed under Connected agents in your account settings, the CLI included (as "Atmee CLI"). Revoke stops it from signing in again, but access it already holds keeps working until it expires, at most an hour.
• Keys outlive the agent. Revoking an agent leaves any API key it created or used. Revoke those on the API keys page. atmee logout only removes the CLI's sign-in from that computer.