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

This server cannot be installed

F
license - not found
-
quality - not tested
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.

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