X (Twitter) MCP by InsightfulPipe

السجل الرسمي التسويق والمبيعات

Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.

ماذا يمكنك أن تفعل مع 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.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code
claude mcp add --transport http x-twitter-mcp-by-insightfulpipe 'https://x-organic.insightfulmcp.com/'
إعداد JSON (Claude Desktop وCursor وVS Code)
{
    "mcpServers": {
        "x-twitter-mcp-by-insightfulpipe": {
            "type": "http",
            "url": "https://x-organic.insightfulmcp.com/"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. X (Twitter) MCP Server by Insightful Pipe
  2. MCP Server URL
  3. What is the X Organic MCP server?
  4. Before you connect: your own X developer app
  5. Installation
  6. Available Actions
  7. Control What Your AI Can Do
  8. Usage Examples
  9. What It Can't Do
  10. Pricing
  11. Explore More MCP Servers by Insightful Pipe
  12. Support
  13. License

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.

  1. Sign in to the X Developer Console and create a Project and an app.
  2. Add credit under Billing → Credits.
  3. In the app's settings, set App permissions to Read and write and Direct message, and add the Callback URI shown in InsightfulPipe.
  4. Under Keys & Tokens, generate the Access Token and Access Token Secret.
  5. 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
  1. Copy the MCP Server URL: https://x-organic.insightfulmcp.com/
  2. Open Claude connector settings (Customize > Connectors), click + and then Add custom connector
  3. Paste the URL and click Add
  4. 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.

  1. Turn on Developer mode in ChatGPT settings
  2. Create a new app for a remote MCP server and paste the URL: https://x-organic.insightfulmcp.com/
  3. 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

ActionDescription
get_api_usagePost reads this X app has used, by day
get_blocked_usersAccounts the connected account blocks
get_bookmark_folder_postsPosts saved in one bookmark folder
get_bookmark_foldersThe connected account's bookmark folders
get_bookmarksThe connected account's bookmarked posts
get_communityLook up one community
get_credit_balanceThe X developer account's remaining API credit, in USD
get_dm_conversation_eventsMessage events in one conversation
get_dm_eventOne direct message event
get_dm_eventsRecent direct message events across the connected account's conversations
get_dm_events_with_userMessage events in the one-to-one conversation with a user
get_followed_listsLists a user follows
get_followersA user's followers
get_followingAccounts a user follows
get_home_timelineThe connected account's home timeline, newest first
get_liked_postsPosts a user has liked
get_liking_usersList users who liked a post
get_listLook up one list
get_list_followersAccounts following a list
get_list_membersMembers of a list
get_list_membershipsLists a user is a member of
get_list_postsRecent posts from a list's members
get_meThe connected X account, including its subscription tier
get_mediaLook up one media item by media key
get_media_analyticsPlayback analytics for up to 100 media items over a time range
get_media_by_keysLook up to 100 media items by media key
get_media_upload_statusProcessing state of an uploaded video
get_muted_usersAccounts the connected account mutes
get_news_storyRead one news story
get_owned_listsLists a user owns
get_personalized_trendsTrends personalized for the connected account
get_pinned_listsLists the connected account pinned
get_postRead one post by id
get_post_analyticsEngagement analytics for up to 100 posts over a time range
get_post_counts_allCount posts matching a query across the full archive, where the X plan allows it
get_post_counts_recentCount posts matching a query over the last 7 days
get_postsRead up to 100 posts by id
get_quote_postsList posts that quote a post
get_reposted_byList users who reposted a post
get_repostsList the repost entries of a post
get_reposts_of_meReposts of the connected account's posts
get_spaceLook up one Space
get_space_postsPosts shared in a Space
get_spacesLook up to 100 Spaces by id
get_spaces_by_creatorsLive or scheduled Spaces hosted by up to 100 users
get_trends_by_locationTrending topics for a location, by Yahoo WOEID (1 is worldwide)
get_userLook up one user by id
get_user_affiliatesAccounts affiliated with a verified organization
get_user_by_usernameLook up one user by handle
get_user_mentionsList posts that mention a user, newest first
get_user_postsList a user's posts, newest first
get_usersLook up to 100 users by id
get_users_by_usernamesLook up to 100 users by handle
search_all_postsSearch the full post archive, where the X plan allows it
search_communitiesSearch communities by keyword
search_newsSearch X's news stories
search_recent_postsSearch posts from the last 7 days
search_spacesSearch Spaces by title
search_usersSearch users by keyword
Write Actions (23)

Show all 23 write actions

ActionDescription
add_list_memberAdd a user to a list
add_media_subtitlesAttach an uploaded subtitle file to an uploaded video
block_userBlock a user
create_article_draftCreate a draft long-form Article. Nothing is published until publish_article
create_dm_groupStart a group conversation with a first message
create_listCreate a list owned by the connected account
create_postPublish a post, reply or thread leg on the connected X account
dm_block_userStop a user from sending direct messages
dm_unblock_userAllow a user's direct messages again
edit_postEdit a recent post. X allows edits only on eligible accounts and within its edit window
follow_listFollow a list
hide_replyHide a reply to one of the connected account's conversations
mute_userMute a user
pin_listPin a list
publish_articlePublish a draft Article publicly
repost_postRepost a post from the connected account
send_dmSend a direct message to one user
send_dm_to_conversationSend a direct message into an existing conversation
set_media_alt_textAttach alt text to uploaded media before it is posted
unhide_replyShow a reply that was hidden
update_listRename a list, change its description, or make it private or public
upload_mediaUpload one image, GIF or subtitle file and return its media id
upload_videoUpload a video in segments and return its media id
Destructive Actions (10, off by default)

Show all 10 destructive actions

ActionDescription
delete_dm_eventDelete a message the connected account sent
delete_listDelete a list owned by the connected account
delete_media_subtitlesRemove one subtitle language from an uploaded video
delete_postDelete one of the connected account's posts
remove_list_memberRemove a user from a list
unblock_userUnblock a user
undo_repostUndo a repost made by the connected account
unfollow_listStop following a list
unmute_userUnmute a user
unpin_listUnpin 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

View All MCP Servers →

Support


Insightful Pipe: AI-powered marketing analytics through MCP servers. Explore all integrations →

License

MIT License - see LICENSE for details.

الأسئلة الشائعة

ما هو X (Twitter) MCP by InsightfulPipe؟

Hosted X (Twitter) MCP server for Claude, ChatGPT and Cursor, with each action switched per account.

كيف أثبّت X (Twitter) MCP by InsightfulPipe؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http x-twitter-mcp-by-insightfulpipe 'https://x-organic.insightfulmcp.com/'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج X (Twitter) MCP by InsightfulPipe إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل X (Twitter) MCP by InsightfulPipe مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون X (Twitter) MCP by InsightfulPipe؟

ينشره Insightful-Pipe. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.