X (Twitter) MCP by InsightfulPipe
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Que pouvez-vous faire avec X (Twitter) MCP by InsightfulPipe ?
- Liking posts, following users and creating quote posts are not available, because X removed them from its self-serve API plans. Reading likes, followers and quote posts works.
- Bookmarks are read-only.
- Full-archive search and archive counts depend on your X plan.
- Paid campaigns are covered by the X Ads MCP server.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http x-twitter-mcp-by-insightfulpipe 'https://x-organic.insightfulmcp.com/'
{
"mcpServers": {
"x-twitter-mcp-by-insightfulpipe": {
"type": "http",
"url": "https://x-organic.insightfulmcp.com/"
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
Sommaire
X (Twitter) MCP Server by Insightful Pipe
Connect your X (formerly Twitter) account to AI assistants to publish posts, replies and threads, read timelines and mentions, search posts, send direct messages and read post analytics.
Part of the Insightful Pipe MCP Server Collection. The X Organic MCP server gives Claude, ChatGPT, Cursor and other AI assistants 92 actions (59 read, 23 write and 10 destructive) on your X account. It is hosted, so there is nothing to install, and it runs on your own X developer app: X bills every API call to your developer account at its pay-per-use rates.
For paid campaigns, use the X Ads MCP server instead. It connects with an X sign-in and needs no developer app.
MCP Server URL
https://x-organic.insightfulmcp.com/
What is the X Organic MCP server?
A remote Model Context Protocol server that connects an X account to AI assistants. Your assistant can:
- Publish posts, replies and threads with images, GIFs or videos, alt text and subtitles
- Read your home timeline, any account's posts and mentions, replies, reposts and quote posts
- Search posts from the last 7 days, or the full archive where your X plan allows it, and count matches
- Read engagement analytics for up to 100 posts at a time, and video playback analytics
- Read and send direct messages
- Manage lists, mutes and blocks, and draft and publish Articles
- Check your X app's usage and remaining API credit
Before you connect: your own X developer app
X Organic uses your X developer app, so X bills each call to you.
- Sign in to the X Developer Console and create a Project and an app.
- Add credit under Billing → Credits.
- In the app's settings, set App permissions to Read and write and Direct message, and add the Callback URI shown in InsightfulPipe.
- Under Keys & Tokens, generate the Access Token and Access Token Secret.
- In InsightfulPipe, add the X Organic integration, choose Read-only or Read & write, and paste the Consumer Key, Secret Key, Access Token and Access Token Secret. This connects the X account that owns the app.
Installation
Claude
- Copy the MCP Server URL:
https://x-organic.insightfulmcp.com/ - Open Claude connector settings (Customize > Connectors), click + and then Add custom connector
- Paste the URL and click Add
- Click Connect and sign in to InsightfulPipe if asked. Claude then lists the connector as connected.
ChatGPT
Custom MCP servers are added through ChatGPT's Developer mode. Availability depends on your ChatGPT plan, and workspace admins may need to allow it.
- Turn on Developer mode in ChatGPT settings
- Create a new app for a remote MCP server and paste the URL:
https://x-organic.insightfulmcp.com/ - Sign in to InsightfulPipe if asked. The connection finishes as soon as you are signed in.
See OpenAI's guide: Developer mode and MCP apps in ChatGPT
Claude Code
claude mcp add --transport http x-organic https://x-organic.insightfulmcp.com/
Cursor
Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"x-organic": {
"url": "https://x-organic.insightfulmcp.com/"
}
}
}
When Cursor shows Needs authentication, click Connect and sign in to InsightfulPipe if asked.
Available Actions
92 actions: 59 read, 23 write and 10 destructive.
Read Actions (59)
Show all 59 read actions
| Action | Description |
|---|---|
get_api_usage | Post reads this X app has used, by day |
get_blocked_users | Accounts the connected account blocks |
get_bookmark_folder_posts | Posts saved in one bookmark folder |
get_bookmark_folders | The connected account's bookmark folders |
get_bookmarks | The connected account's bookmarked posts |
get_community | Look up one community |
get_credit_balance | The X developer account's remaining API credit, in USD |
get_dm_conversation_events | Message events in one conversation |
get_dm_event | One direct message event |
get_dm_events | Recent direct message events across the connected account's conversations |
get_dm_events_with_user | Message events in the one-to-one conversation with a user |
get_followed_lists | Lists a user follows |
get_followers | A user's followers |
get_following | Accounts a user follows |
get_home_timeline | The connected account's home timeline, newest first |
get_liked_posts | Posts a user has liked |
get_liking_users | List users who liked a post |
get_list | Look up one list |
get_list_followers | Accounts following a list |
get_list_members | Members of a list |
get_list_memberships | Lists a user is a member of |
get_list_posts | Recent posts from a list's members |
get_me | The connected X account, including its subscription tier |
get_media | Look up one media item by media key |
get_media_analytics | Playback analytics for up to 100 media items over a time range |
get_media_by_keys | Look up to 100 media items by media key |
get_media_upload_status | Processing state of an uploaded video |
get_muted_users | Accounts the connected account mutes |
get_news_story | Read one news story |
get_owned_lists | Lists a user owns |
get_personalized_trends | Trends personalized for the connected account |
get_pinned_lists | Lists the connected account pinned |
get_post | Read one post by id |
get_post_analytics | Engagement analytics for up to 100 posts over a time range |
get_post_counts_all | Count posts matching a query across the full archive, where the X plan allows it |
get_post_counts_recent | Count posts matching a query over the last 7 days |
get_posts | Read up to 100 posts by id |
get_quote_posts | List posts that quote a post |
get_reposted_by | List users who reposted a post |
get_reposts | List the repost entries of a post |
get_reposts_of_me | Reposts of the connected account's posts |
get_space | Look up one Space |
get_space_posts | Posts shared in a Space |
get_spaces | Look up to 100 Spaces by id |
get_spaces_by_creators | Live or scheduled Spaces hosted by up to 100 users |
get_trends_by_location | Trending topics for a location, by Yahoo WOEID (1 is worldwide) |
get_user | Look up one user by id |
get_user_affiliates | Accounts affiliated with a verified organization |
get_user_by_username | Look up one user by handle |
get_user_mentions | List posts that mention a user, newest first |
get_user_posts | List a user's posts, newest first |
get_users | Look up to 100 users by id |
get_users_by_usernames | Look up to 100 users by handle |
search_all_posts | Search the full post archive, where the X plan allows it |
search_communities | Search communities by keyword |
search_news | Search X's news stories |
search_recent_posts | Search posts from the last 7 days |
search_spaces | Search Spaces by title |
search_users | Search users by keyword |
Write Actions (23)
Show all 23 write actions
| Action | Description |
|---|---|
add_list_member | Add a user to a list |
add_media_subtitles | Attach an uploaded subtitle file to an uploaded video |
block_user | Block a user |
create_article_draft | Create a draft long-form Article. Nothing is published until publish_article |
create_dm_group | Start a group conversation with a first message |
create_list | Create a list owned by the connected account |
create_post | Publish a post, reply or thread leg on the connected X account |
dm_block_user | Stop a user from sending direct messages |
dm_unblock_user | Allow a user's direct messages again |
edit_post | Edit a recent post. X allows edits only on eligible accounts and within its edit window |
follow_list | Follow a list |
hide_reply | Hide a reply to one of the connected account's conversations |
mute_user | Mute a user |
pin_list | Pin a list |
publish_article | Publish a draft Article publicly |
repost_post | Repost a post from the connected account |
send_dm | Send a direct message to one user |
send_dm_to_conversation | Send a direct message into an existing conversation |
set_media_alt_text | Attach alt text to uploaded media before it is posted |
unhide_reply | Show a reply that was hidden |
update_list | Rename a list, change its description, or make it private or public |
upload_media | Upload one image, GIF or subtitle file and return its media id |
upload_video | Upload a video in segments and return its media id |
Destructive Actions (10, off by default)
Show all 10 destructive actions
| Action | Description |
|---|---|
delete_dm_event | Delete a message the connected account sent |
delete_list | Delete a list owned by the connected account |
delete_media_subtitles | Remove one subtitle language from an uploaded video |
delete_post | Delete one of the connected account's posts |
remove_list_member | Remove a user from a list |
unblock_user | Unblock a user |
undo_repost | Undo a repost made by the connected account |
unfollow_list | Stop following a list |
unmute_user | Unmute a user |
unpin_list | Unpin a list |
Control What Your AI Can Do
- Turn individual actions on or off for every connected account, so agents only see the actions you allow.
- Connect as Read-only or Read & write. A read-only connection can only enable read actions.
- Destructive actions stay off by default. Deleting posts and messages, undoing reposts and the other destructive actions are disabled until an admin enables them.
- Posts and messages go live at once. Publishing and sending direct messages are regular write actions, so turn them off for any account where agents should not post.
- No surprise spend. Results come 10 at a time and nothing pages automatically, and each write is sent once and never retried automatically.
Usage Examples
"Which of my posts from the last 30 days got the most engagement?"
"Show this week's mentions and draft replies for me to approve"
"Publish this thread of four posts with the image attached to the first one"
"How many posts mentioned our launch in the last 7 days?"
"How much API credit is left on my X app?"
What It Can't Do
- Liking posts, following users and creating quote posts are not available, because X removed them from its self-serve API plans. Reading likes, followers and quote posts works.
- Bookmarks are read-only.
- Full-archive search and archive counts depend on your X plan.
- Paid campaigns are covered by the X Ads MCP server.
Pricing
The X Organic MCP server is included in every InsightfulPipe plan, together with all other MCP servers and the CLI. Plans start at $29.99/month. X bills the API calls to your own developer account. See insightfulpipe.com/pricing for current plans.
Explore More MCP Servers by Insightful Pipe
Visit insightfulpipe.com/mcp-servers for the full collection of MCP servers for marketing and analytics.
Social MCP Servers
- X Ads MCP: X (Twitter) advertising
- Instagram MCP: Instagram posts, Reels and comments
- LinkedIn Pages MCP: company page analytics and posts
- Facebook Pages MCP: page insights and posts
Support
- Server page: insightfulpipe.com/mcp-servers/x-organic
- Documentation: insightfulpipe.com/docs
- Email: support@insightfulpipe.com
Insightful Pipe: AI-powered marketing analytics through MCP servers. Explore all integrations →
License
MIT License - see LICENSE for details.
Questions fréquentes
Qu'est-ce que X (Twitter) MCP by InsightfulPipe ?
Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Comment installer X (Twitter) MCP by InsightfulPipe ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http x-twitter-mcp-by-insightfulpipe 'https://x-organic.insightfulmcp.com/'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour X (Twitter) MCP by InsightfulPipe ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
X (Twitter) MCP by InsightfulPipe est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient X (Twitter) MCP by InsightfulPipe ?
Il est publié par Insightful-Pipe. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.