All servers / Media / Faceless.so MCP server
Faceless.so MCP server
MCP server for Faceless.so (alias for `faceless mcp`): drive AI faceless video generation, series and publishing from any MCP client.
Tested by ConnectATDScore 86 out of 100. Tested 2026-11-18 on package version 1.1.49. Package: faceless-mcp
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 20 / 20 | |
| Package safety | 16 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 12 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (3.0 seconds including download)
- Tools offered: 33
- Last published: 2026-11-16
- Weekly downloads (npm): 1,815
- License: MIT · Direct dependencies: 1
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
faceless_get_meno parametersIdentify the caller. Returns the team this API key belongs to, its credit balance, subscription plan and the scopes granted to the key. Call this first to verify authentication and discover the team context every other operation runs in.
faceless_get_credits2 of 2 parameters describedCredit balance and history. Returns the team's current credit balance and a paginated ledger of credit transactions (purchases, subscription grants, video spends, refunds). Video creation charges credits at creation time; rendering and publishing are free. Costs: storyboard 20, motion_lite 50, motion_pro 100 credits per video.
faceless_buy_credits2 of 2 parameters describedBuy a credit pack with an agent payment token. Buys a credit pack and adds the credits to the team immediately, paid with a Stripe Shared Payment Token (spt_...) that the customer approved in their Link agent wallet. Packs: pack_10 ($10, 100 credits), pack_25 ($25, 275), pack_50 ($50, 600); active subscribers get more credits per pack at their plan rate. Request the token for the Faceless.so Stripe profile (profile_61UDMKC11wsLfeXaMA6UDMKCL0SQKAF3aHKCFz33IPL6) with a USD max_amount of at least the pack price. Tokens are single use: retrying with the same token never charges twice. A declined, expired or already used token returns 402 payment_failed.
faceless_create_video10 of 10 parameters describedCreate a faceless video from a script. Creates an AI faceless video from a finished narration script: TTS voiceover, AI-generated visuals per scene, captions and optional background music. Generation is asynchronous; the response returns the video id immediately. Poll GET /videos/{id}/status until status is completed, then call POST /videos/{id}/render to produce the final MP4. Credits are charged now, at creation.
faceless_create_caption_video4 of 4 parameters describedCaption an existing video or audio file. Creates a project from a video or audio URL you already have: transcribes it, adds styled captions and emojis, and makes it editable. Use this to caption existing footage rather than generate new AI visuals (for that, use POST /videos). Processing is asynchronous; poll GET /videos/{id}/status.
faceless_create_video_from_audio10 of 10 parameters describedCreate a faceless video from your own voiceover recording. Creates an AI faceless video over a voiceover you recorded yourself: AI-generated visuals for every line, captions, and no AI voice. Pass a public link to the audio file; a Google Drive share link (set to "Anyone with the link") or a Dropbox link works as it is. Any common phone format (m4a, mp3, wav, ogg, webm) up to 90 seconds; it is levelled to narration loudness. The same art direction as POST /videos applies: style, masterStyle and globalNegativePrompt (a people ban, e.g. "people, hands, animals", keeps every frame free of them and each picture is checked). Pass the words you say as script so the captions spell them your way (recitation and names included). Music and sound effects follow the team's Video defaults unless set here. Generation is asynchronous; poll GET /videos/{id}/status, then POST /videos/{id}/render, then schedule as usual. Credits are charged now, at creation, the same as POST /videos.
faceless_list_videos3 of 3 parameters describedList the team's videos. Returns a paginated list of the team's video projects, newest first, with generation status and the rendered MP4 URL when available.
faceless_get_videono parametersGet one video. Returns a single video project: script, voice, model, generation state, per-platform post metadata, the rendered MP4 URL once rendered, and when it posts: scheduledTime (the next time it goes out, or null when nothing is scheduled), scheduledPlatforms (the platforms still to post) and schedule (its posting-calendar entry, as GET /calendar returns it, with a status of scheduled, needs_approval, on_hold, posted, failed, skipped or cancelled, and each platform's own status, time and post link). Covers videos scheduled with POST /posts/schedule and series episodes waiting for their slot.
faceless_update_video8 of 8 parameters describedUpdate a video's name or post metadata. Updates a video's name and/or its per-platform post metadata (titles, captions, descriptions). Set the metadata for every platform you intend to schedule to BEFORE calling POST /posts/schedule; scheduling rejects platforms whose metadata is missing.
faceless_select_video_thumbnail1 of 1 parameter describedChoose which thumbnail a video uses. Selects one of the video's thumbnail variants as the effective thumbnail. Read the available variants from GET /videos/{id} (the thumbnails object). The choice is marked as a user pick, so later automatic regenerations will not overwrite it, and it is what gets pushed to YouTube and used as the Instagram Reels cover at post time. Thumbnails are free and generated automatically after a video completes.
faceless_get_video_statusno parametersPoll video generation progress. Returns generation progress for a video: overall status (pending, processing, completed, failed), percent complete, per-step events and any error messages. Poll every 10-30 seconds after POST /videos until status is completed, then render it with POST /videos/{id}/render. A failed generation refunds nothing automatically; check errorMessages.
faceless_render_video1 of 1 parameter describedRender a video to MP4. Starts a cloud render of a generated video and returns a renderId. Rendering is asynchronous: poll GET /renders/{renderId} until status is done to get the MP4 URL. The video must have finished generating first (getVideoStatus status completed). Rendering is free; credits were charged at creation.
faceless_delete_videono parametersDelete a video. Permanently deletes a video project and its generated assets. This cannot be undone and does not refund credits.
faceless_get_renderno parametersPoll render progress. Returns the progress of a render started by POST /videos/{id}/render: status in-progress (with overallProgress 0-1), done (with the final MP4 url) or error. Poll every 5-15 seconds; renders typically take under two minutes.
faceless_create_series40 of 40 parameters describedCreate an automated video series. Creates a series that automatically generates and posts a new faceless video on a schedule (a set-and-forget channel). Choose a content source and niche or custom prompt, a voice, style and posting cadence; each generated episode charges credits like a single video. The first episode starts generating right after creation. Use GET /series/{id}/episodes to track output, POST /series/{id}/generate to force the next episode now.
faceless_list_seriesno parametersList the team's series. Returns all automated series for the team with their source, niche, cadence and pause state.
faceless_get_seriesno parametersGet one series. Returns a single series with its full configuration: source, niche, voice, style, schedule, destinations and pause state.
faceless_update_series42 of 42 parameters describedUpdate a series. Updates any subset of a series' configuration (niche, voice, schedule, destinations, pause state and so on). Only the fields you send change; in destinationAccounts only the platforms you send change.
faceless_delete_seriesno parametersDelete a series. Deletes a series and stops all future automatic generation. Already-generated videos are kept.
faceless_generate_series_episodeno parametersGenerate the next episode now. Immediately generates the next episode of a series instead of waiting for its schedule. Charges the series' per-episode credit cost. The episode appears in GET /series/{id}/episodes; poll the created video's status like any other video.
faceless_list_series_episodes2 of 2 parameters describedList a series' episodes. Returns the videos generated by a series, newest first, with their generation status and when they post: scheduledTime (the next time the episode goes out, or null), scheduledPlatforms, postedAt, and schedule (its posting-calendar entry, as GET /calendar returns it, with a status of scheduled, needs_approval, on_hold, posted, failed, skipped or cancelled). Slots the series has not made yet are on GET /calendar.
faceless_publish_post10 of 10 parameters describedPublish a rendered video to a platform now. Immediately publishes a rendered video to one connected platform (youtube, tiktok, instagram, x, facebook, linkedin or threads). The video must be rendered first (renderedVideoUrl present, or pass videoUrl explicitly) and the team must have that platform connected (GET /accounts). Every connected account gets a video once: publishing it again to an account that already has it answers 409 conflict unless allowRepost is true. For future-dated posting use POST /posts/schedule instead.
faceless_schedule_post3 of 3 parameters describedSchedule a video to one or more platforms. Schedules a video to be rendered (if needed) and posted to multiple platforms at a future time. Every platform in the list must have its post metadata already set on the video (PATCH /videos/{id}); the request is rejected otherwise. Cancel with DELETE /posts/{videoId}. See the posting calendar with GET /calendar.
faceless_post_now1 of 1 parameter describedPost a scheduled video now instead of at its scheduled time. Brings a scheduled video forward to now: every pending posting task of the video (and its render, if that is what is still waiting) moves to the current time and goes out within a minute or two, to every platform it was scheduled for. Works for videos scheduled with POST /posts/schedule and for series episodes waiting for their slot. It does not post a video that was never scheduled (use POST /posts), a video that still needs approval (409; approve it first), or an episode of a deleted series or of one paused for any reason but credits (409; resume the series first). Returns 400 when nothing is pending.
faceless_cancel_postno parametersCancel a scheduled post. Cancels the pending scheduled posting for a video (the id is the video id used in POST /posts/schedule). Posts that already went out are not affected.
faceless_get_calendar5 of 5 parameters describedPosting calendar. Returns the team's posting calendar for a date range, the same entries the Calendar page in the app shows: upcoming posts (videos scheduled with POST /posts/schedule, series episodes waiting for their slot, and series slots not made yet), posts that went out and posts that failed. One entry per video or series slot, with scheduledTime, the target platforms and a status: scheduled, needs_approval (waits for the creator's approval), on_hold (its series is paused or deleted, so it will not post until resumed), posted, failed, skipped or cancelled (its posting was stopped). platformPosts gives each platform's own status, time and post link. Without a range it covers today and the next 7 days. Use it to confirm what is queued before scheduling more.
faceless_list_accountsno parametersList connected social accounts. Returns the social accounts connected to the team (YouTube, TikTok, Instagram, X, Facebook, LinkedIn, Threads) with their ids. Use the ids as authId in publishPost and destinationAccounts in series. Connecting accounts itself happens in the dashboard (OAuth), not over the API.
faceless_list_voicesno parametersList TTS voices. Returns the text-to-speech voices available for narration, including the team's custom cloned voices and Recommended Studio Quality voices. Recommended ids are opaque: pass the returned id unchanged and Faceless will resolve the appropriate ElevenLabs model. Use a voice's id as voiceId in createVideo or voice in createSeries.
faceless_list_options1 of 1 parameter describedList content option catalogs. Enumerates the option catalogs used by createVideo and createSeries: sources, styles, niches, languages, durations, models (with credit costs), captionThemes, music moods, background videos and example subreddits. Call without kind to list the available kinds; pass kind to get that catalog's items.
faceless_create_asset3 of 3 parameters describedRegister a media asset by URL. Registers an already-hosted media file (video, image or audio URL) as a team asset usable in projects. This endpoint takes a URL, not raw bytes; host the file anywhere public (or use the dashboard for direct uploads).
faceless_get_analytics3 of 3 parameters describedCross-platform posting analytics. Returns performance for the team's published posts over a trailing window: aggregated views, likes, comments and posting volume for TikTok, Instagram and Facebook, and top posts per platform. YouTube is reported per video only (videos published in the last 30 days): views, likes and comments from the YouTube Data API plus average view percentage, average view duration and engaged views from the YouTube Analytics API when available; youtubeVideoStats explains the sources and any missing metric.
faceless_list_fast_track3 of 3 parameters describedList Fast Track video types, categories and scripts. Fast Track is the quickest way to a video: pick a video type, a category and a script. These are finished videos from the Fast Track library and one can be sold to up to 3 channels; each copy gets its own title, music, caption style and framing, and a narrated story a different voice. Call with no query for the video types (how many scripts each has and its price in credits), with source for that type's categories (niche, language, count), and with source, niche and language for up to 20 scripts (id, preview, coverUrl, seconds). Get one with POST /fast-track. Free.
faceless_buy_fast_track_video1 of 1 parameter describedGet a Fast Track video. Gets the picked Fast Track script (an id from GET /fast-track) as a video in the team's library, made its own (title, music, caption style, framing; a narrated story a different voice), and charges its price at once: 10 credits, or 3 for Slideshows, Single Fade-in Video and 2x2 Grid Video. The title, captions, music and cover can be changed in the editor; the voice cannot. The video opens straight away; its file is rendered within minutes. 409 when the script is no longer available: list again and pick another.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.