Connect Sozee to Claude, ChatGPT, Cursor and VS Code with the Sozee MCP server: setup for each app, how sign-in works, and every tool an agent can use.
The Sozee MCP server lets an AI agent work in a Sozee account: Claude, ChatGPT, Claude Code, Codex and any other client that speaks the Model Context Protocol. For creators, it is the supported way to use Sozee programmatically, and there is no SDK. White-label partners that bring their own users have the Partner API.
Server URL: https://mcp.sozee.ai/mcp
The transport is Streamable HTTP. In a chat client, add it as a custom connector and paste the URL. In Claude Code:
claude mcp add --transport http sozee https://mcp.sozee.ai/mcp
The server uses OAuth 2.1 with PKCE. The person signs in to their own Sozee account in a browser and approves the client, and the client receives an access token for that account. There are no API keys to create or paste. Clients discover the authorization server from https://mcp.sozee.ai/.well-known/oauth-protected-resource. The full walkthrough for agents is in auth.md.
A Sozee account is required. Create one at app.sozee.ai/sign-up. What an agent can do depends on the account's plan and credit balance.
Anything that costs credits is quoted first. The tools return the price and the agent asks the person before it spends.
Sozee is for adults aged 18 or older. Identity and consent are verified for every real person a character is based on, and the acceptable use policy applies to everything an agent creates. For help, email support@sozee.ai.
/plugin marketplace add AnimusAILabs/sozee-mcp-plugins
/plugin install sozee@sozee
{
"mcpServers": {
"sozee": {
"url": "https://mcp.sozee.ai/mcp"
}
}
}
One-click install: Cursor
{
"servers": {
"sozee": {
"type": "http",
"url": "https://mcp.sozee.ai/mcp"
}
}
}
One-click install: VS Code
[mcp_servers.sozee]
url = "https://mcp.sozee.ai/mcp"
gemini extensions install https://github.com/AnimusAILabs/sozee-mcp-plugins
{
"mcpServers": {
"sozee": {
"serverUrl": "https://mcp.sozee.ai/mcp"
}
}
}
{
"context_servers": {
"sozee": {
"url": "https://mcp.sozee.ai/mcp"
}
}
}
{
"mcpServers": {
"sozee": {
"url": "https://mcp.sozee.ai/mcp",
"transport": "http"
}
}
}
The server offers 101 tools. Your client receives each tool's full input schema when it connects. Tools that spend credits return a quote first.
Your plan, credits, prices, product news and help guides.
get_account: Shows your plan, credit balance, what the plan includes and your character slots. (Read only)get_pricing: Lists what each kind of image, video, edit and analysis costs in credits. (Read only)get_credit_history: Shows recent credit charges, refunds, purchases and bonuses on your account. (Read only)list_whats_new: Lists the latest Sozee product updates, newest first. (Read only)search_guides: Finds the Sozee how-to guides that answer a question about using the app. (Read only)get_generation_status: Checks whether images or videos are queued, rendering, ready or failed. (Read only)Create characters and manage their look, backstory, voice and readiness.
list_characters: Lists your characters and what each still needs before adult content. (Read only)create_character: Creates a new AI character from a description, with its first reference photos. (Spends credits)rename_character: Changes a character's name and nothing else. (Changes things)set_character_gender: Saves whether a character is a woman or a man. (Changes things)get_character_look: Shows a character's saved look settings and reference photos. (Read only)update_character_look: Changes saved look settings such as hair, eyes or build for an AI character. (Changes things)render_character_shot: Makes one of an AI character's reference photos or face angles again. (Spends credits)get_character_persona: Shows a character's saved backstory, such as home, niche and personality. (Read only)draft_character_persona: Drafts a backstory for a character for you to review before saving. (Read only)update_character_persona: Saves or changes a character's backstory. (Changes things)check_character_readiness: Shows which photos, clips and voice a character has or lacks for great videos. (Read only)save_voice_sample: Saves an uploaded recording as the voice your character speaks in. (Spends credits)delete_character_voice: Removes a character's saved voice. (Deletes)delete_character: Deletes a character; finished images and videos are kept. (Deletes)Make new images and photoshoots of your characters, from ideas or references.
create_images: Makes one, two or four images of a character, or with no character, from an idea. (Spends credits)start_photoshoot: Makes a set of 3 to 10 photos that continue from one earlier shot. (Spends credits)search_explore: Browses or searches the Explore library of inspiration photos. (Read only)recreate_explore_image: Remakes an Explore photo with one of your characters in it. (Spends credits)recreate_image_with_character: Puts a character into the pose, outfit and scene of a reference image. (Spends credits)reference_from_post: Saves the photo from a public Instagram post to use as a reference. (Changes things)Change, fix, upscale and crop images you have already made.
edit_image: Changes an image from a written description of the edit. (Spends credits)edit_by_comments: Edits an image using notes pinned to the exact spots that should change. (Spends credits)change_expression: Changes the facial expression in an image while keeping everything else. (Spends credits)upscale_image: Makes a higher-resolution copy of an image. (Spends credits)crop_or_adjust_image: Crops an image to a new shape or adjusts its contrast, brightness and grain, free. (Changes things)Animate, create, extend, edit, clone and finish videos, plus voice notes.
animate_image: Turns a still image into a short video. (Spends credits)create_video_from_idea: Makes a new video of a character from a written idea. (Spends credits)create_video_from_video: Makes a new video of a character doing what happens in an uploaded clip. (Spends credits)extend_video: Adds more seconds to the end of a finished video. (Spends credits)edit_video_range: Changes chosen moments of a video from notes, keeping the rest as it was. (Spends credits)cut_video: Cuts out or keeps parts of a video, or trims its start or end, free. (Changes things)upscale_video: Makes a higher-resolution copy of a video. (Spends credits)get_video_quality_preference: Shows your saved video quality choice and the price of each option. (Read only)set_video_quality_preference: Saves whether videos are made as drafts, in 720p or 1080p, or asked each time. (Changes things)finish_draft_video: Remakes a draft video in full 1080p quality in the same board. (Spends credits)list_clone_reels: Lists library reels you can clone with one of your characters. (Read only)clone_library_reel: Makes a library reel with your character in place of the person, same moves. (Spends credits)clone_reel_link: Clones a public Instagram Reel or TikTok with your character, keeping its movement. (Spends credits)clone_own_video: Clones a video you already have in Sozee with one of your characters. (Spends credits)read_reference_video: Reads a video you like so Sozee can make a new one in its style. (Read only)video_story_options: Suggests story ideas for a new video based on a reference. (Read only)plan_video_from_reference: Writes a shot-by-shot plan for a new video, with its price, before anything is made. (Read only)revise_video_plan: Changes a video plan in your own words, free. (Changes things)edit_plan_shot: Changes the words, action, place or outfit of one shot in a plan. (Changes things)show_video_plan: Shows a video plan as it is now, with its current price. (Read only)render_video_from_plan: Makes the video from an agreed plan, with optional music. (Spends credits)edit_video_graphics: Changes captions, titles and their style on a finished planned video, free. (Changes things)fix_video_pronunciation: Fixes a word said wrong in a finished planned video; new lines are priced. (Changes things)make_voice_note: Makes a voice note spoken in your character's saved voice. (Spends credits)Script, plan and render talking-to-camera videos and brand ads.
get_ugc_format_guide: Explains each UGC video format, its options and its usual length. (Read only)draft_ugc_script: Writes a short script for a character talking to camera, free. (Read only)plan_ugc_video: Plans the scenes of a UGC video from an approved script and gives its price. (Changes things)revise_ugc_plan: Changes a planned UGC video's scenes or script in your own words. (Changes things)change_ugc_video_settings: Changes a planned UGC video's frame shape, resolution or captions. (Changes things)render_ugc_video: Makes a planned UGC video at the agreed price. (Spends credits)start_ad: Starts a brand ad from a brief, website and any finished scripts. (Changes things)answer_ad_questions: Sends your answers, logo and product photos for an ad brief. (Changes things)plan_ad: Writes the script, cast, shots and end card for an ad, with price estimates. (Read only)revise_ad_plan: Changes a shot, actor, setting or end card line in an ad plan. (Changes things)cast_ad: Makes photos of each actor and location for an ad plan. (Spends credits)render_ad: Makes the video of a cast ad plan, ending on the brand's end card. (Spends credits)See what is trending and learn why posts and creators perform.
find_trends: Shows the most viewed recent videos or photos on Instagram and TikTok for a topic. (Read only)get_trending_hooks: Shows opening lines trending for a UGC format, to adapt for your own video. (Read only)find_viral_posts: Finds viral TikTok and Instagram videos a character could remake. (Read only)analyze_post: Explains how one Instagram or TikTok post hooks viewers, why it works and how to remake it. (Spends credits)analyze_creator: Reviews a creator's recent posts: what they post, how it performs and what works. (Spends credits)Connect accounts, schedule posts and track how they perform.
get_connect_link: Gives the link to connect Instagram, TikTok, Facebook, X or Fanvue. (Read only)list_social_accounts: Lists the social accounts connected to a character. (Read only)assign_social_account: Links an already connected social account to one of your characters. (Changes things)disconnect_social_account: Disconnects a social account from a character. (Deletes)schedule_post: Schedules or publishes finished images or videos to connected accounts. (Changes things)list_scheduled_posts: Lists a character's scheduled, published, failed or cancelled posts. (Read only)reschedule_post: Changes the time or caption of a post that has not gone out yet. (Changes things)cancel_scheduled_post: Cancels a post that has not been published yet. (Deletes)get_post_performance: Shows views and engagement for a character's published posts. (Read only)get_account_growth: Shows follower growth and post numbers for a character's accounts. (Read only)Boards, vault folders, library items, uploads, flags and deletes.
list_boards: Lists your boards, most recently active first. (Read only)get_board: Shows the images and videos on one board. (Read only)delete_board: Deletes a board and what is on it. (Deletes)search_vault: Finds finished images and videos in your vault, by type, character or folder. (Read only)list_vault_folders: Lists your vault folders and how many items each holds. (Read only)create_vault_folder: Makes a new, empty vault folder. (Changes things)rename_vault_folder: Renames a vault folder; its contents stay the same. (Changes things)move_to_vault_folder: Adds up to 50 images or videos to a vault folder. (Changes things)remove_from_vault_folder: Takes items out of a folder without deleting them. (Changes things)delete_vault_folder: Deletes a vault folder. (Deletes)list_image_versions: Shows the original and every edit made from an image or video. (Read only)list_library_items: Lists the settings, outfits and objects saved in your library. (Read only)create_library_item: Saves a photo to your library as a setting, outfit or object. (Changes things)update_library_item: Renames a saved setting, outfit or object. (Changes things)delete_library_item: Deletes a saved setting, outfit or object from your library. (Deletes)start_upload: Opens an upload card to bring your own photo, video or recording into Sozee. (Changes things)finish_upload: Used by the upload card to check and save a file once it has been sent. (Changes things)flag_generation: Sends an image or video to the Sozee team for review and a possible refund. (Changes things)delete_generation: Deletes an image or video, or one shot of it. (Deletes)