X Organic
X Organic MCPSocial Media92 actions

X (Twitter) MCP Server

Let your AI agents run X Organic for you, safely.

A hosted X Organic MCP server for Claude, ChatGPT, Cursor and CLI agents. Paste one server URL into your AI client to use its 92 actions. There is nothing to install.

  • Enable or disable every action, per account. Block your agent from doing dangerous actions.

  • Ask in plain English. Pull reports, find insights and take action in X Organic.

  • 92 read and write actions. Every X Organic task your agent needs, from reporting to making changes.

  • Built for teams. Invite your team and share one connected account.

Works with
ChatGPTChatGPTClaudeClaudeClaude CodeClaude CodeCodexCodexGemini CLIGemini CLICursorCursorMistralMistralOpenClawOpenClawHermesHermesPerplexityGrokn8nWindsurfVS CodeZed
ChatGPT
X Organic
ChatGPT
connected to X Organic MCP
Online
ChatGPT
Actions

Available Actions

92 actions available to automate your X Organic workflows.

92 actions

X Organic
Write

Add List Member

Add a user to a list.

X Organic
Write

Add Media Subtitles

Attach an uploaded subtitle file to an uploaded video.

X Organic
Write

Block User

Block a user.

X Organic
Write

Create Article Draft

Create a draft long-form Article. Nothing is published until publish_article.

X Organic
Write

Create Dm Group

Start a group conversation with a first message.

X Organic
Write

Create List

Create a list owned by the connected account.

X Organic
Write

Create Post

Publish a post, reply or thread leg on the connected X account.

X Organic
Write

Delete Dm Event

Delete a message the connected account sent.

X Organic
Write

Delete List

Delete a list owned by the connected account.

X Organic
Write

Delete Media Subtitles

Remove one subtitle language from an uploaded video.

X Organic
Write

Delete Post

Delete one of the connected account's posts.

X Organic
Write

Dm Block User

Stop a user from sending direct messages.

X Organic
Write

Dm Unblock User

Allow a user's direct messages again.

X Organic
Write

Edit Post

Edit a recent post. X allows edits only on eligible accounts and within its edit window.

X Organic
Write

Follow List

Follow a list.

X Organic
Read

Get API Usage

Post reads this X app has used, by day.

X Organic
Read

Get Blocked Users

Accounts the connected account blocks.

X Organic
Read

Get Bookmark Folder Posts

Posts saved in one bookmark folder.

X Organic
Read

Get Bookmark Folders

The connected account's bookmark folders.

X Organic
Read

Get Bookmarks

The connected account's bookmarked posts.

X Organic
Read

Get Community

Look up one community.

X Organic
Read

Get Credit Balance

The X developer account's remaining API credit, in USD.

X Organic
Read

Get Dm Conversation Events

Message events in one conversation.

X Organic
Read

Get Dm Event

One direct message event.

X Organic
Read

Get Dm Events

Recent direct message events across the connected account's conversations.

X Organic
Read

Get Dm Events With User

Message events in the one-to-one conversation with a user.

X Organic
Read

Get Followed Lists

Lists a user follows.

X Organic
Read

Get Followers

A user's followers.

X Organic
Read

Get Following

Accounts a user follows.

X Organic
Read

Get Home Timeline

The connected account's home timeline, newest first.

X Organic
Read

Get Liked Posts

Posts a user has liked.

X Organic
Read

Get Liking Users

List users who liked a post.

X Organic
Read

Get List

Look up one list.

X Organic
Read

Get List Followers

Accounts following a list.

X Organic
Read

Get List Members

Members of a list.

X Organic
Read

Get List Memberships

Lists a user is a member of.

X Organic
Read

Get List Posts

Recent posts from a list's members.

X Organic
Read

Get Me

The connected X account, including its subscription tier.

X Organic
Read

Get Media

Look up one media item by media key.

X Organic
Read

Get Media Analytics

Playback analytics for up to 100 media items over a time range.

X Organic
Read

Get Media By Keys

Look up to 100 media items by media key.

X Organic
Read

Get Media Upload Status

Processing state of an uploaded video.

X Organic
Read

Get Muted Users

Accounts the connected account mutes.

