How to integrate X MCP with Atomic Agent

Connect Atomic Agent to X MCP. Search x posts about ai agents today, find trending technology topics on x, and more using natural language, with authentication handled for you.

X MCP logoX MCP
Oauth2

X MCP is X's hosted MCP server for searching posts, users, news, trends, Spaces, and communities. It provides a ready-to-use bridge for working with X data and account features.

96 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including X.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a X account. See the Atomic Agent documentation for installation instructions.

Also integrate X MCP with

How Atomic Agent connects to X

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect X to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in X. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your X account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the X MCP server, and what's possible with it?

The X MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your X account. It provides structured and secure access to posts, news, communities, lists, bookmarks, chats, broadcasts, and Article drafts, so your agent can retrieve content, organize lists and bookmarks, manage conversations, and create Article drafts on your behalf.

  • Post and news retrieval: Have your agent fetch posts by ID, retrieve groups of posts, review reposts and quoted posts, see who liked a post, check recent post counts, and get news stories.
  • List and community management: Let the agent create lists, follow lists, add members, review members and followers, read list posts, and retrieve community details.
  • Bookmark organization: Direct your agent to create bookmark folders, save posts to bookmarks, and remove saved posts when they are no longer useful.
  • Chat and moderation tasks: Instruct your agent to review conversations and message requests, inspect conversation events, accept requests, archive conversations, and manage chat moderators.
  • Broadcasts and Article drafts: Have your agent retrieve broadcast details and chat history, schedule or cancel broadcasts, manage broadcast sources, and create draft Articles.

Use X from Atomic Agent

With your account connected, ask Atomic Agent to work with X in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every X MCP action and event your agent gets out of the box.

Accept chat message request

Accept a Chat message request

Add chat moderator

Add a chat moderator

Add conversation keys

Add Conversation Keys

Add lists member

Add Lists Member

Archive chat conversation

Archive a Chat conversation

Article create draft

Create draft Article

Cancel scheduled call

Cancel a scheduled call

Chat media download

Download Chat Media.

Chat media upload append

Append Chat Media Upload.

Chat media upload finalize

Finalize Chat Media Upload.

Chat media upload initialize

Initialize Chat Media Upload.

Create lists

Create Lists

Create scheduled broadcast

Create a scheduled broadcast

Create source

Create a stream source

Create users bookmark

Create Bookmark

Create users bookmark folder

Create Bookmark Folder

Delete scheduled broadcast

Delete a scheduled broadcast

Delete source

Delete a stream source

Delete users bookmark

Delete Bookmark

Follow list

Follow List

Get broadcast

Get a broadcast

Get broadcast chat

Get broadcast chat history

Get chat conversation

Get Chat Conversation; unread state via chat_conversation.

Get chat conversation events

Get Chat Conversation Events, newest first; unread ones have an id above last_read_event_id

Get chat conversations

Get Chat Conversations; unread state via chat_conversation.

Get chat message request

Get Chat Message Request

Get chat message requests

Get Chat Message Requests

Get chat moderators

Get chat moderators

Get communities by

Get Communities by ID

Get lists by

Get Lists by ID

Get lists followers

Get Lists Followers

Get lists members

Get Lists Members

Get lists posts

Get Lists Posts

Get news

Get news stories by ID Each returned story includes a `url` deeplinking to its x.

Get posts by

Get Posts by ID Each returned post includes a `url` deeplinking to it on x.

Get posts by ids

Get Posts by IDs Each returned post includes a `url` deeplinking to it on x.

Get posts counts recent

Get Posts Counts Recent

Get posts liking users

Get Posts Liking Users

Get posts quoted posts

Get Posts Quoted Posts Each returned post includes a `url` deeplinking to it on x.

Get posts reposted by

Get Posts Reposted by

Get scheduled broadcast

Get a scheduled broadcast

Get scheduled call

Get a scheduled call

Get source

Get a stream source

Get spaces by creator ids

Get Spaces by Creator IDs

Get spaces by

Get Spaces by ID

Get spaces by ids

Get Spaces by IDs

Get spaces posts

Get Space Posts

Get trends by woeid

Get Trends by Woeid Each returned trend includes a `url` deeplinking to its x.

Get usage credits

Get usage credits

Get users bookmark folders

Get Users Bookmark Folders

Get users bookmarks

Get Users Bookmarks Each returned post includes a `url` deeplinking to it on x.

Get users bookmarks by folder

Get Users Bookmarks by Folder ID Each returned post includes a `url` deeplinking to it on x.

Get users by

Get Users by ID

Get users by username

Get Users by Username

Get users by usernames

Get Users by Usernames

Get users followed lists

Get Users Followed Lists

Get users liked posts

Get Users Liked Posts Each returned post includes a `url` deeplinking to it on x.

Get users list memberships

Get Users List Memberships

Get users me

Get Users Me

Get users me followers

Get the authenticated user's followers

Get users me following

Get the users the authenticated user follows

Get users mentions

Get Users Mentions Each returned post includes a `url` deeplinking to it on x.

Get users owned lists

Get Users Owned Lists

Get users pinned lists

Get Users Pinned Lists

Get users posts

Get Users Posts Each returned post includes a `url` deeplinking to it on x.

Get users public key

Get public keys

Get users public keys

Get public keys

Get users timeline

Get Users Timeline Each returned post includes a `url` deeplinking to it on x.

Go live scheduled broadcast

Go live on a scheduled broadcast

List broadcasts

List broadcasts

List scheduled broadcasts

List scheduled broadcasts

List scheduled calls

List scheduled calls

List sources

List stream sources

Mark chat conversation read

Mark Conversation as Read

Mark chat conversation unread

Mark Conversation as Unread

Mute broadcast chat user

Mute or time out a user in a broadcast chat

Pin list

Pin List

Remove chat moderator

Remove a chat moderator

Remove lists member by user

Remove a List member

Respond to scheduled call

Respond to a scheduled call

Schedule call

Schedule a call

Search communities

Search Communities

Search news

Search News Each returned story includes a `url` deeplinking to its x.

Search posts all

Search Posts All Each returned post includes a `url` deeplinking to it on x.

Search spaces

Search Spaces

Search users

Search Users

Send chat message

Send Chat Message

Send chat typing indicator

Send Typing Indicator

Unarchive chat conversation

Unarchive a Chat conversation

Unfollow list

Unfollow a List

Unmute broadcast chat user

Unmute a user in a broadcast chat

Unpin list

Unpin a List

Update lists

Update List

Update scheduled broadcast

Update a scheduled broadcast

Update scheduled call

Update a scheduled call

Update source

Rename a stream source

FAQ

Frequently asked questions

With a standalone X MCP server, the agents and LLMs can only access a fixed set of X tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from X and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right X tools.

Yes, absolutely. You can configure which X scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your X data and credentials are handled as safely as possible.

Start with X MCP.It takes 30 seconds.

Managed auth, hosted MCP servers, and every X MCP tool your agent needs.Free to start.

Start building