Tool reference

This list is generated from the live server’s tool definitions on every release, so it always matches what your assistant sees. Each tool page shows its full description, inputs, permission, an example call and the REST endpoint it runs.

Badges: read-only tools never change anything. uses credits tools spend your plan’s usage credits. destructive tools can remove content and need the posts:delete permission.

Workspace and insights

The home brief, strategy, connected accounts, analytics and plan usage.

get_home_summaryToday's operating brief for the workspace: daily headline, items needing attention, the approval queue, schedule coverage, recent wins and activity.mcp:readread-only get_performance_summaryMarketing performance summary for a period: posts published, engagements and the best-performing content types.mcp:readread-only get_strategyThe workspace's current marketing strategy: positioning, audience, content pillars, priorities and recommendations.mcp:readread-only get_usageHow much of the plan's monthly allowance is left: usage credits (spent by AI drafting, research, X reads and sending video to X or LinkedIn; publishing never needs credits), storage for uploaded media, the largest video that can be uploaded, workspaces and seats.mcp:readread-only get_x_account_analyticsWhole-account analytics for the connected X account over the last `days` (default 30), counting every post and reply on the account, not only ones published through AdVentur.ai: impressions, engagements and engagement rate, profile visits, link clicks, likes, reposts, replies received, bookmarks, posts and replies made per day, and followers with their net change.mcp:readread-only list_social_accountsList the workspace's connected social accounts (platform, handle, connection status).mcp:readread-only list_top_postsThe best-performing published posts over the last `days` (default 30), ranked by engagement.mcp:readread-only

Posts and scheduling

Draft, revise, approve, schedule and publish posts and X threads.

approve_post_groupApprove a post group from the Review queue (e.g.posts:schedule create_draft_postDraft a social post for the workspace.posts:write create_x_threadDraft an X thread for the workspace (get_platform_algorithm_hints with platform x says what X's feed rewards).posts:write delete_x_postDelete one of the user's own X posts.posts:deletedestructive get_x_postRead a post on X (Twitter) from its link (x.com or twitter.com) or id.posts:writeuses credits get_x_threadRead a whole thread on X from the link or id of any post in it.posts:writeuses credits list_postsList the workspace's social posts with their approval state, one page at a time.mcp:readread-only post_nowPublish one approved post to its connected account (X, LinkedIn, Facebook Page, Instagram, TikTok or YouTube) right now instead of at its scheduled time.posts:publish reject_post_groupReject a post group from the Review queue: it and its posts (or only the ones in rejectPosts) are canceled and unscheduled, and the optional reason and note feed the workspace's content preferences.posts:write rewrite_postGenerate 3 to 5 better versions of a piece of post copy in the workspace's brand voice and the author's own writing voice, for a platform and optional tone.posts:writeuses credits schedule_post_groupSchedule or reschedule an approved post group: pass scheduledForUtc (ISO 8601 UTC) or useBestSlot: true.posts:schedule suggest_slotsSuggest the best times to publish on a platform (x, linkedin or tiktok) over the next week, ranked, each with a reason, e.g.mcp:readread-only update_postEdit one platform variant of a post: its copy (contentText), media or platformPayload.posts:write update_post_groupEdit a post group's shared details: title, topic, objective, timezone or tags (tagIds).posts:write

Visuals and media

On-brand images, carousels, app screenshots, uploads and the media library.

complete_media_uploadFinish an upload started with create_media_upload, once the file has been PUT to uploadUrl.posts:write create_app_screenshotTurn an app or website screenshot into an on-brand social image: the screenshot sits in a Mac-style browser window (traffic lights and address bar) on the workspace's brand background, with an optional eyebrow, title and body.posts:write create_branded_imageRender an on-brand social image (PNG, or SVG too) from a template filled with your copy, in the workspace's brand colours, fonts and logo.posts:writeuses credits create_carouselRender an on-brand carousel from 2 to 15 slides you write, in the workspace's colours, fonts and logo: a PDF document (LinkedIn document posts) and one PNG per slide (Instagram, X).posts:writeuses credits create_media_uploadStart uploading an image or video file from your own machine (for a file that's already online, use import_media_from_url instead).posts:write import_media_from_urlCopy an image or video from a public https link (straight to the file, not a web page) into the workspace, ready to post.posts:write list_mediaList the workspace's media library, newest first, to reuse an image, carousel or video in a new post.mcp:readread-only list_visual_optionsList what create_branded_image, create_carousel and create_app_screenshot can make: image formats with their pixel sizes and where each is used, templates and the content fields each one reads, themes, carousel slide layouts, app screenshot layouts, and recommended OpenRouter image models for aiBackground (default first, each with what it's best at; pass includeAllModels: true for all of them).mcp:readread-only

Ideas and research

Trends, niche news, viral formats, inspiration and saved thoughts.

