X Mcp Ctrls
About
mcp for controlling your x account through llm agents(claude desktop/cursor) expalnation vid: https://youtu.be/pAEEIVdsky8
Details
- License
- MIT
Explore
- Control your X account through LLM agents.
- Works with Claude Desktop and Cursor.
- Optional image generation via Gemini API.
- Simple Node.js setup and build.
- Uses official X API credentials for authentication.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
X Mcp CtrlsCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Setting up your the MCP is simple and requires just three steps:
1. Clone this repo.
2. install and Build the project
npm install
npm run build
3. Update Your Configuration
Paste the following JSON configuration into your Claude or Cursor setup:
{
"mcpServers": {
"x-mcp-ctrls": {
"command": "node",
"args": [
"PATH_TO_DOWNLOADED_FOLDER\\build\\index.js"
],
"env":{
"X_API_KEY": "YOUR_API_KEY",
"X_API_SECRET_KEY": "YOUR_API_KEY",
"X_BEARER_TOKEN": "YOUR_API_KEY",
"X_ACCESS_TOKEN": "YOUR_API_KEY2",
"X_ACCESS_TOKEN_SECRET": "YOUR_API_KEY",
"GEMINI_API_KEY": "YOUR_API_KEY" // ONLY IF YOU WANT IMG GENERATION
}
}
}
}
<br>
**Restart you app and now your mcp is configured just tell Ai agent to do something and See the Magic!!
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"x mcp ctrls": {
"x-mcp-ctrls": {
"command": "node",
"args": [
"PATH_TO_DOWNLOADED_FOLDER\\build\\index.js"
],
"env": {
"X_API_KEY": "YOUR_API_KEY",
"X_API_SECRET_KEY": "YOUR_API_KEY",
"X_BEARER_TOKEN": "YOUR_API_KEY",
"X_ACCESS_TOKEN": "YOUR_API_KEY2",
"X_ACCESS_TOKEN_SECRET": "YOUR_API_KEY",
"GEMINI_API_KEY": "YOUR_API_KEY"
}
}
}
}
}McpServers
{
"x-mcp-ctrls": {
"command": "node",
"args": [
"PATH_TO_DOWNLOADED_FOLDER\\build\\index.js"
],
"env": {
"X_API_KEY": "YOUR_API_KEY",
"X_API_SECRET_KEY": "YOUR_API_KEY",
"X_BEARER_TOKEN": "YOUR_API_KEY",
"X_ACCESS_TOKEN": "YOUR_API_KEY2",
"X_ACCESS_TOKEN_SECRET": "YOUR_API_KEY",
"GEMINI_API_KEY": "YOUR_API_KEY"
}
}
}
X-MCR-CTRLS
CONTROL YOUR X THROUGH LLM AGENTS.
Overview
X-MCP-Ctrl allows control of your and X-Acc through LLM agents using in apps like Claude-desktop/cursor.
Setup-Guide
Setting up your the MCP is simple and requires just three steps:
1. Clone this repo.
2. install and Build the project
npm install
npm run build
3. Update Your Configuration
Paste the following JSON configuration into your Claude or Cursor setup:
{
"mcpServers": {
"x-mcp-ctrls": {
"command": "node",
"args": [
"PATH_TO_DOWNLOADED_FOLDER\\build\\index.js"
],
"env":{
"X_API_KEY": "YOUR_API_KEY",
"X_API_SECRET_KEY": "YOUR_API_KEY",
"X_BEARER_TOKEN": "YOUR_API_KEY",
"X_ACCESS_TOKEN": "YOUR_API_KEY2",
"X_ACCESS_TOKEN_SECRET": "YOUR_API_KEY",
"GEMINI_API_KEY": "YOUR_API_KEY" // ONLY IF YOU WANT IMG GENERATION
}
}
}
}
<br>
**Restart you app and now your mcp is configured just tell Ai agent to do something and See the Magic!!
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
