Skip to main content
Glama
khajaphysist

x-mcp

by khajaphysist
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

x-mcp

An MCP server and CLI for interacting with X/Twitter, built with @xdevplatform/xdk.

Tools

Tool

Description

post_tweet

Post a tweet

search_tweets

Search recent tweets (last 7 days)

get_user_info

Get user profile info by username(s)

get_timeline

Get your home timeline

like_tweet

Like a tweet by ID

retweet

Retweet a tweet by ID

delete_tweet

Delete a tweet by ID

Related MCP server: TwitterAPI MCP Server

Setup

Prerequisites

You need X/Twitter API credentials (OAuth 1.0a). Get them from the X Developer Portal:

  • API Key (Consumer Key)

  • API Secret (Consumer Secret)

  • Access Token

  • Access Token Secret

Authenticate

Either log in interactively (credentials are saved to ~/.x-mcp/credentials.json):

npx @kms_dev/x-mcp login

Or set environment variables:

export X_API_KEY=your_api_key
export X_API_SECRET=your_api_secret
export X_ACCESS_TOKEN=your_access_token
export X_ACCESS_TOKEN_SECRET=your_access_token_secret

Environment variables take precedence over stored credentials.

Usage

MCP Server

Add to your MCP client config (e.g. Claude Desktop ~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "x-mcp": {
      "command": "npx",
      "args": ["-y", "@kms_dev/x-mcp"],
      "env": {
        "X_API_KEY": "your_api_key",
        "X_API_SECRET": "your_api_secret",
        "X_ACCESS_TOKEN": "your_access_token",
        "X_ACCESS_TOKEN_SECRET": "your_access_token_secret"
      }
    }
  }
}

If you've already run npx @kms_dev/x-mcp login, you can omit the env block:

{
  "mcpServers": {
    "x-mcp": {
      "command": "npx",
      "args": ["-y", "@kms_dev/x-mcp"]
    }
  }
}

CLI

npx @kms_dev/x-mcp login
npx @kms_dev/x-mcp post-tweet "Hello world!"
npx @kms_dev/x-mcp search-tweets "typescript" --max-results 5
npx @kms_dev/x-mcp get-user-info XDevelopers
npx @kms_dev/x-mcp get-timeline --max-results 10
npx @kms_dev/x-mcp like-tweet 1234567890
npx @kms_dev/x-mcp retweet 1234567890
npx @kms_dev/x-mcp delete-tweet 1234567890

Development

git clone https://github.com/khajaphysist/x-mcp.git
cd x-mcp
npm install

# Run tests
npm test

# Run CLI
npx tsx src/cli.ts search-tweets "test"

# Run MCP server
npx tsx src/mcp-server.ts

# Test MCP server with inspector
npx @modelcontextprotocol/inspector npx tsx src/mcp-server.ts
Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd
F
license - not found
A
quality
D
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Related MCP Servers

  • Twitter Api45 MCP Server

    BACH-AI-Tools
    A
    license
    C
    quality
    D
    maintenance
    An MCP server for accessing the Twitter/X Api45 API, allowing users to retrieve user profiles, timelines, followers, and media. It supports searching communities, jobs, and trends, while also providing tools to monitor live broadcasts and Twitter Spaces.
    28
    MIT

  • TwitterAPI MCP Server

    Jing-yilin
    A
    license
    B
    quality
    D
    maintenance
    An MCP server that provides access to Twitter data and write actions through TwitterAPI.io, bypassing the need for a standard Twitter developer account. It enables users to search tweets, retrieve profiles, and post content with support for pagination and enterprise proxy configurations.
    11
    MIT

  • X(Twitter) V2 MCP Server

    NexusX-MCP
    A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server for interacting with the Twitter/X API v2, enabling AI assistants to retrieve tweets, post content, reply, quote, and more programmatically.
    2,013
    13
    MIT

  • twikit-mcp

    tangivis
    A
    license
    B
    quality
    A
    maintenance
    An MCP server for interacting with Twitter/X using browser cookies without an API key, enabling tweet management, user actions, and search via natural language.
    62
    10
    MIT

View all related MCP servers

Related MCP Connectors

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/khajaphysist/x-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server