X Organic
Read

Get News Story

Read one news story.

X Organic
Read

Get Owned Lists

Lists a user owns.

X Organic
Read

Get Personalized Trends

Trends personalized for the connected account.

X Organic
Read

Get Pinned Lists

Lists the connected account pinned.

X Organic
Read

Get Post

Read one post by id.

X Organic
Read

Get Post Analytics

Engagement analytics for up to 100 posts over a time range.

X Organic
Read

Get Post Counts All

Count posts matching a query across the full archive, where the X plan allows it.

X Organic
Read

Get Post Counts Recent

Count posts matching a query over the last 7 days.

X Organic
Read

Get Posts

Read up to 100 posts by id.

X Organic
Read

Get Quote Posts

List posts that quote a post.

X Organic
Read

Get Reposted By

List users who reposted a post.

X Organic
Read

Get Reposts

List the repost entries of a post.

X Organic
Read

Get Reposts Of Me

Reposts of the connected account's posts.

X Organic
Read

Get Space

Look up one Space.

X Organic
Read

Get Space Posts

Posts shared in a Space.

X Organic
Read

Get Spaces

Look up to 100 Spaces by id.

X Organic
Read

Get Spaces By Creators

Live or scheduled Spaces hosted by up to 100 users.

X Organic
Read

Get Trends By Location

Trending topics for a location, by Yahoo WOEID (1 is worldwide).

X Organic
Read

Get User

Look up one user by id.

X Organic
Read

Get User Affiliates

Accounts affiliated with a verified organization.

X Organic
Read

Get User By Username

Look up one user by handle.

X Organic
Read

Get User Mentions

List posts that mention a user, newest first.

X Organic
Read

Get User Posts

List a user's posts, newest first.

X Organic
Read

Get Users

Look up to 100 users by id.

X Organic
Read

Get Users By Usernames

Look up to 100 users by handle.

X Organic
Write

Hide Reply

Hide a reply to one of the connected account's conversations.

X Organic
Write

Mute User

Mute a user.

X Organic
Write

Pin List

Pin a list.

X Organic
Write

Publish Article

Publish a draft Article publicly.

X Organic
Write

Remove List Member

Remove a user from a list.

X Organic
Write

Repost Post

Repost a post from the connected account.

X Organic
Read

Search All Posts

Search the full post archive, where the X plan allows it.

X Organic
Read

Search Communities

Search communities by keyword.

X Organic
Read

Search News

Search X's news stories.

X Organic
Read

Search Recent Posts

Search posts from the last 7 days.

X Organic
Read

Search Spaces

Search Spaces by title.

X Organic
Read

Search Users

Search users by keyword.

X Organic
Write

Send Dm

Send a direct message to one user.

X Organic
Write

Send Dm To Conversation

Send a direct message into an existing conversation.

X Organic
Write

Set Media Alt Text

Attach alt text to uploaded media before it is posted.

X Organic
Write

Unblock User

Unblock a user.

X Organic
Write

Undo Repost

Undo a repost made by the connected account.

X Organic
Write

Unfollow List

Stop following a list.

X Organic
Write

Unhide Reply

Show a reply that was hidden.

X Organic
Write

Unmute User

Unmute a user.

X Organic
Write

Unpin List

Unpin a list.

X Organic
Write

Update List

Rename a list, change its description, or make it private or public.

X Organic
Write

Upload Media

Upload one image, GIF or subtitle file and return its media id.

X Organic
Write

Upload Video

Upload a video in segments and return its media id.

Compare

X Organic MCP servers compared: hosted vs official

X offers its own hosted X MCP server for the X API. It is a good fit if you want X's search, lookup, bookmark and Article tools and are happy to run X's local bridge. InsightfulPipe is a hosted alternative for teams that want to post, reply and message from their AI assistant, with account-level controls.

