# AdVentur.ai

> AdVentur.ai is an AI social media marketing workspace. Its remote MCP server lets AI assistants such as Claude, ChatGPT, Cursor and VS Code read a workspace, draft on-brand posts, images and replies, and schedule or publish them after the user approves.

MCP server: https://api.adventur.ai/mcp (Streamable HTTP, OAuth 2.1 with dynamic client registration, protocol versions 2025-11-25, 2025-06-18, 2025-03-26). Full text of these docs: https://docs.adventur.ai/llms-full.txt. OpenAPI: https://docs.adventur.ai/openapi.json.

## Docs
- [REST API](https://docs.adventur.ai/api/): The HTTP API behind the AdVentur.ai app and MCP server, with every endpoint generated from the code that serves it.
- [Core concepts](https://docs.adventur.ai/concepts/): Workspaces, connected accounts, post groups, the Review queue, slots, permissions and credits, and how they fit together.
- [On-brand images and carousels](https://docs.adventur.ai/guides/branded-visuals/): Render quote cards, stat graphics, carousels and framed app screenshots in your brand, and attach them to posts.
- [Launch a product](https://docs.adventur.ai/guides/launch/): Write your Product Hunt and Show HN listings, draft every launch post and follow a day-by-day plan.
- [Plan a week of posts](https://docs.adventur.ai/guides/plan-a-week/): Go from niche news and your strategy to a full, approved week of posts in one conversation.
- [Work the reply inbox](https://docs.adventur.ai/guides/replies/): Pull in mentions, replies and community posts, draft replies in your voice, and send only the ones you approve.
- [Turn a thought into posts](https://docs.adventur.ai/guides/thought-to-post/): Capture an idea, opinion or lesson the moment you have it and turn it into ready-to-review posts in your voice.
- [Post a video](https://docs.adventur.ai/guides/video/): Import or upload a video and post it to X, LinkedIn, Instagram Reels, Facebook, TikTok or YouTube.
- [Grow on X](https://docs.adventur.ai/guides/x-growth/): Threads, trends, analytics and automation rules that help an X account grow, all with your approval.
- [Build with AdVentur.ai](https://docs.adventur.ai/): Connect Claude, ChatGPT, Cursor or any MCP client to AdVentur.ai and run your social media from your AI assistant, with every post waiting for your approval.
- [Limits and usage](https://docs.adventur.ai/limits/): Usage credits, rate limits, platform character limits and media sizes.
- [How connecting works](https://docs.adventur.ai/mcp/): What the AdVentur.ai MCP server is, what happens when you connect an assistant, and which clients work with it.
- [Authentication and permissions](https://docs.adventur.ai/mcp/authentication/): How assistants sign in to AdVentur.ai with OAuth 2.1, the six permission scopes, token lifetimes and how to revoke access.
- [ChatGPT](https://docs.adventur.ai/mcp/clients/chatgpt/): Add AdVentur.ai to ChatGPT as an app in developer mode.
- [Claude](https://docs.adventur.ai/mcp/clients/claude/): Add AdVentur.ai to claude.ai and Claude Desktop as a custom connector.
- [Claude Code](https://docs.adventur.ai/mcp/clients/claude-code/): Add AdVentur.ai to Claude Code with one command.
- [Cursor](https://docs.adventur.ai/mcp/clients/cursor/): Add AdVentur.ai to Cursor through mcp.json.
- [Other MCP clients](https://docs.adventur.ai/mcp/clients/other/): Connect any MCP client that supports remote servers over Streamable HTTP with OAuth.
- [VS Code](https://docs.adventur.ai/mcp/clients/vscode/): Use AdVentur.ai from GitHub Copilot agent mode in VS Code.
- [Prompt library](https://docs.adventur.ai/mcp/prompts/): Copy-ready requests that show what your assistant can do with AdVentur.ai, from a morning brief to a full launch.
- [Server reference](https://docs.adventur.ai/mcp/server/): Protocol versions, transport, endpoints, discovery metadata, rate limits and errors for the AdVentur.ai MCP server.
- [Tool reference](https://docs.adventur.ai/mcp/tools/): Every tool the AdVentur.ai MCP server exposes, grouped by what it works on, with its permission and inputs.
- [Quickstart](https://docs.adventur.ai/quickstart/): Connect your AI assistant to AdVentur.ai and get your first on-brand draft into Review in about two minutes.
- [Security and privacy](https://docs.adventur.ai/security/): How AdVentur.ai keeps your accounts safe when an AI assistant works on them: approvals, scoped permissions, OAuth 2.1 and audit logs.
- [Troubleshooting](https://docs.adventur.ai/troubleshooting/): Fixes for the problems people hit most when connecting an assistant or publishing posts.

## MCP tools
- [add_dm_conversation](https://docs.adventur.ai/mcp/tools/add_dm_conversation/): Track an X DM conversation and draft the next message in the user's voice.
- [approve_post_group](https://docs.adventur.ai/mcp/tools/approve_post_group/): Approve a post group from the Review queue (e.g.
- [complete_media_upload](https://docs.adventur.ai/mcp/tools/complete_media_upload/): Finish an upload started with create_media_upload, once the file has been PUT to uploadUrl.
- [create_app_screenshot](https://docs.adventur.ai/mcp/tools/create_app_screenshot/): Turn 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.
- [create_branded_image](https://docs.adventur.ai/mcp/tools/create_branded_image/): Render 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.
- [create_carousel](https://docs.adventur.ai/mcp/tools/create_carousel/): Render 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).
- [create_draft_post](https://docs.adventur.ai/mcp/tools/create_draft_post/): Draft a social post for the workspace.
- [create_launch_kit](https://docs.adventur.ai/mcp/tools/create_launch_kit/): Plan and write a product launch in one call.
- [create_media_upload](https://docs.adventur.ai/mcp/tools/create_media_upload/): Start uploading an image or video file from your own machine (for a file that's already online, use import_media_from_url instead).
- [create_x_thread](https://docs.adventur.ai/mcp/tools/create_x_thread/): Draft an X thread for the workspace (get_platform_algorithm_hints with platform x says what X's feed rewards).
- [delete_x_post](https://docs.adventur.ai/mcp/tools/delete_x_post/): Delete one of the user's own X posts.
- [draft_dm](https://docs.adventur.ai/mcp/tools/draft_dm/): Write 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.
- [draft_post_from_thought](https://docs.adventur.ai/mcp/tools/draft_post_from_thought/): Turn 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).
- [draft_reply](https://docs.adventur.ai/mcp/tools/draft_reply/): Write a fresh reply to one reply-inbox item in the user's brand voice, e.g.
- [find_brand_kit_on_website](https://docs.adventur.ai/mcp/tools/find_brand_kit_on_website/): Read 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.
- [find_trending_topics](https://docs.adventur.ai/mcp/tools/find_trending_topics/): Research 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.
- [get_brand_kit](https://docs.adventur.ai/mcp/tools/get_brand_kit/): Read 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.
- [get_engagement_settings](https://docs.adventur.ai/mcp/tools/get_engagement_settings/): Show 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.
- [get_home_summary](https://docs.adventur.ai/mcp/tools/get_home_summary/): Today's operating brief for the workspace: daily headline, items needing attention, the approval queue, schedule coverage, recent wins and activity.
- [get_launch_kit](https://docs.adventur.ai/mcp/tools/get_launch_kit/): Read a launch kit: the Product Hunt listing and Show HN post to paste, and the day-by-day plan.
- [get_newsjacking_settings](https://docs.adventur.ai/mcp/tools/get_newsjacking_settings/): Show 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.
- [get_niche_news](https://docs.adventur.ai/mcp/tools/get_niche_news/): Recent news articles (title, URL, snippet, date) in the user's niche, grouped by the topics the workspace follows.
- [get_performance_summary](https://docs.adventur.ai/mcp/tools/get_performance_summary/): Marketing performance summary for a period: posts published, engagements and the best-performing content types.
- [get_platform_algorithm_hints](https://docs.adventur.ai/mcp/tools/get_platform_algorithm_hints/): Get 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.
- [get_strategy](https://docs.adventur.ai/mcp/tools/get_strategy/): The workspace's current marketing strategy: positioning, audience, content pillars, priorities and recommendations.
- [get_trending_topics](https://docs.adventur.ai/mcp/tools/get_trending_topics/): Read 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.
- [get_usage](https://docs.adventur.ai/mcp/tools/get_usage/): How 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.
- [get_x_account_analytics](https://docs.adventur.ai/mcp/tools/get_x_account_analytics/): Whole-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.
- [get_x_automation_rules](https://docs.adventur.ai/mcp/tools/get_x_automation_rules/): Show 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.
- [get_x_post](https://docs.adventur.ai/mcp/tools/get_x_post/): Read a post on X (Twitter) from its link (x.com or twitter.com) or id.
- [get_x_thread](https://docs.adventur.ai/mcp/tools/get_x_thread/): Read a whole thread on X from the link or id of any post in it.
- [import_media_from_url](https://docs.adventur.ai/mcp/tools/import_media_from_url/): Copy an image or video from a public https link (straight to the file, not a web page) into the workspace, ready to post.
- [list_dm_conversations](https://docs.adventur.ai/mcp/tools/list_dm_conversations/): List the X direct-message conversations the user is tracking for outreach.
- [list_inspiration_opportunities](https://docs.adventur.ai/mcp/tools/list_inspiration_opportunities/): List saved inspiration items and the content opportunities found in them, across X and LinkedIn, best match first.
- [list_launch_kits](https://docs.adventur.ai/mcp/tools/list_launch_kits/): List this workspace's launch kits, newest first, with each one's launch date and how many plan steps are done.
- [list_media](https://docs.adventur.ai/mcp/tools/list_media/): List the workspace's media library, newest first, to reuse an image, carousel or video in a new post.
- [list_posts](https://docs.adventur.ai/mcp/tools/list_posts/): List the workspace's social posts with their approval state, one page at a time.
- [list_reply_inbox](https://docs.adventur.ai/mcp/tools/list_reply_inbox/): List 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.
- [list_social_accounts](https://docs.adventur.ai/mcp/tools/list_social_accounts/): List the workspace's connected social accounts (platform, handle, connection status).
- [list_thoughts](https://docs.adventur.ai/mcp/tools/list_thoughts/): List the thoughts, tips and opinions saved for this workspace's content, newest first.
- [list_top_posts](https://docs.adventur.ai/mcp/tools/list_top_posts/): The best-performing published posts over the last `days` (default 30), ranked by engagement.
- [list_viral_post_formats](https://docs.adventur.ai/mcp/tools/list_viral_post_formats/): List proven viral post formats for X and LinkedIn (hot takes, numbered threads, story to lesson, news reactions, frameworks and more).
- [list_visual_options](https://docs.adventur.ai/mcp/tools/list_visual_options/): List 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).
- [list_x_automation_runs](https://docs.adventur.ai/mcp/tools/list_x_automation_runs/): List what the workspace's X automation rules decided about its own published X posts, newest first.
- [post_now](https://docs.adventur.ai/mcp/tools/post_now/): Publish one approved post to its connected account (X, LinkedIn, Facebook Page, Instagram, TikTok or YouTube) right now instead of at its scheduled time.
- [refresh_reply_inbox](https://docs.adventur.ai/mcp/tools/refresh_reply_inbox/): Check 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.
- [reject_post_group](https://docs.adventur.ai/mcp/tools/reject_post_group/): Reject 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.
- [rewrite_post](https://docs.adventur.ai/mcp/tools/rewrite_post/): Generate 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.
- [run_x_automation](https://docs.adventur.ai/mcp/tools/run_x_automation/): Show what the workspace's X automation rules would do to its own published X posts right now, without waiting for the nightly sweep.
- [save_thought](https://docs.adventur.ai/mcp/tools/save_thought/): Save a thought, tip, opinion, story or lesson the user wants to post about, e.g.
- [schedule_post_group](https://docs.adventur.ai/mcp/tools/schedule_post_group/): Schedule or reschedule an approved post group: pass scheduledForUtc (ISO 8601 UTC) or useBestSlot: true.
- [send_reply](https://docs.adventur.ai/mcp/tools/send_reply/): Post a reply from the user's account: to a mention on X, or as a comment on a Reddit thread (platform 'reddit').
- [suggest_reddit_listening](https://docs.adventur.ai/mcp/tools/suggest_reddit_listening/): Suggest 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.
- [suggest_slots](https://docs.adventur.ai/mcp/tools/suggest_slots/): Suggest the best times to publish on a platform (x, linkedin or tiktok) over the next week, ranked, each with a reason, e.g.
- [suggest_x_accounts](https://docs.adventur.ai/mcp/tools/suggest_x_accounts/): Find X accounts the user's target audience follows, so replying to them early puts the user in front of that audience.
- [update_brand_kit](https://docs.adventur.ai/mcp/tools/update_brand_kit/): Save changes to the workspace's brand kit: colours, fonts, logo, tagline and website.
- [update_dm_conversation](https://docs.adventur.ai/mcp/tools/update_dm_conversation/): Update a tracked X DM conversation (ids from list_dm_conversations).
- [update_engagement_settings](https://docs.adventur.ai/mcp/tools/update_engagement_settings/): Choose whose posts the reply inbox watches: watchHandles is the full list of X handles in the user's community (up to 10, e.g.
- [update_launch_step](https://docs.adventur.ai/mcp/tools/update_launch_step/): Mark a step of a launch kit's plan done (or not done), e.g.
- [update_newsjacking_settings](https://docs.adventur.ai/mcp/tools/update_newsjacking_settings/): Turn the newsjacking autopilot on or off (enabled) and set maxDraftsPerDay (1-3).
- [update_post](https://docs.adventur.ai/mcp/tools/update_post/): Edit one platform variant of a post: its copy (contentText), media or platformPayload.
- [update_post_group](https://docs.adventur.ai/mcp/tools/update_post_group/): Edit a post group's shared details: title, topic, objective, timezone or tags (tagIds).
- [update_reply_draft](https://docs.adventur.ai/mcp/tools/update_reply_draft/): Edit 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.
- [update_thought](https://docs.adventur.ai/mcp/tools/update_thought/): Edit 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).
- [update_x_automation_rules](https://docs.adventur.ai/mcp/tools/update_x_automation_rules/): Set the rules for the workspace's own published X posts.

## REST API reference
- [AI](https://docs.adventur.ai/api/reference/ai/)
- [Analytics](https://docs.adventur.ai/api/reference/analytics/): Performance summaries, top posts and whole-account X analytics.
- [Autonomy](https://docs.adventur.ai/api/reference/autonomy/)
- [Billing](https://docs.adventur.ai/api/reference/billing/): Plan, subscription, invoices and usage credits.
- [Brand](https://docs.adventur.ai/api/reference/brand/): The brand profile and the brand kit used by every visual.
- [Content research](https://docs.adventur.ai/api/reference/content-research/)
- [Context](https://docs.adventur.ai/api/reference/context/): Documents and synced sources that ground what AdVentur.ai writes.
- [Drafts](https://docs.adventur.ai/api/reference/drafts/): Create draft posts that wait in Review for approval.
- [Feedback](https://docs.adventur.ai/api/reference/feedback/)
- [Home](https://docs.adventur.ai/api/reference/home/): The daily operating brief.
- [Inspiration](https://docs.adventur.ai/api/reference/inspiration/): Inspiration items, trends, niche news and viral formats.
- [Invitations](https://docs.adventur.ai/api/reference/invitations/)
- [Launch kits](https://docs.adventur.ai/api/reference/launch-kits/): Launch kits and their day-by-day plans.
- [Linkedin pages](https://docs.adventur.ai/api/reference/linkedin-pages/)
- [Media](https://docs.adventur.ai/api/reference/media/): Uploads, imports and the media library.
- [Newsjacking](https://docs.adventur.ai/api/reference/newsjacking/)
- [Notifications](https://docs.adventur.ai/api/reference/notifications/)
- [Onboarding](https://docs.adventur.ai/api/reference/onboarding/)
- [Post groups](https://docs.adventur.ai/api/reference/post-groups/): Approve, schedule, reject and edit groups of cross-posted variants.
- [Posts](https://docs.adventur.ai/api/reference/posts/): List, edit and publish individual platform posts.
- [Public](https://docs.adventur.ai/api/reference/public/): Unauthenticated endpoints: pricing, waitlist and this spec.
- [Reply inbox](https://docs.adventur.ai/api/reference/engagement/): The reply inbox, Engage feeds and Reddit listening.
- [Rewrite](https://docs.adventur.ai/api/reference/rewrite/)
- [Scheduler](https://docs.adventur.ai/api/reference/scheduler/): Best-time suggestions, posting windows and schedule coverage.
- [Settings](https://docs.adventur.ai/api/reference/settings/)
- [Social accounts](https://docs.adventur.ai/api/reference/accounts/): Connect, list and update the social accounts a workspace publishes to.
- [Strategy](https://docs.adventur.ai/api/reference/strategy/): Positioning, audience, content pillars, priorities and recommendations.
- [Suggestions](https://docs.adventur.ai/api/reference/suggestions/)
- [Tags](https://docs.adventur.ai/api/reference/tags/)
- [Thoughts](https://docs.adventur.ai/api/reference/thoughts/): Saved thoughts and the drafts made from them.
- [Threads](https://docs.adventur.ai/api/reference/threads/): Draft X threads.
- [Usage](https://docs.adventur.ai/api/reference/usage/)
- [Users](https://docs.adventur.ai/api/reference/users/): The signed-in user's profile.
- [Visuals](https://docs.adventur.ai/api/reference/visuals/): Render on-brand images, carousels and app screenshots.
- [Workspaces](https://docs.adventur.ai/api/reference/workspaces/): Create and list workspaces (organisations).
- [X automation](https://docs.adventur.ai/api/reference/automation/): Rules that repost or delete the workspace's own X posts, and their runs.
- [X DMs](https://docs.adventur.ai/api/reference/dms/): Tracked X DM conversations and drafted messages.
- [X posts](https://docs.adventur.ai/api/reference/x-posts/)

## Optional
- [Changelog](https://docs.adventur.ai/changelog/)