README.md•3.58 kB
[](https://smithery.ai/server/@xonack/apex-mcp)
# MCP Server for X (Twitter) Management
### Powered by Apex
Manage your X (Twitter) fully with a single API Key. Built using [Apex](https://apexagents.ai) social media infrastructure.
Supported platforms:
- X
## Functions:
### Tweet Management
- get tweet - Get detailed information about a specific tweet
- search tweets - Search tweets with advanced filtering (including replies)
- generate reply - Generate AI-powered reply suggestions for text/images
- post tweet - Post new tweets with optional images
- post reply - Post replies to existing tweets
### List Management
- create list - Create new X/Twitter lists
- get user lists - Retrieve all lists owned by the authenticated user
- get list - Get detailed information about a specific list
- get list members - Get members of a list with pagination support
- add list member - Add users to X/Twitter lists
- update list - Update existing list properties
- delete list - Delete X/Twitter lists
### User Management
- get user details - Get comprehensive user profile information by username or Twitter ID (includes TWID, follower counts, verification status, profile details)
- follow user - Follow a user on Twitter/X by their numerical Twitter ID (TWID)
- unfollow user - Unfollow a user on Twitter/X by their numerical Twitter ID (TWID)
- get user followers - Get a paginated list of a user's followers by numerical Twitter ID (TWID)
- get user following - Get a paginated list of users that a user is following by numerical Twitter ID (TWID)
## Example Usage
### Search Tweets
The search tool uses structured parameters (no `query` parameter). Here's an example request:
```json
{
"count": 20,
"minLikes": 100,
"includeWords": [
"bitcoin",
"treasury"
],
"startDate": "2025-06-16",
"onlyOriginal": true
}
```
This searches for original tweets (not retweets) containing "bitcoin" and "treasury" with at least 100 likes since June 16, 2025.
## Apex Set Up
1. Create an account at [Apex](https://apexagents.ai).
2. Request an [API Key](https://t.me/xonack).
3. Review [Apex API Docs](https://api.apexagents.ai)
## Quick Start with Smithery (Recommended)
Install with Smithery [here](https://smithery.ai/server/@xonack/apex-mcp).
## Building MCPB Bundles
Create installable MCPB bundles for Claude Desktop:
### Prerequisites
```bash
# Install MCPB CLI globally
npm install -g @anthropic-ai/mcpb
```
### Build Process
```bash
# Clone and setup
git clone https://github.com/xonack/apex-mcp.git
cd apex-mcp
npm install
# Build the bundle
npm run mcpb:build
```
This creates `apex-mcp.mcpb` file that can be installed directly in Claude Desktop.
### Installation
1. Open Claude Desktop
2. Go to Settings → Extensions
3. Click "Install Extension"
4. Select the `apex-mcp.mcpb` file
5. Configure your Apex API key and URL
## Manual Set Up
Clone Repo.
Run commands:
```bash
# Install dependencies
npm install
# Build the project
npm run build
```
## Using with Claude Desktop
### Local Development
Add this configuration to your Claude Desktop config file:
**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"apex-mcp-server": {
"command": "node",
"args":["/absolute/path/to/apex-mcp-stdio/dist/index.js", "<APEX API KEY>", "api.apexagents.ai"]
}
}
}
```
Open [Claude Desktop](https://claude.ai/download) to verify connection.