HostingHosted by InsightfulPipe: paste one URL into your AI clientHosted by X at api.x.com/mcp, reached through the local xurl mcp bridge or an app-only token
SetupYour own X app: paste its four keys into InsightfulPipe onceYour own X app with OAuth 2.0 on Pay-per-use, a localhost redirect URI, Node.js for the bridge and a browser login on first run
PostingPosts, replies, threads, edits, reposts and ArticlesNo tool for creating posts is listed; writes are bookmarks and Articles
Direct messagesRead conversations, send messages and start group conversationsNot listed
Reading59 read actions: timelines, mentions, search and counts, post and video analytics, users, lists, Spaces, communities, trends and newsFull-archive search, users, timelines, mentions, bookmarks, trends and news
ControlsRead-only connections, per-account action controls, destructive actions off by defaultThe OAuth scopes of the account that logs in
Other platformsX Ads, Google Ads, Meta Ads and 47 more MCP serversX API only
PriceIncluded in plans from $29.99/month; X bills the API calls to your appNo price listed for the MCP; the app must be on X's Pay-per-use plan
Overview

What you can do with the X Organic MCP

The InsightfulPipe X Organic MCP server is a hosted Model Context Protocol server that connects an X (Twitter) account to AI assistants such as Claude, ChatGPT, Cursor, Claude Code, Gemini CLI and Codex. It runs on your own X developer app: you paste the app's four keys into InsightfulPipe once, then paste one server URL into your AI client.

ClaudeX OrganicAcme StoreRead-only
Ask about your X Organic account…
01Publish posts and threads

Publish posts and threads

Draft a post or a thread in the chat, review it, and publish it with images or video once it reads right.

See all X Organic actions
ClaudeX OrganicAcme StoreRead-only
Ask about your X Organic account…
02Reply to mentions

Reply to mentions

Read new mentions and replies, draft answers, and post the ones you approve.

See all X Organic actions
ClaudeX OrganicAcme StoreRead-only
Ask about your X Organic account…
03Post performance

Post performance

Compare engagement analytics across up to 100 posts at a time to see which topics and formats work.

See all X Organic actions
92
actions
one server URL
59
read actions
reports, audits, research
33
write actions
create, update, manage
Setup

How to connect the X Organic MCP server

Add the server URL to your AI client, then sign in with your InsightfulPipe account if asked. The server is hosted, so there is nothing to install.

MCP server URL

https://x-organic.insightfulmcp.com/

Connect X Organic to Claude

Fastest: add InsightfulPipe from the Claude Directory

One click connects the full InsightfulPipe MCP with all your connected accounts. To add a server scoped to X Organic only, follow the steps below.

Open Claude Directory

Or add the X Organic server manually:

  1. 01
    Copy the server URL:
    https://x-organic.insightfulmcp.com/
  2. 02
    Open Claude connector settings (Customize > Connectors), click + and then Add custom connector.
  3. 03
    Paste the URL and click Add.
  4. 04
    Click Connect and sign in to InsightfulPipe if asked. Claude then lists the connector as connected.

Start a new chat, click +, open Connectors and turn the connector on to use it.

The Free plan can add one custom connector. On Team and Enterprise plans, an Owner first adds it under Organization settings > Connectors, then each member clicks Connect in Customize > Connectors.

Watch the setup tutorial

Playbook

Prompts and skills that run on the X Organic MCP

Copy a prompt into any connected client, or install a Claude skill that chains the actions for you.

Prompt

“Which of my posts from the last 30 days got the most engagement?”

Reads your posts and their analytics

Prompt

“Show this week's mentions and draft replies for me to approve”

Reads mentions, then replies after approval

Prompt

“Publish this thread of four posts with the image attached to the first one”

Uploads media and posts a thread

Prompt

“How many posts mentioned our launch in the last 7 days?”

Counts recent posts for a search query

Prompt

“What is trending in the United States right now?”

Reads trends for a location

Prompt

“Send a direct message thanking @handle for the feedback”

Sends a direct message

Prompt

“How much API credit is left on my X app?”

Reads the developer account's credit balance

HAVE QUESTIONS?

Frequently asked questions

An X MCP server connects an X (formerly Twitter) account to AI assistants through the Model Context Protocol (MCP), an open standard for giving AI tools access to data and actions. Once connected, you can ask Claude, ChatGPT or Cursor to draft and publish posts, read your mentions or check how posts performed, instead of working in the X app.

Ready to connect your data?

Join hundreds of agencies and brands using InsightfulPipe to connect marketing data to AI.

Start a trial today.