Skip to content
ReShare AI
Get started

ReShare AI · Docs

Use ReShare AI from your AI agent

Connect Claude, ChatGPT, Codex, Cursor, VS Code, Gemini CLI, Windsurf, Grok or any MCP client to ReShare AI. Swap your AI character into a video, or post your own videos to all your accounts, by asking.

  • Claude
  • ChatGPT
  • Claude Code
  • Codex
  • Cursor
  • VS Code
  • Gemini CLI
  • Windsurf
  • Grok

Quick start, in under 2 minutes

  1. Pick your app below.
  2. Sign in with your ReShare AI account when it asks, or paste a personal API key from Settings → Connect your agent.
  3. Ask: “List my profiles and their accounts.”

Sign in or use a key

Sign in (no key)

Apps that add a server by its address (Claude, ChatGPT, Cursor, and VS Code) open a ReShare AI sign-in page. Sign in as you do in the app, check what the app may do, and approve. You never copy a key. Each app shows up under Connected apps in Settings → Connect your agent, where you can disconnect it.

Personal API key

Coding tools and APIs (Claude Code, Codex, Cursor, VS Code, Gemini CLI, Windsurf, and Grok) can send a personal key instead. Create one in Settings → Connect your agent, pick what it may do (Read, Make videos, Post) and keep it in your shell as RESHARE_API_KEY. The key is shown once; never commit it. Each install below says whether the key is also saved in a local file.

Connect your agent

BetaSign in

On claude.ai and in the Claude Desktop app (they share one list of connectors). You sign in with ReShare AI; no key.

  1. In Claude, open Customize, then Connectors, then Add, then Add custom connector. On a Team or Enterprise plan an owner adds it under Organization settings, then Connectors.

  2. Name it ReShare AI and paste this address, then Add

    Text
    https://www.reshare.ai/api/mcp

  3. Press Connect, sign in with your ReShare AI account and approve. Turn ReShare AI on in a chat from the tools menu.

Server: https://www.reshare.ai/api/mcp (MCP over Streamable HTTP, OAuth sign-in or Authorization: Bearer with your key).

Sharing only: https://www.reshare.ai/api/mcp/sharing is the same server without the AI swap tools and without plan details in its answers, for app directories that list posting only. Sign-in and API keys work the same; a sign-in made for one of the two addresses works only there.

Two ways to use it

Your agent can do both, end to end. Ask in your own words; it picks the steps.

AI swap

Swap your AI character into a short video. Your agent picks the character and the video, starts the swap, checks on it and gets the result, then can post it.

Steps it takes: list_charactersadd_video_linkcreate_uploadcommit_uploadstart_swapget_videopreview_postpublish_post

Sharing

Post a video you already have. Your agent uploads it, trims it if you like, picks the profile and the accounts, shows you a preview, then posts now or schedules it, and later reads the analytics.

Steps it takes: create_uploadcommit_uploadget_uploaduse_own_videostitch_videoslist_profilespreview_postpublish_postreschedule_postget_post_analytics

Things to ask

  • “Swap my character Mia into https://www.instagram.com/reel/… and show me when it’s ready.”
  • “Upload ~/Videos/launch.mp4, cut it to the first 20 seconds and post it to TikTok and Instagram for my Café profile tomorrow at 9 am.”
  • “Schedule my three newest videos on TikTok and Instagram, one a day at 6 pm Madrid time.”
  • “How did last week’s posts do, and when should I post next?”

Your agent previews every post (accounts, caption limits, video length, time, how many posts it uses) and publishes only after you say yes.

Tools

Every tool your agent can call, by the permission it needs. The names are the same in every client.

Read

  • whoamiRead-onlyYour account, the permissions of this connection, your plan and what is left this period
  • list_charactersRead-onlyYour characters (usable ones can be swapped into videos)
  • list_profilesRead-onlyPosting profiles and their connected social accounts
  • list_videosRead-onlyYour newest videos, AI swaps and your own
  • get_videoRead-onlyOne video’s status and progress, and a download link when it’s ready
  • get_uploadRead-onlyAn uploaded video or reel link while it is checked
  • list_postsRead-onlyUpcoming and past posts
  • get_postRead-onlyOne post, each account’s status and the live link
  • get_usageRead-onlyThis month’s usage
  • get_analyticsRead-onlyViews, likes and comments per network, and the best time to post
  • get_post_analyticsRead-onlyThe numbers for one published post, per network

