Product documentationUpdated 2026-11-1212 min read2,484 words

Connect AI Assistants (MCP)

Connect Claude, ChatGPT or Cursor to Asteria Engine over MCP to draft, plan and schedule social content in one workspace, with your approval rules in charge.

Overview

Asteria Engine works with AI assistants such as Claude, ChatGPT and Cursor through the Model Context Protocol (MCP). Once connected, an assistant can read your brand settings and analytics, draft posts, add media, plan content and, if you allow it, send posts for approval and schedule them, all inside the workspaces you choose.

Your approval rules still decide what gets published. An assistant never publishes anything on its own.

Server address:

https://mcp.asteriaengine.com/mcp

Who Can Connect

Connecting assistants is included in every paid plan. During a free trial, the workspace owner needs to add a payment method first.

Any member of a workspace can connect an assistant to it. The assistant acts as that person, so it can only do what their role allows.

Connecting an Assistant

  1. In your assistant, add a remote MCP server (often called a custom connector or integration) with the address above.
  2. The assistant opens Asteria Engine in your browser. Sign in if you need to.
  3. Check who is asking and what it wants to do, then tick each workspace it may use. If you run several businesses, tick them all at once: the assistant works in one at a time, says which in every answer, and switches when you ask (for example "now let's do the bakery").
  4. Select Allow. You are returned to your assistant, which is now connected.

To use another workspace, connect again and choose that workspace.

What You Can Allow

PermissionWhat the assistant can do
See your contentRead posts and their results, brand settings, your content strategy, plans, comments, connected accounts, and your credit balance
Create draftsCreate and edit draft posts, tag posts, add images or videos to My Media, draft replies to comments, and change your content strategy or brand profile after showing you the change
Create with Asteria EngineUse Asteria Engine's designers to write and illustrate posts, plan content and make videos (spends credits)
ScheduleSend posts for approval, ask you to approve them, schedule approved posts, send replies you approved, and book meetings
Run adsSee and run paid ads within your workspace's spending limits

An assistant asks only for what it needs. If it later needs more, it asks you to connect again.

What Assistants Can Do

Every change works in two steps. The assistant first shows you what would change (a before and after, any warnings, or the credit cost), and only goes ahead when you agree. Nothing is changed silently.

Your brand and strategy

ToolDoes
Get brand settingsReads your brand profile in sections (who you are, audience, offer, voice, rules) and your saved products with their prices
Change the brand profileSuggests improvements to your brand profile from what it has learned about your brand with you. You see each field's before and after, and nothing is saved until you agree. Only people who can manage the workspace's settings can make this change
Get / Change the content strategyReads your pillars, sell share, posting cadence and times, format mix, topics to avoid and experiments. A change is shown as before and after, and saved only when you agree
Get platform capabilitiesChecks what each platform can publish here, and its caption and hashtag limits

Plans

ToolDoes
Preview / Create a content planProposes a plan from your strategy, with how it read your brief and anything to check (such as a platform with no free slots). Only the exact plan you approve is saved
Create a plan from your itemsSaves a plan written post by post, exactly as written (dates, platforms, formats), after showing you any warnings. Each item can say how it should be made: for a video, the assistant's own scene-by-scene script, or an exact length; for motion graphics, the look, art style and length; for a song, the length, style and lyrics
How planned pieces can be madeLists everything a planned video, motion graphics piece or song can set
List / Get content plansReads your plans and each planned item
Change, rewrite or lock a plan itemChanges one item, rewrites its idea as you ask, or locks it so it stays as it is
Make posts from plan itemsMakes the posts for the items you choose, with one credit estimate for the whole batch and a line saying how each will be made

Posts

ToolDoes
List posts / Get a postReads drafts, scheduled and published posts
Create a draft postSaves a draft for your team to review
Generate a postHas Asteria Engine write and make a post: a picture, carousel, video, motion graphics or a song with its lyric video. It can keep your own caption exactly, follow your description of the visual, use your own photos, or make the media exactly as you agreed with your assistant
Change a postChanges a caption or hashtags. An approved or scheduled post goes back for approval
Redesign a post's visualRemakes an image, carousel or document as you describe (spends credits)
Archive a postHides a post that won't go out; it can be restored in Asteria Engine
Tag a postLabels a post, for example as one version of an experiment
List media / Add mediaReads and adds to your media library. Pictures and videos come in exactly as they are: from a web address, a file in the chat, or one your assistant or another tool made
Change a post's mediaPuts pictures or a video from your library on an existing post, after showing you the before and after. An approved post goes back for approval

Videos

ToolDoes
Video script format and optionsExplains how to write a scene-by-scene video script and the longest video allowed. This is the recommended way for an assistant to make a video: the video is made exactly as written, with no designer reinterpreting it
Check a video script / Generate an authored videoChecks a script and its credit cost, then makes the video once you agree
Put a video into a draft postMakes a draft post from a finished video, for review
See a video's parts / Change one part of a videoLists a finished video's parts with their times and credit cost, then remakes just the part you want different once you agree, keeping the rest
Undo a video part changePuts the video back to how it was before its last part change (free)

Music, voiceovers and motion graphics

ToolDoes
Make musicComposes an original song, instrumental or sound effect into your music library. A song can use your own lyrics, sung as written
Put music on a postSets a post to a track: a video's soundtrack is swapped, and pictures become a short video set to the music
Make a voiceoverSpeaks your words exactly as written in your workspace's narration voice, including your cloned voice if you have one, and saves it to your media library
Make a motion graphics videoPlans and renders a motion graphics video in the look you agree (length, art style, narration, music, captions), ready to put on a post
Check made mediaSays when music, a voiceover or a motion graphics video is ready

