# X (formerly Twitter)

import ToolInfo from "@/app/_components/tool-info";
import Badges from "@/app/_components/badges";
import TabbedCodeBlock from "@/app/_components/tabbed-code-block";
import TableOfContents from "@/app/_components/table-of-contents";
import ToolFooter from "@/app/_components/tool-footer";
import { Callout } from "nextra/components";

<ToolInfo
  description="Enable agents to interact with X (formerly Twitter)."
  author="Arcade"
  authType="OAuth2"
  versions={["1.0.1"]}
/>

<Badges repo="arcadeai/arcade_x" />

The Arcade X (formerly Twitter) MCP Server provides a pre-built set of tools for interacting with X (formerly Twitter). These tools make it easy to build agents and AI apps that can:

- Post tweets
- Reply to tweets
- Quote tweets
- Delete tweets
- Search for tweets by username
- Search for tweets by keywords
- Look up a user by username

## Available Tools

<TableOfContents
  headers={["Tool Name", "Description"]}
  data={[
    [
      "X.LookupSingleUserByUsername",
      "Look up a user on X (Twitter) by their username.",
    ],
    ["X.PostTweet", "Post a tweet to X (Twitter)."],
    ["X.ReplyToTweet", "Reply to a tweet on X (Twitter)."],
    ["X.DeleteTweetById", "Delete a tweet on X (Twitter)."],
    [
      "X.SearchRecentTweetsByUsername",
      "Search for recent tweets (last 7 days) on X (Twitter) by username.",
    ],
    [
      "X.SearchRecentTweetsByKeywords",
      "Search for recent tweets (last 7 days) on X (Twitter) by required keywords and phrases.",
    ],
    ["X.LookupTweetById", "Look up a tweet on X (Twitter) by tweet ID."],
  ]}
/>

<Callout>
  If you need to perform an action that's not listed here, you can [get in touch
  with us](mailto:contact@arcade.dev) to request a new tool, or [create your own
  tools](/guides/create-tools/tool-basics/build-mcp-server).
</Callout>

## X.LookupSingleUserByUsername

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/x/lookup_single_user_by_username_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/x/lookup_single_user_by_username_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Look up a user on X (Twitter) by their username.

**Parameters**

- **username** (`string`, required) The username of the X (Twitter) user to look up

## X.PostTweet

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/x/post_tweet_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/x/post_tweet_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Post a tweet to X (Twitter).

**Parameters**

- **tweet_text** (`string`, required) The text content of the tweet you want to post
- **quote_tweet_id** (`string`, optional) The ID of the tweet you want to quote. Optional.

## X.ReplyToTweet

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/x/reply_to_tweet_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/x/reply_to_tweet_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Reply to a tweet on X (Twitter).

**Parameters**

- **tweet_id** (`string`, required) The ID of the tweet you want to reply to
- **tweet_text** (`string`, required) The text content of the tweet you want to post
- **quote_tweet_id** (`string`, optional) The ID of the tweet you want to quote. Optional.

## X.DeleteTweetById

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/x/delete_tweet_by_id_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/x/delete_tweet_by_id_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Delete a tweet on X (Twitter).

**Parameters**

- **tweet_id** (`string`, required) The ID of the tweet you want to delete

## X.SearchRecentTweetsByUsername

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/x/search_recent_tweets_by_username_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/x/search_recent_tweets_by_username_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Search for recent tweets (last 7 days) on X (Twitter) by username.

**Parameters**

- **username** (`string`, required) The username of the X (Twitter) user to look up
- **max_results** (`integer`, optional) The maximum number of results to return. Must be in range [1, 100] inclusive
- **next_token** (`string`, optional) The pagination token starting from which to return results

## X.SearchRecentTweetsByKeywords

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/x/search_recent_tweets_by_keywords_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/x/search_recent_tweets_by_keywords_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Search for recent tweets (last 7 days) on X (Twitter) by required keywords and phrases.

**Parameters**

- **keywords** (`array[string]`, optional) List of keywords that must be present in the tweet
- **phrases** (`array[string]`, optional) List of phrases that must be present in the tweet
- **max_results** (`integer`, optional) The maximum number of results to return. Must be in range [1, 100] inclusive
- **next_token** (`string`, optional) The pagination token starting from which to return results

## X.LookupTweetById

<br />
<TabbedCodeBlock
  tabs={[
    {
      label: "Call the Tool Directly",
      content: {
        Python: [
          "/examples/integrations/resources/integrations/x/lookup_tweet_by_id_example_call_tool.py",
        ],
        JavaScript: [
          "/examples/integrations/resources/integrations/x/lookup_tweet_by_id_example_call_tool.js",
        ],
      },
    },
  ]}
/>

Look up a tweet on X (Twitter) by tweet ID.

**Parameters**

- **tweet_id** (`string`, required) The ID of the tweet you want to look up

## Auth

The Arcade X MCP Sever uses the [X auth provider](/references/auth-providers/x) to connect to users' X accounts. Please refer to the [X auth provider](/references/auth-providers/x) documentation to learn how to configure auth.

<ToolFooter pipPackageName="arcade_x" />