MCP tools reference
The Voholabs Studio MCP server gives your agent tools for its account and channels, posts and scheduling, analytics, the media library, Sanity, and, depending on plan, the brief, the skills library and the wallet. Your agent picks the tools itself; you ask in plain language.
Tool names below are what your agent sees. Descriptions are summaries; the agent receives the full description from the server.
Which tools manage the account and channels?#
| Tool | What it does |
|---|---|
accountInfo | Says which workspace the connection belongs to. |
integrationList | Lists the channels you can post to, optionally only those of one customer. |
groupList | Lists your customers, the optional labels that group channels per client. |
integrationSchema | Returns a channel's rules: character limits, media rules and the settings a post needs. |
triggerTool | Runs a channel helper to fetch details the agent cannot ask you for, such as the list of channels on a Discord server. |
Which tools create and change posts?#
| Tool | What it does |
|---|---|
integrationSchedulePostTool | Schedules a post, saves it as a draft or publishes it now, on one or more channels, with media, follow-up parts and per-channel settings. On the free plan it reports what an X post costs and warns when credits are short. |
postsList | Lists posts on the calendar between two dates, with any error, optionally filtered by state. |
editPostTool | Changes a post that is already on the calendar, in place. |
replacePostAsset | Swaps one image or video on a post for another and leaves everything else as it is. |
deletePostTool | Deletes a post from the calendar. It refuses while other posts reference it, and on the free plan gives back credits for parts that never went out. |
postStatusTool | Moves a post between draft and the schedule. On the free plan, scheduling an X post charges it and moving it back to draft gives the credits back. |
findSlotTool | Finds the next free time slot for a channel, from the posting times set for it. |
postHistory | Compares a post as it was first drafted with the version that went out, so the agent can learn from your edits. |
Which tools read analytics?#
| Tool | What it does |
|---|---|
channelAnalyticsTool | How a channel is doing: followers, impressions, engagement and whatever else the network reports. |
postAnalyticsTool | How one published post performed: likes, comments, shares, impressions and the rest. |
On the free plan, reading X analytics spends credits. See Credits and wallet.
Which tools handle media?#
| Tool | What it does |
|---|---|
mediaList | Lists images and videos in the media library, newest first. |
mediaPreview | Returns loadable references to media in the library or on a post, so the agent can look at it. |
uploadMediaTool | Uploads a small local image or video by sending its contents. |
createUploadLinkTool | Creates a temporary, single-use upload link for larger local files. |
uploadFromUrlTool | Imports an image or video from a public address. |
deleteMediaTool | Deletes an image or video from the library. |
Which tools work with Sanity?#
| Tool | What it does |
|---|---|
sanityMcpList | Lists the Sanity tools available for your connected Sanity project. |
sanityMcpCall | Runs one of them: query, read a document or the schema, and create, edit or publish documents. |
Scheduling stays with Studio: to publish an article at a set time, the agent schedules it on the Sanity channel. See Sanity.
Which tools work with the brief?#
Available on paid plans, and on the free plan after a wallet top-up.
| Tool | What it does |
|---|---|
briefListTool | Reads the brief: what you have written about your business, audience, voice and offers. |
briefSaveTool | Writes to the brief. |
briefDeleteTool | Deletes a document from the brief. |
briefLearnTool | Records a lesson about what works for your brand in the brief's Experience section. |
briefAssetTool | Registers a brand file, such as a logo or product shot, in Branding and assets. |
briefHistory | Shows what changed in the brief since it was last reviewed. |
markLearned | Marks edits as learned from, so they stop showing in the history tools. |
briefOnboardingStatus | Says whether the guided onboarding is available, open or finished, whether a new run is charged, and gives the link to start it in Studio. The agent cannot start the onboarding itself. Free plan after a top-up only; paid plans do not see it. |
See Brief and guided onboarding.
Which tools read the skills library?#
Free plan, after a wallet top-up. Paid plans do not see these tools. See Skills library.
| Tool | What it does |
|---|---|
skillsList | Lists the skills: step-by-step methods for content jobs such as hooks, writing in your voice and shaping a post for each channel. |
skillGet | Reads one skill so the agent can follow it. |
Which tools read the wallet?#
Free plan only, before and after a top-up. Paid plans do not use credits, so they do not see these tools. See Credits and wallet.
| Tool | What it does |
|---|---|
walletBalance | Your balance, auto top-up settings and whether posts scheduled in the coming hours are covered. |
walletTransactions | Top-ups, charges and refunds, newest first. |
walletPrices | The price list: what costs credits, what is included free, and the price of each. |
Which tools are on paid plans only?#
mediaMcpList and mediaMcpCall give paid plans AI image and video generation and editing.
Frequently asked questions
- Do I need to call these tools by name?
No. Ask your agent for the outcome, for example "schedule this for Tuesday at 10am on LinkedIn". The agent chooses and calls the tools.
- Why does my agent not see the brief or skills tools?
On the free plan they appear after your first wallet top-up. Paid plans see the brief tools but not the skills library or wallet tools.
- Can the agent publish without me checking?
It can schedule and publish, the same as you can. If you want to review first, ask it to save posts as drafts, then check them in the calendar.