x-organic-mcp-server

# X (Twitter) MCP Server by Insightful Pipe

[![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-blue)](https://insightfulpipe.com/mcp-servers/x-organic)
[![Insightful Pipe](https://img.shields.io/badge/Insightful_Pipe-MCP_Servers-purple)](https://insightfulpipe.com/mcp-servers)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

> **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](https://insightfulpipe.com/mcp-servers). 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](https://github.com/Insightful-Pipe/x-ads-mcp-server) instead. It connects with an X sign-in and needs no developer app.

[![Explore All MCP Servers](https://img.shields.io/badge/Explore_All-MCP_Servers-blue?style=for-the-badge)](https://insightfulpipe.com/mcp-servers)

![X MCP Server](https://insightfulpipe.com/images/x-social-media-black-icon.svg)

## 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](https://console.x.com) 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](https://claude.ai/settings/connectors) (**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](https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt)

### Claude Code

```bash
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):

```json
{
  "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)

<details>
<summary>Show all 59 read actions</summary>

| 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 |

</details>

### Write Actions (23)

<details>
<summary>Show all 23 write actions</summary>

| 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 |

</details>

### Destructive Actions (10, off by default)

<details>
<summary>Show all 10 destructive actions</summary>

| 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 u