draft_post_from_thoughtTurn a saved thought (see save_thought and list_thoughts) into ready-to-review posts for X and LinkedIn, written in the brand voice using the viral format that fits it best (hot take, lesson, story, list, how-to, before/after).posts:writeuses credits find_trending_topicsResearch what's trending right now in the user's niche, or in a focus they name (for example "AI agents in sales"), from live web search and from what people are posting and sharing on X this week.posts:write get_newsjacking_settingsShow the newsjacking autopilot: when enabled, a few times a day AdVentur.ai picks the freshest story in the user's niche worth jumping on, drafts an X and LinkedIn take into Review and emails the team.mcp:readread-only get_niche_newsRecent news articles (title, URL, snippet, date) in the user's niche, grouped by the topics the workspace follows.mcp:readread-onlyuses credits get_platform_algorithm_hintsGet what each platform's feed currently rewards and punishes (X, LinkedIn, Instagram, Facebook, TikTok, YouTube, Threads, Bluesky, Reddit), so the posts you write get reach.mcp:readread-only get_trending_topicsRead the workspace's latest trending-topics report without spending credits: topics in the brand's niche, why they matter now, a hot take, sources, and ready-to-edit X and LinkedIn posts in proven viral formats.mcp:readread-only list_inspiration_opportunitiesList saved inspiration items and the content opportunities found in them, across X and LinkedIn, best match first.mcp:readread-only list_thoughtsList the thoughts, tips and opinions saved for this workspace's content, newest first.mcp:readread-only list_viral_post_formatsList proven viral post formats for X and LinkedIn (hot takes, numbered threads, story to lesson, news reactions, frameworks and more).mcp:readread-only save_thoughtSave a thought, tip, opinion, story or lesson the user wants to post about, e.g.posts:write update_newsjacking_settingsTurn the newsjacking autopilot on or off (enabled) and set maxDraftsPerDay (1-3).posts:write update_thoughtEdit a saved thought's text, kind or tags, or set status 'archived' when the user no longer wants posts about it (status 'new' brings it back).posts:write

Replies and DMs

The reply inbox, Engage feeds, Reddit listening and X DM drafts.

add_dm_conversationTrack an X DM conversation and draft the next message in the user's voice.posts:writeuses credits draft_dmWrite a fresh next message for a tracked X DM conversation in the user's voice: an opener when nothing's logged, a reply when they spoke last, a follow-up when the user did.posts:writeuses credits draft_replyWrite a fresh reply to one reply-inbox item in the user's brand voice, e.g.posts:writeuses credits get_engagement_settingsShow which X accounts (watchHandles) and keywords the reply inbox watches for community posts to reply to, the saved Engage feeds (feeds: each a keyword search, a public X list or a set of people, with when it was last checked), the Reddit listening setup (redditKeywords: pain-point phrases; subreddits; redditExcludeTerms), whether it checks automatically a few times a day (autoRefresh), and when it last checked.mcp:readread-only list_dm_conversationsList the X direct-message conversations the user is tracking for outreach.mcp:readread-only list_reply_inboxList the reply inbox: replies to and mentions of the user's X account (kind 'mention') and new posts from the accounts and keywords they watch (kind 'community'), each with a drafted reply (draftText) and a one-line reason.mcp:readread-only refresh_reply_inboxCheck X for new replies to and mentions of the user's account, new posts from the accounts and keywords they watch and from their Engage feeds (see update_engagement_settings), and, when Reddit listening is set up, new Reddit threads where people describe the problem their product solves.posts:writeuses credits send_replyPost a reply from the user's account: to a mention on X, or as a comment on a Reddit thread (platform 'reddit').posts:publish suggest_reddit_listeningSuggest what to listen for on Reddit: redditKeywords are phrases people write when they have the problem the user's product solves, and subreddits where they ask for help.posts:writeuses credits suggest_x_accountsFind X accounts the user's target audience follows, so replying to them early puts the user in front of that audience.posts:writeuses credits update_dm_conversationUpdate a tracked X DM conversation (ids from list_dm_conversations).posts:writeuses credits update_engagement_settingsChoose whose posts the reply inbox watches: watchHandles is the full list of X handles in the user's community (up to 10, e.g.posts:write update_reply_draftEdit the drafted reply to an inbox item (draftText, at most 280 characters as X counts them), or set status 'dismissed' to skip it, 'drafted' to bring it back, or 'sent' once the user has posted it on X themselves.posts:write

Brand kit

Colours, fonts, logo and tagline that every visual uses.

find_brand_kit_on_websiteRead a brand's public website and list what could go in its brand kit: colours (theme-color, brand CSS variables and stylesheet colours, brand-looking ones first; neutral marks whites, blacks and greys), logo candidates (structured data, og:logo, logo images, apple-touch-icon, favicon), social share images, fonts, the site name and tagline, and a suggested kit.mcp:readread-only get_brand_kitRead the workspace's brand kit in the same shape update_brand_kit takes: named colours (primary, secondary, accent, background), headingFont, bodyFont, the stored logo (with its size), tagline and website.mcp:readread-only update_brand_kitSave changes to the workspace's brand kit: colours, fonts, logo, tagline and website.brand:write

Launches

Launch kits with Product Hunt and Show HN copy and a day-by-day plan.

create_launch_kitPlan and write a product launch in one call.posts:writeuses credits get_launch_kitRead a launch kit: the Product Hunt listing and Show HN post to paste, and the day-by-day plan.mcp:readread-only list_launch_kitsList this workspace's launch kits, newest first, with each one's launch date and how many plan steps are done.mcp:readread-only update_launch_stepMark a step of a launch kit's plan done (or not done), e.g.posts:write

X automation

Rules that repost winners and clean up flops on X, with dry runs.

get_x_automation_rulesShow the workspace's X automation rules: autoRepost (natively retweet the workspace's own posts that did well) and autoDelete (remove its own posts that flopped), each null when it has never been set up.mcp:readread-only list_x_automation_runsList what the workspace's X automation rules decided about its own published X posts, newest first.mcp:readread-only run_x_automationShow what the workspace's X automation rules would do to its own published X posts right now, without waiting for the nightly sweep.posts:write update_x_automation_rulesSet the rules for the workspace's own published X posts.posts:write