Skip to Content

X

Service domainSOCIAL MEDIA
X icon
Arcade Optimized

Arcade.dev LLM tools for X (Twitter)

Author:Arcade
Version:1.4.2
Auth:User authorization via the X auth provider
8tools
PyPI VersionPython VersionsWheel StatusDownloadsLicense

X provider toolkit enables programmatic access to X (Twitter) for reading and managing tweets and user profiles, optimized for LLM-driven flows. It supports posting, replying, deleting, searching recent tweets, and retrieving the authenticated account.

Capabilities

  • Query and filter recent tweets and user timelines with keyword and username search.
  • Compose and manage tweet lifecycle: create non-reply posts, reply/quote responsibly, and delete owned tweets.
  • Access authenticated identity and act on behalf of the user within granted scopes.
  • Enforce action constraints and parameter validation (e.g., use Post for non-replies, Reply for replies, include quote_tweet_id when quoting).

OAuth Provider: x Scopes: tweet.read, tweet.write, users.read

Available tools(8)

8 of 8 tools
Operations
Behavior
Tool nameDescriptionSecrets
Delete a tweet on X (Twitter).
Look up a user on X (Twitter) by their username.
Look up a tweet on X (Twitter) by tweet ID.
Post a tweet to X (Twitter). IMPORTANT NOTE: Use this tool ONLY when posting a tweet that is not a reply. If you need to reply to a tweet, use the ReplyToTweet tool instead. If you need to quote a tweet, you must include the quote_tweet_id parameter.
Reply to a tweet on X (Twitter). IMPORTANT NOTE: Use this tool ONLY when replying to a tweet directly. If you need to post a tweet that is not a reply, use the PostTweet tool instead. If you need to quote a tweet on your reply, you must include the quote_tweet_id parameter.
Search for recent tweets (last 7 days) on X (Twitter) by required keywords and phrases. Includes replies and reposts. One of the following input parameters MUST be provided: keywords, phrases
Search for recent tweets (last 7 days) on X (Twitter) by username. Includes replies and reposts.
Get information about the authenticated X (Twitter) user. Returns the current user's profile including their username, name, description, follower counts, and other account information.

Selected tools

No tools selected.

Click "Show all tools" to add tools.

Requirements

Select tools to see requirements

#

X.DeleteTweetById

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Delete
Service domains
Social media
MCP behavior
Read only
No

Does not modify remote state.

Destructive
Yes

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Delete a tweet on X (Twitter).

Parameters

ParameterTypeReq.Description
tweet_idstringRequiredThe ID of the tweet you want to delete

Requirements

No secrets required

Output

Type:stringSuccess string confirming the tweet deletion
#

X.LookupSingleUserByUsername

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Social media
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

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

Parameters

ParameterTypeReq.Description
usernamestringRequiredThe username of the X (Twitter) user to look up

Requirements

No secrets required

Output

Type:jsonUser information including id, name, username, and description
#

X.LookupTweetById

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Social media
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

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

Parameters

ParameterTypeReq.Description
tweet_idstringRequiredThe ID of the tweet you want to look up

Requirements

No secrets required

Output

Type:jsonDictionary containing the tweet data
#

X.PostTweet

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
Social media
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Post a tweet to X (Twitter). IMPORTANT NOTE: Use this tool ONLY when posting a tweet that is not a reply. If you need to reply to a tweet, use the ReplyToTweet tool instead. If you need to quote a tweet, you must include the quote_tweet_id parameter.

Parameters

ParameterTypeReq.Description
tweet_textstringRequiredThe text content of the tweet you want to post
quote_tweet_idstringOptionalThe ID of the tweet you want to quote. It must be a valid integer as a string. Default is None.

Requirements

No secrets required

Output

Type:stringSuccess string and the URL of the tweet
#

X.ReplyToTweet

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Create
Service domains
Social media
MCP behavior
Read only
No

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
No

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Reply to a tweet on X (Twitter). IMPORTANT NOTE: Use this tool ONLY when replying to a tweet directly. If you need to post a tweet that is not a reply, use the PostTweet tool instead. If you need to quote a tweet on your reply, you must include the quote_tweet_id parameter.

Parameters

ParameterTypeReq.Description
tweet_idstringRequiredThe ID of the tweet you want to reply to. It must be a valid integer as a string.
tweet_textstringRequiredThe text content of the tweet you want to post
quote_tweet_idstringOptionalThe ID of the tweet you want to quote. It must be a valid integer as a string. Optional.

Requirements

No secrets required

Output

Type:stringSuccess string and the URL of the tweet
#

X.SearchRecentTweetsByKeywords

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Social media
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Search for recent tweets (last 7 days) on X (Twitter) by required keywords and phrases. Includes replies and reposts. One of the following input parameters MUST be provided: keywords, phrases

Parameters

ParameterTypeReq.Description
keywordsarray<string>OptionalList of keywords that must be present in the tweet
phrasesarray<string>OptionalList of phrases that must be present in the tweet
max_resultsintegerOptionalThe maximum number of results to return. Must be in range [1, 100] inclusive
next_tokenstringOptionalThe pagination token starting from which to return results

Requirements

No secrets required

Output

Type:jsonDictionary containing the search results
#

X.SearchRecentTweetsByUsername

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Social media
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Search for recent tweets (last 7 days) on X (Twitter) by username. Includes replies and reposts.

Parameters

ParameterTypeReq.Description
usernamestringRequiredThe username of the X (Twitter) user to look up
max_resultsintegerOptionalThe maximum number of results to return. Must be in range [1, 100] inclusive
next_tokenstringOptionalThe pagination token starting from which to return results

Requirements

No secrets required

Output

Type:jsonDictionary containing the search results
#

X.WhoAmI

Execution hints

Signals for MCP clients and agents about how this tool behaves.

Operations
Read
Service domains
Social media
MCP behavior
Read only
Yes

Does not modify remote state.

Destructive
No

May delete or overwrite remote data.

Idempotent
Yes

Safe to retry without extra side effects.

Open world
Yes

Can call out to external systems.

Get information about the authenticated X (Twitter) user. Returns the current user's profile including their username, name, description, follower counts, and other account information.

Parameters

No parameters required.

Requirements

No secrets required

Output

Type:jsonAuthenticated user's profile information
Last updated on