ReShare AI is an MCP server published by ai.reshare, hosted at www.reshare.ai. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 21 tools, including whoami, list_characters, list_profiles, list_videos, get_video.
Post your videos to your socials now or on a schedule, read analytics, and swap AI characters in.
346 connections through 5 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
The ReShare AI account this connection acts for, its permissions, and the plan: what is left this period (posts, AI swaps, uploads), whether AI swaps are included (can_swap), and upgrade_url.
No parameters.
{
"name": "whoami",
"title": "Who am I",
"description": "The ReShare AI account this connection acts for, its permissions, and the plan: what is left this period (posts, AI swaps, uploads), whether AI swaps are included (can_swap), and upgrade_url.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"email",
"key",
"can_swap",
"upgrade_url"
],
"properties": {
"key": {
"type": "object",
"required": [
"id",
"scopes"
],
"properties": {
"id": {
"type": "string"
},
"scopes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": {}
},
"email": {
"type": "string"
},
"can_swap": {
"type": "boolean"
},
"upgrade_url": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Who am I",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Your AI characters. Only characters with usable: true can be swapped into a video (start_swap).
No parameters.
{
"name": "list_characters",
"title": "List characters",
"description": "Your AI characters. Only characters with usable: true can be swapped into a video (start_swap).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"characters"
],
"properties": {
"characters": {
"type": "array",
"items": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": [
"string",
"null"
]
},
"usable": {
"type": "boolean"
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List characters",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Your posting profiles, each with its connected social accounts: id, network, username, status and postable. Post only to accounts with postable: true; not_postable_reason says why not (reconnect needed, or X: coming soon). A postable TikTok account also has tiktok.privacy_level_options: the audiences it allows (e.g. PUBLIC_TO_EVERYONE, SELF_ONLY); ask the user which one before posting there.
No parameters.
{
"name": "list_profiles",
"title": "List profiles and accounts",
"description": "Your posting profiles, each with its connected social accounts: id, network, username, status and postable. Post only to accounts with postable: true; not_postable_reason says why not (reconnect needed, or X: coming soon). A postable TikTok account also has tiktok.privacy_level_options: the audiences it allows (e.g. PUBLIC_TO_EVERYONE, SELF_ONLY); ask the user which one before posting there.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"profiles"
],
"properties": {
"profiles": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"accounts"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"accounts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"network",
"username",
"status",
"postable",
"not_postable_reason"
],
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string"
},
"network": {
"type": "string"
},
"postable": {
"type": "boolean"
},
"username": {
"type": [
"string",
"null"
]
},
"not_postable_reason": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": {}
}
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List profiles and accounts",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Your newest 50 videos (AI swaps and your own), newest first, in pages: limit (default 20) and cursor (next_cursor from the previous page). active_only: only those still being made.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page (default 20, up to 100) |
| cursor | string | next_cursor from the previous page; omit for the first page |
| active_only | boolean |
{
"name": "list_videos",
"title": "List videos",
"description": "Your newest 50 videos (AI swaps and your own), newest first, in pages: limit (default 20) and cursor (next_cursor from the previous page). active_only: only those still being made.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page (default 20, up to 100)"
},
"cursor": {
"type": "string",
"maxLength": 64,
"description": "next_cursor from the previous page; omit for the first page"
},
"active_only": {
"type": "boolean"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"videos",
"next_cursor"
],
"properties": {
"videos": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"status"
],
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List videos",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One video: status (queued → downloading → running → ready | failed), seconds left, and when ready a result_url to download. Poll every 15–30 s after start_swap, use_own_video or stitch_videos.
| Parameter | Type | Description |
|---|---|---|
| video_id * | string |
{
"name": "get_video",
"title": "Get a video",
"description": "One video: status (queued → downloading → running → ready | failed), seconds left, and when ready a result_url to download. Poll every 15–30 s after start_swap, use_own_video or stitch_videos.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"video_id"
],
"properties": {
"video_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"status",
"app_url"
],
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string"
},
"app_url": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Get a video",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}A video added with commit_upload or add_video_link: status probing → ready (duration_s known) | failed.
| Parameter | Type | Description |
|---|---|---|
| source_id * | string |
{
"name": "get_upload",
"title": "Get an upload or link",
"description": "A video added with commit_upload or add_video_link: status probing → ready (duration_s known) | failed.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"source_id"
],
"properties": {
"source_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
}
}
},
"annotations": {
"title": "Get an upload or link",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Your posts, in pages: limit (default 20, up to 100) and cursor (next_cursor from the previous page). status 'upcoming' (scheduled, soonest first) or 'history' (published, failed, cancelled; newest first). Filter by video_id or profile_id.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Items per page (default 20, up to 100) |
| cursor | string | next_cursor from the previous page; omit for the first page |
| status | string | one of ["upcoming","history"] |
| video_id | string | |
| profile_id | string |
{
"name": "list_posts",
"title": "List posts",
"description": "Your posts, in pages: limit (default 20, up to 100) and cursor (next_cursor from the previous page). status 'upcoming' (scheduled, soonest first) or 'history' (published, failed, cancelled; newest first). Filter by video_id or profile_id.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page (default 20, up to 100)"
},
"cursor": {
"type": "string",
"maxLength": 64,
"description": "next_cursor from the previous page; omit for the first page"
},
"status": {
"enum": [
"upcoming",
"history"
],
"type": "string"
},
"video_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
},
"profile_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"posts",
"next_cursor"
],
"properties": {
"posts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"status"
],
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"next_cursor": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": {}
},
"annotations": {
"title": "List posts",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}One post with each account status (pending → published | failed) and the live post URL once published. Refreshes from the networks when due.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string |
{
"name": "get_post",
"title": "Get a post",
"description": "One post with each account status (pending → published | failed) and the live post URL once published. Refreshes from the networks when due.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
}
}
},
"annotations": {
"title": "Get a post",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Your usage for a month (default this month, UTC): totals and recent events. whoami shows the plan allowances.
| Parameter | Type | Description |
|---|---|---|
| month | string | YYYY-MM |
{
"name": "get_usage",
"title": "Get usage",
"description": "Your usage for a month (default this month, UTC): totals and recent events. whoami shows the plan allowances.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"month": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}$",
"description": "YYYY-MM"
}
}
},
"annotations": {
"title": "Get usage",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Your published posts with views, likes and comments per network, totals, the best time to post and views per day.
| Parameter | Type | Description |
|---|---|---|
| sort | string | one of ["views","engagement","recent"] |
| range | string | one of ["7d","30d","90d","all"] |
| profile_id | string |
{
"name": "get_analytics",
"title": "Post analytics overview",
"description": "Your published posts with views, likes and comments per network, totals, the best time to post and views per day.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"sort": {
"enum": [
"views",
"engagement",
"recent"
],
"type": "string"
},
"range": {
"enum": [
"7d",
"30d",
"90d",
"all"
],
"type": "string"
},
"profile_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
}
}
},
"annotations": {
"title": "Post analytics overview",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Views, likes and comments per network for one published post (cached up to 30 minutes).
| Parameter | Type | Description |
|---|---|---|
| post_id * | string |
{
"name": "get_post_analytics",
"title": "Analytics for one post",
"description": "Views, likes and comments per network for one published post (cached up to 30 minutes).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
}
}
},
"annotations": {
"title": "Analytics for one post",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Step 1 of uploading a local video, up to 95 MB. Returns put_url: PUT the file bytes there yourself with the given headers (e.g. curl -T file.mp4 -H 'Content-Type: video/mp4' '<put_url>') within 10 minutes, then call commit_upload. purpose 'swap' = a reel to swap a character into; 'own' = your own video to post (Sharing).
| Parameter | Type | Description |
|---|---|---|
| size * | integer | Exact file size in bytes |
| purpose * | string | one of ["swap","own"] |
| filename | string | |
| content_type * | string | one of ["video/mp4","video/quicktime","video/webm"] |
{
"name": "create_upload",
"title": "Start a video upload",
"description": "Step 1 of uploading a local video, up to 95 MB. Returns put_url: PUT the file bytes there yourself with the given headers (e.g. curl -T file.mp4 -H 'Content-Type: video/mp4' '<put_url>') within 10 minutes, then call commit_upload. purpose 'swap' = a reel to swap a character into; 'own' = your own video to post (Sharing).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"purpose",
"content_type",
"size"
],
"properties": {
"size": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Exact file size in bytes",
"exclusiveMinimum": 0
},
"purpose": {
"enum": [
"swap",
"own"
],
"type": "string"
},
"filename": {
"type": "string",
"maxLength": 255
},
"content_type": {
"enum": [
"video/mp4",
"video/quicktime",
"video/webm"
],
"type": "string"
}
}
},
"annotations": {
"title": "Start a video upload",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Step 3, after the PUT: checks the file and returns a source (status probing). Poll get_upload until ready, then start_swap, use_own_video or stitch_videos with its id.
| Parameter | Type | Description |
|---|---|---|
| upload_id * | string |
{
"name": "commit_upload",
"title": "Finish a video upload",
"description": "Step 3, after the PUT: checks the file and returns a source (status probing). Poll get_upload until ready, then start_swap, use_own_video or stitch_videos with its id.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"upload_id"
],
"properties": {
"upload_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
}
}
},
"annotations": {
"title": "Finish a video upload",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}A public Instagram, TikTok or YouTube Shorts link to swap a character into. Returns a source (probing); poll get_upload until ready.
| Parameter | Type | Description |
|---|---|---|
| url * | string |
{
"name": "add_video_link",
"title": "Add a reel link",
"description": "A public Instagram, TikTok or YouTube Shorts link to swap a character into. Returns a source (probing); poll get_upload until ready.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
}
}
},
"annotations": {
"title": "Add a reel link",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Swaps one of your characters into a ready source video (or a reel link). Uses AI swap credits from your plan or a swap pack. Sharing plans and the Free plan include none: then the answer is code plan_limit with an upgrade_url to show the user. Returns the video id; poll get_video until ready (about 8 minutes). start/end: seconds of the source to swap (default: from the start, up to your plan limit).
| Parameter | Type | Description |
|---|---|---|
| end | number | |
| start | number | |
| prompt | string | Extra direction for the swap |
| subject | string | Who to replace, e.g. "the woman in red" (default: the main person) |
| source_id | string | A ready source from get_upload |
| source_url | string | Or a reel link (the worker downloads it) |
| character_id * | string |
{
"name": "start_swap",
"title": "Start an AI character swap",
"description": "Swaps one of your characters into a ready source video (or a reel link). Uses AI swap credits from your plan or a swap pack. Sharing plans and the Free plan include none: then the answer is code plan_limit with an upgrade_url to show the user. Returns the video id; poll get_video until ready (about 8 minutes). start/end: seconds of the source to swap (default: from the start, up to your plan limit).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"character_id"
],
"properties": {
"end": {
"type": "number",
"exclusiveMinimum": 0
},
"start": {
"type": "number",
"minimum": 0
},
"prompt": {
"type": "string",
"maxLength": 1000,
"description": "Extra direction for the swap"
},
"subject": {
"type": "string",
"maxLength": 200,
"description": "Who to replace, e.g. \"the woman in red\" (default: the main person)"
},
"source_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "A ready source from get_upload"
},
"source_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Or a reel link (the worker downloads it)"
},
"character_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"video_id",
"app_url"
],
"properties": {
"app_url": {
"type": "string"
},
"video_id": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Start an AI character swap",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Turns a ready 'own' upload into a video you can post: whole, or trimmed to start/end seconds. A short content check runs first either way: poll get_video until status ready.
| Parameter | Type | Description |
|---|---|---|
| end | number | |
| start | number | |
| source_id * | string |
{
"name": "use_own_video",
"title": "Make a postable video from your upload",
"description": "Turns a ready 'own' upload into a video you can post: whole, or trimmed to start/end seconds. A short content check runs first either way: poll get_video until status ready.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"source_id"
],
"properties": {
"end": {
"type": "number",
"exclusiveMinimum": 0
},
"start": {
"type": "number",
"minimum": 0
},
"source_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
}
}
},
"annotations": {
"title": "Make a postable video from your upload",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Joins 1–3 clips into one video to post, in order. Each clip is a ready 'own' upload (source_id) or one of your ready videos (video_id), cut to start/end seconds (each at least 0.5 s, 10 minutes in all); overlap: seconds of crossfade into the previous clip (0–2). request_id: a new unique string per video; the same request_id returns the same video, never a second one. Poll get_video until ready.
| Parameter | Type | Description |
|---|---|---|
| clips * | array | |
| request_id * | string | A new unique id per stitched video; repeat it only to retry the same request |
{
"name": "stitch_videos",
"title": "Join up to 3 clips into one video",
"description": "Joins 1–3 clips into one video to post, in order. Each clip is a ready 'own' upload (source_id) or one of your ready videos (video_id), cut to start/end seconds (each at least 0.5 s, 10 minutes in all); overlap: seconds of crossfade into the previous clip (0–2). request_id: a new unique string per video; the same request_id returns the same video, never a second one. Poll get_video until ready.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"request_id",
"clips"
],
"properties": {
"clips": {
"type": "array",
"items": {
"type": "object",
"required": [
"start",
"end"
],
"properties": {
"end": {
"type": "number",
"description": "Seconds into that clip",
"exclusiveMinimum": 0
},
"start": {
"type": "number",
"minimum": 0,
"description": "Seconds into that clip"
},
"overlap": {
"type": "number",
"maximum": 2,
"minimum": 0,
"description": "Seconds of crossfade from the previous clip (not on the first)"
},
"video_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "Or one of your ready videos (list_videos)"
},
"source_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "A ready 'own' upload (get_upload)"
}
}
},
"maxItems": 3,
"minItems": 1
},
"request_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,64}$",
"description": "A new unique id per stitched video; repeat it only to retry the same request"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"video_id",
"status"
],
"properties": {
"status": {
"type": "string"
},
"video_id": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Join up to 3 clips into one video",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Checks a post exactly as publishing would (accounts, caption and title limits per network, video length, schedule, TikTok audience) without sending or spending anything. caption is the text everywhere; overrides sets a different caption or title per network (e.g. {"youtube": {"title": "…"}, "tiktok": {"caption": "…"}}). For a TikTok account, tiktok.privacy_level is required: ask the user who can view it (never choose for them); an issue lists the allowed values when it is missing or not allowed. Always call this first and show the user the result; then publish_post with the same arguments.
| Parameter | Type | Description |
|---|---|---|
| mode * | string | 'now', 'schedule' (needs scheduled_at) or 'queue' (the profile's next free slot) |
| title | string | Title for titled networks (YouTube); required when one is targeted |
| object | Required when a Reddit account is targeted | |
| tiktok | object | TikTok settings, used when a TikTok account is targeted. Ask the user who can view it (privacy_level) before preview_post. |
| caption * | string | Post text on every network (on YouTube: the description) |
| timezone | string | IANA zone, e.g. Europe/Madrid (default: the server default) |
| video_id * | string | A ready video (list_videos / get_video status "ready") |
Posts a ready video to your connected accounts now, at a time (mode schedule), or in the profile queue. Only after preview_post passed and the user agreed: confirm must be true. For TikTok, pass the tiktok.privacy_level the user chose. idempotency_key: a new unique string per intended post. Repeat the same call with the same key only when it did not answer (timeout, network): you get the same post back, never a second one. A post that came back failed needs a new key; the same key with different arguments is refused (idempotency_mismatch). Counts one post per account against your plan.
| Parameter | Type | Description |
|---|---|---|
| mode * | string | 'now', 'schedule' (needs scheduled_at) or 'queue' (the profile's next free slot) |
| title | string | Title for titled networks (YouTube); required when one is targeted |
| object | Required when a Reddit account is targeted | |
| tiktok | object | TikTok settings, used when a TikTok account is targeted. Ask the user who can view it (privacy_level) before preview_post. |
| caption * | string | Post text on every network (on YouTube: the description) |
| confirm * | boolean | Must be true: the user agreed to publish |
| timezone | string | IANA zone, e.g. Europe/Madrid (default: the server default) |
Moves a scheduled post that has not gone out yet to a new time, and can change its caption, title, per-network overrides or first comment at the same time. Only after the user agreed. The time is absolute, so the same call twice leaves the same post.
| Parameter | Type | Description |
|---|---|---|
| title | string | |
| caption | string | |
| post_id * | string | |
| timezone | string | IANA zone (default: the post's own) |
| overrides | object | Per network (tiktok, instagram, youtube, facebook, linkedin, threads, reddit, bluesky): a different caption and, on titled networks (YouTube), a different title. Networks left out use caption / title. |
| scheduled_at | string | New local time YYYY-MM-DDTHH:mm in `timezone` |
| first_comment | string | Empty string removes it |
{
"name": "reschedule_post",
"title": "Reschedule or edit a scheduled post",
"description": "Moves a scheduled post that has not gone out yet to a new time, and can change its caption, title, per-network overrides or first comment at the same time. Only after the user agreed. The time is absolute, so the same call twice leaves the same post.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"post_id"
],
"properties": {
"title": {
"type": "string",
"maxLength": 500
},
"caption": {
"type": "string",
"maxLength": 10000
},
"post_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
},
"timezone": {
"type": "string",
"maxLength": 64,
"description": "IANA zone (default: the post's own)"
},
"overrides": {
"type": "object",
"description": "Per network (tiktok, instagram, youtube, facebook, linkedin, threads, reddit, bluesky): a different caption and, on titled networks (YouTube), a different title. Networks left out use caption / title.",
"propertyNames": {
"type": "string",
"maxLength": 32
},
"additionalProperties": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 500
},
"caption": {
"type": "string",
"maxLength": 10000
}
}
}
},
"scheduled_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "New local time YYYY-MM-DDTHH:mm in `timezone`"
},
"first_comment": {
"type": "string",
"maxLength": 10000,
"description": "Empty string removes it"
}
}
},
"annotations": {
"title": "Reschedule or edit a scheduled post",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}Cancels a scheduled post that has not gone out yet. Only after the user agreed.
| Parameter | Type | Description |
|---|---|---|
| post_id * | string |
{
"name": "cancel_post",
"title": "Cancel a scheduled post",
"description": "Cancels a scheduled post that has not gone out yet. Only after the user agreed.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"post_id"
],
"properties": {
"post_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
}
}
},
"annotations": {
"title": "Cancel a scheduled post",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}ReShare AI has two modes. AI swap: swap one of your AI characters into a short video. Sharing: post your own videos. Both end in posting to your connected social accounts (TikTok, Instagram, YouTube, Facebook, LinkedIn, Threads, and more), now, at a time, or in your queue. Start with whoami: it shows the plan, what is left this period, and whether this account can make AI swaps (Sharing plans and the Free plan include none). AI swap: list_characters → add_video_link (a public reel link) or create_upload + PUT the file + commit_upload → get_upload until ready → start_swap → get_video until ready (about 8 minutes). Sharing: create_upload with purpose "own" + PUT the file + commit_upload → get_upload until ready → use_own_video (whole or trimmed) or stitch_videos (up to 3 clips joined) → get_video until ready. Posting: list_profiles (accounts with postable: true) → preview_post → show the user the preview and get a clear yes → publish_post with confirm: true and a new idempotency_key. TikTok: ask the user who can view the post (tiktok.privacy_level: one of the audiences list_profiles shows for that account) before preview_post; TikTok requires their choice, so never pick it for them. Never publish, reschedule or cancel without the user agreeing first. Posting is public and cannot be undone from here. X (Twitter) is coming soon: X accounts are not postable yet. Plan limits apply exactly as in the app: a limit answers with code plan_limit and an upgrade_url to show the user; never retry it. Errors come back as tool results with isError, a code and a message written for the user.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| overrides | object | Per network (tiktok, instagram, youtube, facebook, linkedin, threads, reddit, bluesky): a different caption and, on titled networks (YouTube), a different title. Networks left out use caption / title. |
| profile_id * | string | The profile to post from (list_profiles) |
| account_ids * | array | Accounts of that profile to post to (list_profiles, postable: true) |
| ai_generated | boolean | Label the post as AI-generated where the network supports it (default: true for AI swaps, false for your own videos) |
| scheduled_at | string | Local time YYYY-MM-DDTHH:mm in `timezone` |
| first_comment | string | Posted as the first comment where the network supports it |
| youtube_privacy | string | YouTube visibility (default public) |
{
"name": "preview_post",
"title": "Preview a post (dry run)",
"description": "Checks a post exactly as publishing would (accounts, caption and title limits per network, video length, schedule, TikTok audience) without sending or spending anything. caption is the text everywhere; overrides sets a different caption or title per network (e.g. {\"youtube\": {\"title\": \"…\"}, \"tiktok\": {\"caption\": \"…\"}}). For a TikTok account, tiktok.privacy_level is required: ask the user who can view it (never choose for them); an issue lists the allowed values when it is missing or not allowed. Always call this first and show the user the result; then publish_post with the same arguments.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"video_id",
"profile_id",
"account_ids",
"caption",
"mode"
],
"properties": {
"mode": {
"enum": [
"now",
"schedule",
"queue"
],
"type": "string",
"description": "'now', 'schedule' (needs scheduled_at) or 'queue' (the profile's next free slot)"
},
"title": {
"type": "string",
"maxLength": 500,
"description": "Title for titled networks (YouTube); required when one is targeted"
},
"reddit": {
"type": "object",
"required": [
"subreddit"
],
"properties": {
"subreddit": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "One subreddit, e.g. r/videos"
},
"flair_text": {
"type": "string",
"maxLength": 64
}
},
"description": "Required when a Reddit account is targeted"
},
"tiktok": {
"type": "object",
"properties": {
"post_mode": {
"enum": [
"DIRECT_POST",
"MEDIA_UPLOAD"
],
"type": "string",
"description": "DIRECT_POST (default): published to the TikTok profile, needs privacy_level. MEDIA_UPLOAD: sent to the user's TikTok inbox as a draft they finish in the TikTok app (no privacy_level)."
},
"disable_duet": {
"type": "boolean",
"description": "Turn Duet off (default: on, unless the account turned it off)"
},
"privacy_level": {
"enum": [
"PUBLIC_TO_EVERYONE",
"MUTUAL_FOLLOW_FRIENDS",
"FOLLOWER_OF_CREATOR",
"SELF_ONLY"
],
"type": "string",
"description": "Who can view the TikTok post: PUBLIC_TO_EVERYONE (everyone), MUTUAL_FOLLOW_FRIENDS (friends (mutual followers)), FOLLOWER_OF_CREATOR (followers), SELF_ONLY (only me). Required to post directly to TikTok, and only the values list_profiles shows in the account's tiktok.privacy_level_options are allowed (preview_post lists them when one is missing or not allowed). There is no default: ask the user who can view it, never choose for them."
},
"disable_stitch": {
"type": "boolean",
"description": "Turn Stitch off (default: on, unless the account turned it off)"
},
"disable_comment": {
"type": "boolean",
"description": "Turn comments off on the TikTok post (default: on, unless the account turned them off)"
},
"comment_in_caption": {
"type": "boolean",
"description": "TikTok has no first comments: add first_comment to the end of the TikTok caption instead (default false)"
}
},
"description": "TikTok settings, used when a TikTok account is targeted. Ask the user who can view it (privacy_level) before preview_post.",
"additionalProperties": false
},
"caption": {
"type": "string",
"maxLength": 10000,
"description": "Post text on every network (on YouTube: the description)"
},
"timezone": {
"type": "string",
"maxLength": 64,
"description": "IANA zone, e.g. Europe/Madrid (default: the server default)"
},
"video_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "A ready video (list_videos / get_video status \"ready\")"
},
"overrides": {
"type": "object",
"description": "Per network (tiktok, instagram, youtube, facebook, linkedin, threads, reddit, bluesky): a different caption and, on titled networks (YouTube), a different title. Networks left out use caption / title.",
"propertyNames": {
"type": "string",
"maxLength": 32
},
"additionalProperties": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 500
},
"caption": {
"type": "string",
"maxLength": 10000
}
}
}
},
"profile_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "The profile to post from (list_profiles)"
},
"account_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
},
"maxItems": 50,
"minItems": 1,
"description": "Accounts of that profile to post to (list_profiles, postable: true)"
},
"ai_generated": {
"type": "boolean",
"description": "Label the post as AI-generated where the network supports it (default: true for AI swaps, false for your own videos)"
},
"scheduled_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Local time YYYY-MM-DDTHH:mm in `timezone`"
},
"first_comment": {
"type": "string",
"maxLength": 10000,
"description": "Posted as the first comment where the network supports it"
},
"youtube_privacy": {
"enum": [
"public",
"unlisted",
"private"
],
"type": "string",
"description": "YouTube visibility (default public)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"dry_run",
"ok",
"issues",
"posts_needed"
],
"properties": {
"ok": {
"type": "boolean"
},
"issues": {
"type": "array",
"items": {
"type": "object",
"required": [
"message"
],
"properties": {
"message": {
"type": "string"
}
},
"additionalProperties": {}
}
},
"dry_run": {
"type": "boolean",
"const": true
},
"posts_needed": {
"type": "number"
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Preview a post (dry run)",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| video_id * | string | A ready video (list_videos / get_video status "ready") |
| overrides | object | Per network (tiktok, instagram, youtube, facebook, linkedin, threads, reddit, bluesky): a different caption and, on titled networks (YouTube), a different title. Networks left out use caption / title. |
| profile_id * | string | The profile to post from (list_profiles) |
| account_ids * | array | Accounts of that profile to post to (list_profiles, postable: true) |
| ai_generated | boolean | Label the post as AI-generated where the network supports it (default: true for AI swaps, false for your own videos) |
| scheduled_at | string | Local time YYYY-MM-DDTHH:mm in `timezone` |
| first_comment | string | Posted as the first comment where the network supports it |
| idempotency_key * | string | A new unique string per intended post |
| youtube_privacy | string | YouTube visibility (default public) |
{
"name": "publish_post",
"title": "Publish or schedule a post",
"description": "Posts a ready video to your connected accounts now, at a time (mode schedule), or in the profile queue. Only after preview_post passed and the user agreed: confirm must be true. For TikTok, pass the tiktok.privacy_level the user chose. idempotency_key: a new unique string per intended post. Repeat the same call with the same key only when it did not answer (timeout, network): you get the same post back, never a second one. A post that came back failed needs a new key; the same key with different arguments is refused (idempotency_mismatch). Counts one post per account against your plan.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"video_id",
"profile_id",
"account_ids",
"caption",
"mode",
"confirm",
"idempotency_key"
],
"properties": {
"mode": {
"enum": [
"now",
"schedule",
"queue"
],
"type": "string",
"description": "'now', 'schedule' (needs scheduled_at) or 'queue' (the profile's next free slot)"
},
"title": {
"type": "string",
"maxLength": 500,
"description": "Title for titled networks (YouTube); required when one is targeted"
},
"reddit": {
"type": "object",
"required": [
"subreddit"
],
"properties": {
"subreddit": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "One subreddit, e.g. r/videos"
},
"flair_text": {
"type": "string",
"maxLength": 64
}
},
"description": "Required when a Reddit account is targeted"
},
"tiktok": {
"type": "object",
"properties": {
"post_mode": {
"enum": [
"DIRECT_POST",
"MEDIA_UPLOAD"
],
"type": "string",
"description": "DIRECT_POST (default): published to the TikTok profile, needs privacy_level. MEDIA_UPLOAD: sent to the user's TikTok inbox as a draft they finish in the TikTok app (no privacy_level)."
},
"disable_duet": {
"type": "boolean",
"description": "Turn Duet off (default: on, unless the account turned it off)"
},
"privacy_level": {
"enum": [
"PUBLIC_TO_EVERYONE",
"MUTUAL_FOLLOW_FRIENDS",
"FOLLOWER_OF_CREATOR",
"SELF_ONLY"
],
"type": "string",
"description": "Who can view the TikTok post: PUBLIC_TO_EVERYONE (everyone), MUTUAL_FOLLOW_FRIENDS (friends (mutual followers)), FOLLOWER_OF_CREATOR (followers), SELF_ONLY (only me). Required to post directly to TikTok, and only the values list_profiles shows in the account's tiktok.privacy_level_options are allowed (preview_post lists them when one is missing or not allowed). There is no default: ask the user who can view it, never choose for them."
},
"disable_stitch": {
"type": "boolean",
"description": "Turn Stitch off (default: on, unless the account turned it off)"
},
"disable_comment": {
"type": "boolean",
"description": "Turn comments off on the TikTok post (default: on, unless the account turned them off)"
},
"comment_in_caption": {
"type": "boolean",
"description": "TikTok has no first comments: add first_comment to the end of the TikTok caption instead (default false)"
}
},
"description": "TikTok settings, used when a TikTok account is targeted. Ask the user who can view it (privacy_level) before preview_post.",
"additionalProperties": false
},
"caption": {
"type": "string",
"maxLength": 10000,
"description": "Post text on every network (on YouTube: the description)"
},
"confirm": {
"type": "boolean",
"const": true,
"description": "Must be true: the user agreed to publish"
},
"timezone": {
"type": "string",
"maxLength": 64,
"description": "IANA zone, e.g. Europe/Madrid (default: the server default)"
},
"video_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "A ready video (list_videos / get_video status \"ready\")"
},
"overrides": {
"type": "object",
"description": "Per network (tiktok, instagram, youtube, facebook, linkedin, threads, reddit, bluesky): a different caption and, on titled networks (YouTube), a different title. Networks left out use caption / title.",
"propertyNames": {
"type": "string",
"maxLength": 32
},
"additionalProperties": {
"type": "object",
"properties": {
"title": {
"type": "string",
"maxLength": 500
},
"caption": {
"type": "string",
"maxLength": 10000
}
}
}
},
"profile_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$",
"description": "The profile to post from (list_profiles)"
},
"account_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,128}$"
},
"maxItems": 50,
"minItems": 1,
"description": "Accounts of that profile to post to (list_profiles, postable: true)"
},
"ai_generated": {
"type": "boolean",
"description": "Label the post as AI-generated where the network supports it (default: true for AI swaps, false for your own videos)"
},
"scheduled_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$",
"description": "Local time YYYY-MM-DDTHH:mm in `timezone`"
},
"first_comment": {
"type": "string",
"maxLength": 10000,
"description": "Posted as the first comment where the network supports it"
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 8,
"description": "A new unique string per intended post"
},
"youtube_privacy": {
"enum": [
"public",
"unlisted",
"private"
],
"type": "string",
"description": "YouTube visibility (default public)"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"id",
"status",
"app_url"
],
"properties": {
"id": {
"type": "string"
},
"status": {
"type": "string"
},
"app_url": {
"type": "string"
}
},
"additionalProperties": {}
},
"annotations": {
"title": "Publish or schedule a post",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": true
}
}