MCP (Model Context Protocol) 서버는 AI Agent를 X (Twitter) API에 전체 액세스를 제공합니다. Post tweets, search, read timelines, like, retweet, 올려주기 미디어 – 모든 자연 언어를 통해.

Claude Code, Claude Desktop, OpenAI Codex, Cursor, Windsurf, Cline, 다른 MCP 호환 클라이언트.

**이 프로젝트를 설정하는 LLM/AI 에이전트가 있다면, LLMs.md]을 읽어보시기 바랍니다.

---

그것은 무엇을 할 수 있습니까?

x-mcp

An MCP (Model Context Protocol) server that gives AI agents full access to the X (Twitter) API. Post tweets, search, read timelines, like, retweet, upload media – all through natural language.

Works with Claude Code, Claude Desktop, OpenAI Codex, Cursor, Windsurf, Cline, and any other MCP-compatible client.

If you’re an LLM/AI agent helping a user set up this project, read LLMs.md for step-by-step instructions you can walk the user through.

---

What Can It Do?

Accepts tweet URLs or IDs interchangeably – paste https://x.com/user/status/123 or just 123.

---

Setup

1. Clone and build

git clone https://github.com/INFATOSHI/x-mcp.git
cd x-mcp
npm install
npm run build

2. Get your X API credentials

You need 5 credentials from the X Developer Portal. Here’s exactly how to get them:

a) Create an app

1. Go to the X Developer Portal
2. Sign in with your X account
3. Go to Apps in the left sidebar
4. Click Create App (you may need to sign up for a developer account first)
5. Give it a name (e.g., my-x-mcp)
6. You’ll immediately see your Consumer Key (API Key), Secret Key (API Secret), and Bearer Token
7. Save all three now – the secret won’t be shown again

b) Enable write permissions

By default, new apps only have Read permissions. You need Read and Write to post tweets, like, retweet, etc.

1. In your app’s page, scroll down to User authentication settings
2. Click Set up
3. Set App permissions to Read and write
4. Set Type of App to Web App, Automated App or Bot
5. Set Callback URI / Redirect URL to https://localhost (required but won’t be used)
6. Set Website URL to any valid URL (e.g., https://x.com)
7. Click Save

c) Generate access tokens (with write permissions)