Each one shows its credit cost first and is made only once you agree.

Pictures and videos made elsewhere

If you make a picture or video with your assistant, or with another tool or plugin, your assistant can add it to your media library and put it on a new post or an existing one. Asteria Engine uses it exactly as it is, and you can then approve, schedule and publish it as usual.

Videos made exactly as you agreed

When you and your assistant agree on a video, ask it to write the video as a scene-by-scene script (authored video). Asteria Engine makes that script exactly as written, every scene, line, voice and timing, whether the video is made right away as a post or later from a content plan. The same goes for pictures: your assistant can write the picture prompt with you, and it is used exactly as written. The picture comes back as it was made, with no text or logo laid over it.

What the assistant sets takes priority over your workspace's video settings. If something can't be made, for example a length longer than the platform accepts, the assistant is told why before anything is saved or spent. If Asteria Engine has to choose for you, it says so. For example, a 35-second video is made with Gemini Omni when your usual video model can only make 29 or 36 seconds. On the plan in Asteria Engine, each item shows how it will be made, and Use workspace defaults instead removes what was agreed.

Approvals

ToolDoes
Send a post for approvalMoves a draft into review
Ask the person to approve a postShows you the post in a form inside your assistant, where it can show one; you approve it or send it back with a note. Otherwise the people who can approve are notified in Asteria Engine
Get a post's approval historyWho approved, in what role, how, when, and whether that approval still covers the post as it is now
Schedule a postSchedules an approved post on its connected account, after you confirm the account and time

Results

ToolDoes
Get analytics summaryHow published posts performed over a period
List post performanceEach post's results, measured at the same age (7 days after publishing by default) so posts compare fairly, with their tags
Compare two periodsTwo periods side by side in one go, with the change and a breakdown by platform, format or tag
Metric definitions / List conversionsWhat each number means, and your recorded conversions
Get credit balanceCredits left this billing period

Ads (needs the Run ads permission)

ToolDoes
Get ad spending limitsReads your limits. They are set only in Asteria Engine; an assistant can't change them
List / Get ad campaigns, Get ad results for dates, Get ad recommendationsReads campaigns, their results and Asteria Engine's suggestions
Plan a new ad / Plan an ad from a post / Make the planned adPrepares an ad and its credit cost, then makes it once you agree. Nothing is launched
Review an ad launch / Launch an ad campaignChecks the exact account, budget, dates and audience against your limits, then launches only after you confirm
Pause / Resume / Change a daily budgetPausing or lowering a budget happens straight away. Resuming or raising a budget needs your confirmation

Comments, messages and leads

ToolDoes
List inbox conversations / List commentsReads your messages and the comments still waiting for an answer
Draft a reply / Send a reviewed replyDrafts a reply and shows it to you; it is posted only when you say so
List leadsShows where leads came from and when, without names, emails or phone numbers
Suggest meeting times / Book a meeting with a leadFinds free times on your Google Calendar and books a meeting after you confirm; the lead gets an invitation

Deleting posts, disconnecting accounts and changing ad spending limits stay in the Asteria Engine dashboard.

Approvals and Credits

  • Drafts and generated posts arrive for review. Posts that need approval can only be scheduled once someone approves them.
  • Every approval is recorded with who decided, their role, when, how (in Asteria Engine, through an assistant, on a client review link) and the exact version approved. Changing a post after it was approved cancels that approval, and it needs approving again. You can see this under Approval history on each post.
  • Generating content spends credits from the workspace owner's plan. The assistant gets a credit estimate first and must ask you before it starts.
  • When a paid campaign has spent 80% of its total budget, and again at 100%, the people who run your ads get a notification.

Seeing and Removing Connections

Go to Settings → Security → Connected AI assistants to see each connected assistant, the workspaces it may use, what it may do and when it was last used. Select Disconnect on a workspace to remove the assistant's access to it immediately; the others keep working. To add a workspace later, connect again from your assistant and tick it.

Security and Privacy

  • Sign-in uses OAuth 2.1 with PKCE. Your password is never shared with the assistant.
  • Each connection is limited to the workspaces you tick and the permissions you allow. Your role in each workspace still decides what the assistant can do there, and it can never add a workspace itself.
  • Access tokens last one hour and are renewed automatically. Renewal tokens rotate on every use, and reusing an old one revokes the connection.
  • Every action an assistant takes is recorded with the workspace, the assistant and the outcome.
  • Each connection can make up to 60 requests a minute.
  • Images and videos are fetched only from public web addresses.

Troubleshooting

"Connecting AI assistants is part of every paid plan": the workspace owner needs an active paid plan, or a payment method during a trial.

"This needs permission to …": the assistant asked for something you did not allow. Connect again and allow it.

"This post needs approval before it can be scheduled": approve the post in Asteria Engine, then ask the assistant to schedule it.

The assistant says it cannot reach Asteria Engine: check that the server address is exactly https://mcp.asteriaengine.com/mcp, then connect again.

Put the guide into practice

Build the workflow in a live Asteria Engine workspace.

Connect your channels, add brand context, and turn the setup steps in this guide into draftable, schedulable content.

Need Help?

If you have questions or run into issues, our support team is here to help.