Skip to main content
Glama
getxapi-mcp

getxapi-mcp

Official
by getxapi

GetXAPI MCP: Twitter/X API for Claude, Cursor and any MCP client

npm License: MIT Status

The official GetXAPI MCP server. Give your AI assistant direct access to the Twitter/X API: search tweets, look up users, read replies and followers, and post tweets, send DMs, manage articles, and more, through one Model Context Protocol server.

Unlike read-only Twitter MCP servers, GetXAPI MCP can act: post tweets, reply, like, retweet, send DMs, and publish articles, not just read.

→ Get a free API key at getxapi.com · API docs · Pricing ($0.001/call, $0.05 per 1,000 tweets)


Install

Add it to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "getxapi": {
      "command": "npx",
      "args": ["-y", "@getxapi/mcp@latest"],
      "env": {
        "GETXAPI_KEY": "get-x-api-..."
      }
    }
  }
}

Get your GETXAPI_KEY from your GetXAPI dashboard. That's all the read tools need.

Or via the Claude Code CLI:

claude mcp add getxapi -- npx -y @getxapi/mcp@latest

Related MCP server: x-mcp

What you can do

Once installed, just ask your assistant naturally:

"Find Elon Musk's latest tweets" "Search tweets about OpenAI from the last week" "Who are @vercel's verified followers?" "Get the replies to this tweet: 1799…" "Post 'shipping 🚀' to my X account" (requires X auth, see below)


Read vs. write tools

Needs

Examples

Read

GETXAPI_KEY only

search tweets, user info, followers/following, replies, mentions, user tweets, lists

Write / private

GETXAPI_KEY + X account auth

post / reply / like / retweet / bookmark / delete tweet, send DM, read DMs/timeline/bookmarks, publish articles, update profile

Enabling write tools

Write and private tools act on a real X account, so they need that account's auth. Two ways to provide it:

Option A, log in through the assistant (convenient):

"Log in to my X account"

The assistant calls the x_login tool with your credentials and keeps the session for write tools. ⚠️ Your X password is passed as tool arguments, so it transits the AI model's context. For sensitive accounts, prefer Option B.

Option B, set credentials in config (recommended for sensitive accounts):

{
  "mcpServers": {
    "getxapi": {
      "command": "npx",
      "args": ["-y", "@getxapi/mcp@latest"],
      "env": {
        "GETXAPI_KEY": "get-x-api-...",
        "X_AUTH_TOKEN": "...",
        "X_CT0": "...",
        "X_TWID": "...",
        "X_PROXY": "http://user:pass@host:port"
      }
    }
  }
}

X_CT0, X_TWID, and X_PROXY are optional. X_AUTH_TOKEN alone is enough for most write tools; the others improve reliability on some accounts.

Your X password never touches the model. The credential fields are never shown to the AI. The server injects them only into the calls that need them.


How billing works

Every tool call is a normal GetXAPI API call authenticated with your GETXAPI_KEY, metered exactly like direct API usage. No separate MCP billing. See pricing.


GetXAPI is an independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by X Corp.

License

MIT

Available Tools

53 tools
advanced_search_tweetsB
Read-only

Search tweets with advanced operators using GetXAPI

Inputs: q (required), cursor, product.

bookmark_tweetC

Bookmark a tweet programmatically via API

Inputs: tweet_id (required).

check_follow_relationshipB
Read-only

Check if one Twitter user follows another via API

Inputs: source_user_name (required), target_user_name (required).

create_articleB

Create (and optionally publish) a long-form Twitter/X article in one call

Inputs: title (required), content (required), publish, cover_media_id, +2 more.

create_tweetB

Post tweets with text, images, and videos via API

Inputs: text (required), media, media_ids, media_urls, +5 more.

delete_articleB
Destructive

Permanently delete a Twitter/X article entity (draft or published)

Inputs: article_id (required).

delete_tweetA
Destructive

Permanently delete a tweet owned by the auth_token's account

Inputs: tweet_id (required).

favorite_tweetB

Like (favorite) a tweet programmatically via API

Inputs: tweet_id (required).

follow_userC

Follow a user on X programmatically via API

Inputs: user_id, username.

get_account_infoA
Read-only

Get your GetXAPI account details, credit balance, and usage summary via API

Inputs: no named parameters.

get_articleB
Read-only

Fetch full Twitter/X article and note content

Inputs: id, article_id.

get_direct_message_conversationA
Read-only

Fetch the full message history of one Twitter DM conversation, newest first with cursor pagination

Inputs: conversation_id (required), count, cursor.

get_followers_you_knowC
Read-only

Get mutual followers between two Twitter accounts via API

Inputs: cursor, user_id, user_name.

get_home_timelineA
Read-only

