Install the MCP server

Already installed the atmee plugin in Claude Code, Codex or Cursor, or added the connector on claude.ai? Then the server is connected; see Install the skills.

Any other client that speaks the Model Context Protocol (MCP) over HTTP can use the Atmee server: it makes and changes avatars, takes uploads, generates portraits and voices, and starts conversations. MCP server lists every tool.

Server addressCopy Anchor Link

https://api.atmanity.us/mcp

Most clients take a config entry like this:

{
  "mcpServers": {
    "atmee-avatars": {
      "url": "https://api.atmanity.us/mcp"
    }
  }
}

Sign inCopy Anchor Link

The server uses OAuth. The first time your client connects, it opens the "Connect an app to Atmee" page on atmee.ai: sign in to your Atmee account and allow access. The client then acts as you, so it can make avatars and spend your credits, and the agent asks you before any paid step.

If your login belongs to several Atmee accounts, the server answers account_ambiguous and lists them; the agent asks you which one to use and sends it with each call.

You can see and revoke every connected client under Connected agents in your account settings.

Use an API key insteadCopy Anchor Link

Some clients can't run an OAuth sign-in. Give them an API key instead, sent in the X-Api-Key header:

1. Create a key on the API keys page with only the scopes the client needs, restricted to one avatar when it serves one, and with a spend cap. See API keys.
2. Put the key in an environment variable, such as ATMEE_API_KEY, and have the client's config read it from there.
3. Never commit a client config file that holds the key itself. Anyone who reads it can spend your credits until you revoke the key.

A key acts as the account, not as you: tools that need a signed-in person, such as managing API keys, answer login_required.

Get the skills tooCopy Anchor Link

The server gives your agent tools; the skills give it the guided flows for making an avatar, planning an app and building one. See Install the skills (the Other agents tab).