Make videos

  • create_uploadChanges thingsUpload a video from your computer straight to storage (a short-lived signed link)
  • commit_uploadChanges thingsFinish an upload so it can be checked
  • add_video_linkChanges thingsUse a public Instagram, TikTok or YouTube Shorts link
  • start_swapChanges thingsSwap your character into a video (uses AI swaps from your plan)
  • use_own_videoChanges thingsPost your own video as it is, or trimmed
  • stitch_videosChanges thingsJoin up to 3 clips into one video, with a cut or a crossfade between them

Post

  • preview_postRead-onlyDry run: checks accounts, captions, length and time; nothing is sent
  • publish_postPublishesPost now, at a time or in the queue; needs your yes and a one-time request key
  • reschedule_postChanges thingsMove a scheduled post to a new time, or change its caption before it goes out
  • cancel_postChanges thingsCancel a scheduled post

Limits

  • 120 requests a minute per key or connected app. Past that, the agent is asked to wait and try again.
  • Your plan, exactly as in the app: posts, AI swaps and uploads count the same, and your agent gets the same limit message and upgrade link you would see.
  • Uploads from an agent: up to 95 MB per video.
  • Networks: everything you can post to in the app. X is coming soon, so agents can’t post there yet.
  • Up to 10 active API keys per account.

Safety

  • Preview before publishing: ReShare AI tells every agent to preview a post first and show it to you. Nothing is sent by a preview.
  • Publishing needs a confirmation in the same request, and a repeated request with the same key never posts twice.
  • TikTok: your agent asks you who can view each TikTok post (everyone, friends, followers or only you) and never picks it for you.
  • Permissions: each key or connected app gets only what you allowed (Read, Make videos, Post). Anything else is refused and nothing happens.
  • Your data only: an agent sees only your own characters, videos, profiles and posts, even if you are a team admin.
  • Stop an agent at any time in Settings → Connect your agent: revoke its key or disconnect the app. It stops at its next request. Signing out everywhere does not revoke keys.

Troubleshooting

401 unauthorized
The key is missing, mistyped or revoked, or the sign-in expired. Check the key in your shell, or reconnect the app and sign in again.
insufficient_scope
This key or app was not allowed to do that (for example Post). Create a key with that permission, or disconnect the app and connect it again approving it.
plan_limit
Your plan’s limit for this period is reached. The answer carries an upgrade link; your agent can show it to you.
429 rate_limited
Too many requests in a minute. Wait the seconds in Retry-After and try again.
confirm_required
The agent tried to publish without your yes. Read the preview, then tell it to go ahead.

Questions

Can my agent post without asking me?

No. Publishing needs confirm: true, and ReShare AI tells every agent to show you a preview first and wait for your yes. A repeated call with the same idempotency key never posts twice.

What can an API key see?

Only your own characters, videos, profiles and posts, even if you are a team admin. Each key has its own permissions (Read, Make videos, Post), a rate limit of 120 requests a minute, and can be revoked at any time.

Does it use my plan?

Yes, exactly as the app does. On the Free plan you get 5 posts a month, 1 character and no AI swaps; your agent receives the same limit message and upgrade link you would see.

How much does ReShare AI cost to post my own videos?

Sharing plans start at $9 a month ($90 a year), up to $69 a month for 10 profiles. They are for videos you already have: upload, trim, schedule and post to all your accounts, with analytics. They include no AI swaps.

Where does my video go when I upload from an agent?

Straight from your machine to ReShare AI’s storage through a short-lived signed link; it never passes through a third party.

Do claude.ai and ChatGPT work?

Yes, as custom connectors: add the server address, then sign in with your ReShare AI account; no key needed. This sign-in is new, so these two are marked Beta. Claude Code and Codex also work with an API key.