MCP INTEGRATION GUIDE
MCP lets a compatible AI app use Ritomira data and posting tools. You need a Ritomira Standard or higher plan and an app that supports remote MCP connections.
Available on Standard, Pro and Premium
For an overview of what MCP integration can do, see the feature page. What MCP integration can do
Connection URL
https://mcp.ritomira.com/mcpIf asked for a transport, choose HTTP (Streamable HTTP).
Ritomira Standard, Pro and Premium include MCP. Also check that your app supports remote MCP and meets its own usage requirements.
In an MCP-compatible app such as Claude (desktop or web), Claude Code, ChatGPT or Codex, add a new MCP server or connector and enter the URL above. Setting names vary by app.
When the page opens, log in to Ritomira with your email address or Google. Use the Ritomira account that has the X account you want to use connected.
Review the X account and allowed actions on the consent page, then approve the connection. Return to your app and start by asking to review your posts.
Choose the setup instructions for your app. After adding Ritomira, try the read-only example below.
In Claude, open Customize → Connectors and add a custom connector.
Name it Ritomira and enter the connection URL. Connect with OAuth, sign in to Ritomira, and review the account and allowed actions.
Enable Ritomira in Claude, then send the example below.
Your organization may require an administrator to allow or add a custom connector.
Official setup instructionsRun this command in your terminal (to use Ritomira in every project).
claude mcp add --transport http --scope user ritomira https://mcp.ritomira.com/mcpOpen /mcp in Claude Code, select ritomira and authenticate. Sign in to Ritomira in the browser and approve.
After authentication, check that Ritomira tools are available, then send the example below.
This connection uses OAuth. You can remove Ritomira from the MCP settings in Claude Code.
Official setup instructionsIn ChatGPT Plugins, select +, then Add custom MCP server.
Name it Ritomira, enter the connection URL, and select OAuth authentication.
Sign in to Ritomira and review the account and allowed actions. Install and enable the new Ritomira plugin, then send the example below.
Available options depend on your ChatGPT plan and workspace settings. Adding this custom connection does not mean Ritomira is listed in the official store.
Official setup instructionsIn a terminal with Codex CLI installed, run the add command.
codex mcp add ritomira --url https://mcp.ritomira.com/mcpThen run the authentication command, sign in to Ritomira in the browser, and approve access.
codex mcp login ritomiraOpen /mcp in Codex to check Ritomira, then send the example below.
Adding and authenticating are separate steps. To remove the connection, run codex mcp remove ritomira.
Official setup instructionsIn the app’s MCP settings, add the connection URL as a remote HTTP server.
Start OAuth authentication, sign in to Ritomira, and review the account and allowed actions.
Enable Ritomira in the app, then send the example below.
The app must support Streamable HTTP and OAuth. These generic steps do not mean every app has been tested.
After approving access, send this request in your chosen AI app. You can check access without changing action permissions.
List the social accounts connected to Ritomira, showing their names and platforms. If there is more than one, ask me to choose an account. Only perform read operations.An account response in your chosen app confirms that it can read. This page does not automatically detect an external app connection.
This JSON contains the server address only. Merge the ritomira entry into your existing .mcp.json, then complete OAuth in Claude Code. It contains no API keys or social account credentials. Keep your existing settings and follow the client-specific instructions above.
Download configuration example (JSON)“Show me the posts with the most engagement over the last 7 days.”
“Save this text as a Ritomira draft.”
“Schedule this draft for tomorrow at 9 AM.”
Show me my Ritomira analytics for the last 30 days
I pulled the last 30 days from Ritomira and compared them with the previous 30 days.
Both impressions and engagement are up. Compare the posts from your strongest days to decide the time slot and topic to try next.
Figures are illustrative samples. The AI app uses Ritomira tools (here, get_account_dashboard), within your plan and the actions you allow in Settings.
New connections allow read access only. You can turn on draft and scheduling actions yourself in Ritomira Settings (AI app integration permissions). After turning them on, reconnect Ritomira in your AI app to use them.
Review posts, impressions, engagement, top posts and posting times. Organizing and analyzing content themes requires Pro or higher.
Save post ideas as Ritomira drafts. Creating a draft does not publish it to X.
Manage Ritomira scheduled posts. A new reservation automatically publishes to X at its scheduled time, so verify the account, text and time before requesting it.
These are the Ritomira tools AI apps can use, within your plan and the actions you turn on in Ritomira settings.
get_x_actionRead the saved action state without resending or fetching the current follow relationship.list_articlesList saved article originals and published article candidatesget_articleRead an article from its sharing post ID or URLpreview_articleRead a fixed snapshot of an article revisionget_article_guideRead which formatting X articles support, how to convert it into article content, and the steps from saving to publishing (use before writing)validate_articleCheck an article’s blocks, links and image references without creating or publishing anythingget_account_dashboardCompare impressions, engagement, followers and post count with the previous periodget_posting_time_analysisSee engagement by day of week and time of dayget_posts_summarySummarize engagement across posts in a periodget_daily_statsSee daily impressions and engagementget_top_performing_postsSee your best-performing postslist_postsList posts with metrics, with filters and paginglist_received_repliesRead replies to your postsget_content_themesSee your content themes and a summary of your posting axisPro and aboveget_cluster_timelineSee how post counts per theme change over timePro and aboveget_insightsSee structural patterns of your successful postsget_experiment_reportList before/after experiments and see their resultslist_switchable_accountsList the accounts you can operate through MCP: your own, connected and team accountslist_draftsList saved draftsget_media_statusCheck how far an image or video upload got (URL issued, registered, attached or expired)list_scheduled_postsList scheduled posts, including status and failure reasonsappend_article_originalAppend blocks and images to a saved article originalsave_article_originalSave an editable article original in Ritomiraupdate_article_originalSave a new revision of an article originaldelete_article_originalDelete a Ritomira X article original and its history (X drafts and posts stay on X)create_article_draftCreate a private X article draft from a saved revisioncreate_draftCreate a draftupdate_draftEdit a draft’s text, planned time and mediadelete_draftDelete a draftappend_to_draft_threadAdd a thread continuation to a draftcreate_media_uploadIssue a URL for uploading an image or videoconfirm_media_uploadRegister an uploaded image or video as Ritomira mediaimport_post_mediaImport images and videos from a published post into Ritomira mediaimport_media_from_urlRegister an image or video from its URL as Ritomira mediaupdate_media_altSet alt text on mediaattach_media_to_draftAdd images or videos to a draft, keeping those already attacheddetach_media_from_draftRemove specific images or videos from a draftreschedule_articleChange when a scheduled article is published, or resume a cancelled or failed job at a future timeschedule_articleSchedule a saved revision and its X draft for future publicationcancel_article_scheduleCancel a scheduled article publicationattach_media_to_scheduled_postAdd images or videos to a scheduled post, keeping those already attacheddetach_media_from_scheduled_postRemove specific images or videos from a scheduled postcreate_scheduled_postSchedule a postupdate_scheduled_postEdit a scheduled post’s text, time, quote and mediadelete_scheduled_postCancel a scheduled postappend_to_scheduled_threadAdd a thread continuation to a scheduled postreschedule_failed_postReschedule a failed post for a future timeschedule_draftTurn a draft into a scheduled postunschedule_postCancel a schedule and return it to drafts without postingpublish_articlePublish a created X article draft immediatelyprepare_x_actionPrepare a reply to a received comment or an individual follow change. Returns the exact preview without executing the action on X.execute_x_actionExecute the exact approved preview. Reply sending also requires operator enablement and X eligibility. An uncertain result must be checked without resending.The article tools need an X account that can use Articles on X, such as X Premium.
MCP connections require Standard or higher; organizing and analyzing content themes requires Pro or higher. Check the Ritomira account you logged in with and the requirements of the requested action. Reconnect from your app after changing plans.
In Ritomira Settings, check that the actions you want are turned on. After turning them on, reconnect Ritomira in your AI app to use them.
Reconnect through your app’s MCP settings, log in to Ritomira, then review the X account and allowed actions and connect again.
MCP integration is included in Standard, Pro and Premium. It is unavailable on Free. Using the posting organizer (theme analysis) through MCP requires Pro or higher.
Compare plans and pricing