Fetch your Twitter home timeline feed via API. Default is the 'For You' feed (algorithmic, includes recommended posts from accounts you don't follow); set following=true for the 'Following' feed (reverse-chronological, only accounts you follow).

Inputs: cursor, following.

get_list_membersB
Read-only

Get all members of a public Twitter/X list via API

Inputs: listId (required), cursor.

get_payment_historyB
Read-only

Get your GetXAPI payment and top-up history via API

Inputs: no named parameters.

get_tweet_detailA
Read-only

Get a single tweet with full author, media, and engagement data via API

Inputs: id (required).

get_tweet_repliesB
Read-only

Fetch all replies to a tweet via API

Inputs: id (required), cursor.

get_tweet_retweetersA
Read-only

Fetch the list of users who reposted (retweeted) a given tweet

Inputs: id (required), cursor.

get_tweet_threadA
Read-only

Resolve a linear self-thread from any tweet in the thread

Inputs: id (required).

get_user_aboutB
Read-only

Get Twitter account metadata including creation location and username history via API

Inputs: userName (required).

get_user_affiliatesB
Read-only

Get affiliated accounts of a verified Twitter/X organization via API

Inputs: userName (required), cursor.

get_user_followersA
Read-only

Get a Twitter user's followers list with profile details via API

Inputs: userName (required), cursor.

get_user_followers_v2A
Read-only

Get a Twitter user's followers list with ~70 results per page and canDm field

Inputs: userName (required), cursor.

get_user_followingB
Read-only

Get accounts a Twitter user is following via API

Inputs: userName (required), cursor.

get_user_following_v2A
Read-only

Get accounts a Twitter user is following with ~70 results per page and canDm field

Inputs: userName (required), cursor.

get_user_infoA
Read-only

Get Twitter user profiles, followers, verified status via API

Inputs: userName (required).

get_user_info_by_idA
Read-only

Look up Twitter user profiles by numeric ID via API

Inputs: userId (required).

get_user_likesC
Read-only

Fetch a Twitter user's liked tweets via API

Inputs: cursor.

get_user_mediaA
Read-only

Fetch tweets containing images and videos from a Twitter user via API

Inputs: userName (required), cursor.

get_user_mentionsA
Read-only

Fetch recent tweets that mention a Twitter user via API

Inputs: userName (required), cursor.

get_user_tweetsB
Read-only

Fetch all tweets posted by a Twitter user via API

Inputs: cursor, userId, userName.

get_user_tweets_and_repliesC
Read-only

Fetch tweets and replies posted by a Twitter user via API

Inputs: userName (required), cursor.

get_user_tweets_completeA
Read-only

Fetch tweets and replies posted by a Twitter user with self-thread expansion

Inputs: userName (required), cursor.

get_verified_followersA
Read-only

Get a user's verified (blue check) followers via API

Inputs: userName (required), cursor.

join_communityB

Join an X (Twitter) community by its numeric community ID

Inputs: community_id (required).

list_articlesA
Read-only

Paginated list of the auth_token user's own Twitter/X articles (drafts or published)

Inputs: count, cursor, lifecycle.

list_bookmarksC
Read-only

List all of a user's Twitter bookmarks via API

Inputs: cursor.

list_direct_messagesB
Read-only

Fetch Twitter direct messages via API

Inputs: tab, count, cursor.

publish_articleB

Publish an existing draft Twitter/X article to the timeline

Inputs: article_id (required).

retweet_tweetC

Retweet a tweet programmatically via API

Inputs: tweet_id (required).

search_bookmarksC
Read-only

Search inside a user's Twitter bookmarks via API

Inputs: q (required), cursor.

search_usersB
Read-only

Search for Twitter/X users by keyword, username, or topic

Inputs: q (required), cursor.

send_direct_messageB

Send Twitter direct messages programmatically via API

Inputs: text (required), recipient_id, recipient_username.

unbookmark_tweetA

Remove a tweet from your bookmarks programmatically via API

Inputs: tweet_id (required).

unfollow_userB

Unfollow a user on X programmatically via API

Inputs: user_id, username.

unpublish_articleB
Destructive

Move a published Twitter/X article back to draft and remove the wrapper tweet

Inputs: article_id (required).

update_articleA

Partial-update an existing Twitter/X article — title, body markdown, or cover image

Inputs: article_id (required), title, content, cover_media_id, +2 more.

update_avatarB

Update a Twitter user's profile picture programmatically via API

Inputs: image_url, image_base64.

update_bannerB

Update a Twitter user's profile banner programmatically via API

Inputs: image_url, image_base64.

update_profileB

Update Twitter profile fields (name, bio, location, URL, color, birthdate) programmatically via API

Inputs: url, name, location, description, +5 more.

upload_mediaC

Uploads media to Twitter via the 3-step INIT/APPEND/FINALIZE flow

Inputs: media_url, media_data, media_type.

x_loginA

Log into an X account with username/password (and email or TOTP if challenged) to enable write/private tools for this session. SECURITY: your X password is passed as tool arguments, so it transits the AI model's context and your model provider. For sensitive accounts, instead set X_AUTH_TOKEN in your MCP config and skip this tool.

Inputs: password (required), username (required), email, totp_secret.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 53 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, but there are overlapping pairs like get_user_followers/get_user_followers_v2 and multiple get_user_info variants that could cause confusion. Descriptions help differentiate, but the duplication reduces clarity.

    Naming Consistency4/5

    The majority of tools follow a consistent verb_noun naming pattern in snake_case. However, 'x_login' breaks the pattern and v2 suffixes (get_user_followers_v2) are slightly inconsistent with the base tools.

    Tool Count2/5

    53 tools is excessive for a single server, especially when many functionality clusters (e.g., followers have multiple variants) could be consolidated. This heavy surface makes selection harder for agents.

    Completeness4/5

    The tool set covers a broad spectrum of Twitter operations: tweets, users, followers, DMs, articles, bookmarks, communities, and profile management. Minor gaps exist (e.g., no list creation or DM deletion), but overall it's comprehensive.

    Maintenance

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that enables AI models and applications to interact directly with Twitter/X, providing capabilities to create posts, reply to tweets, retrieve user data, and manage account actions.
      11
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      An MCP server that provides AI agents with full access to the X (Twitter) API for posting, searching, and managing engagement through natural language. It supports comprehensive tools for tweet management, media uploads, and account analytics across multiple MCP-compatible clients.
      15
      63
      MIT