twit-mcp

通过 x402 小额支付实时 X/Twitter 数据和写入操作。获取文章、推文、用户、列表和社区 - 发布推文、点赞、转发、添加书签、关注 - 按 USDC on Base 请求付费。无需 API 密钥。

# twit-mcp

You have access to real-time X/Twitter data and write actions through this MCP server. Each tool call costs $0.0025–$0.01 USDC, paid automatically from the configured wallet on Base. No API key is required.

## Available Tools

### Articles

| Tool | Description | Price |
|------|-------------|-------|
| `get_article_by_id` | Get the full content of an X Article as Markdown by tweet ID. Not in official X API. | $0.01 USDC |

### Tweets

| Tool | Description | Price |
|------|-------------|-------|
| `get_tweet_by_id` | Get a tweet by its ID | $0.0025 USDC |
| `get_user_tweets` | Get a user's recent tweets (paginated) | $0.01 USDC |
| `get_tweet_replies` | Get replies to a tweet (paginated) | $0.01 USDC |
| `get_tweet_quote_tweets` | Get quote tweets for a tweet (paginated) | $0.01 USDC |
| `get_tweet_retweeted_by` | Get users who reposted a tweet (paginated) | $0.01 USDC |
| `search_tweets` | Full-archive tweet search with filters | $0.01 USDC |
| `get_tweets` | Bulk lookup up to 50 tweets by ID | $0.01 USDC |
| `post_tweet` | Post a new tweet as the authenticated user | $0.0025 USDC |
| `delete_tweet` | Delete a tweet owned by the authenticated user | $0.0025 USDC |
| `like_tweet` | Like a tweet as the authenticated user | $0.0075 USDC |
| `unlike_tweet` | Unlike a tweet as the authenticated user | $0.005 USDC |
| `bookmark_tweet` | Bookmark a tweet | $0.0025 USDC |
| `unbookmark_tweet` | Remove a tweet from bookmarks | $0.0025 USDC |
| `retweet` | Repost a tweet as the authenticated user | $0.0075 USDC |
| `unretweet` | Undo a repost | $0.005 USDC |

### Users

| Tool | Description | Price |
|------|-------------|-------|
| `get_user_by_username` | Get a user profile by username | $0.005 USDC |
| `get_user_by_id` | Get a user profile by numeric ID | $0.005 USDC |
| `search_users` | Search users by keyword (paginated) | $0.01 USDC |
| `get_user_followers` | Get a user's followers (paginated) | $0.01 USDC |
| `get_user_following` | Get accounts a user follows (paginated) | $0.01 USDC |
| `get_users` | Bulk lookup up to 50 users by ID | $0.01 USDC |
| `follow_user` | Follow a user as the authenticated user | $0.0075 USDC |
| `unfollow_user` | Unfollow a user as the authenticated user | $0.005 USDC |

### Lists

| Tool | Description | Price |
|------|-------------|-------|
| `get_list_by_id` | Get list details by numeric ID | $0.0025 USDC |
| `get_list_members` | Get members of a list (paginated) | $0.01 USDC |
| `get_list_followers` | Get followers of a list (paginated) | $0.01 USDC |
| `get_list_tweets` | Get latest tweets from a list (paginated) | $0.01 USDC |

### Communities

| Tool | Description | Price |
|------|-------------|-------|
| `get_community_by_id` | Get community details by ID. Not in official X API. | $0.0025 USDC |
| `get_community_posts` | Get latest posts from a community (paginated). Not in official X API. | $0.01 USDC |
| `get_community_members` | Get community members with roles (paginated). Not in official X API. | $0.01 USDC |

### Twitter Auth

Write actions (post, delete, like, bookmark, retweet, follow) require a connected Twitter/X account. Before attempting any write action, call `twitter_account_status` to check if an account is connected.

| Tool | Description |
|------|-------------|
| `connect_twitter` | Connect a Twitter/X account (opens a browser window) |
| `twitter_account_status` | Check if a Twitter account is currently connected |
| `disconnect_twitter` | Disconnect and clear stored credentials |

**Connecting an account:**

1. Call `connect_twitter` — a Chrome window will open at x.com
2. The user logs in if prompted
3. Once confirmed, credentials are saved locally to `~/.twit-mcp-credentials.json`
4. Write actions are available immediately — no restart needed

If a write action is requested and no account is connected, call `connect_twitter` first and wait for confirmation before proceeding.

## How Payments Work

Each tool call makes an HTTP request to `x402.twit.sh`. The server responds with `402 Payment Required`. The MCP server signs a USDC payment locally using the configured `WALLET_PRIVATE_KEY` and retries — all automatically, in one round-trip. The private key never leaves the machine.

## Links

- [twit.sh](https://twit.sh) — API reference and pricing
- [npm: twit-mcp](https://www.npmjs.com/package/twit-mcp)
- [x402.org](https://x402.org) — payment protocol docs

---

## 中文说明

# twit-mcp

你可以通过此 MCP 服务器访问实时 X/Twitter 数据和写入操作。每次工具调用花费 $0.0025–$0.01 USDC，从 Base 上配置的钱包自动支付。无需 API 密钥。

## 可用工具

### 文章

| 工具 | 描述 | 价格 |
|------|-------------|-------|
| `get_article_by_id` | 按推文 ID 以 Markdown 格式获取 X 文章的完整内容。不在官方 X API 中。 | $0.01 USDC |

### 推文

| 工具 | 描述 | 价格 |
|------|-------------|-------|
| `get_tweet_by_id` | 按 ID 获取推文 | $0.0025 USDC |
| `get_user_tweets` | 获取用户的最近推文（分页） | $0.01 USDC |
| `get_tweet_replies` | 获取对某条推文的回复（分页） | $0.01 USDC |
| `get_tweet_quote_tweets` | 获取某条推文的引用推文（分页） | $0.01 USDC |
| `get_tweet_retweeted_by` | 获取转发某条推文的用户（分页） | $0.01 USDC |
| `search_tweets` | 带过滤器的全档案推文搜索 | $0.01 USDC |
| `get_tweets` | 按 ID 批量查找最多 50 条推文 | $0.01 USDC |
| `post_tweet` | 以已认证用户身份发布新推文 | $0.0025 USDC |
| `delete_tweet` | 删除已认证用户拥有的推文 | $0.0025 USDC |
| `like_tweet` | 以已认证用户身份点赞推文 | $0.0075 USDC |
| `unlike_tweet` | 以已认证用户身份取消点赞推文 | $0.005 USDC |
| `bookmark_tweet` | 收藏推文 | $0.0025 USDC |
| `unbookmark_tweet` | 从收藏中移除推文 | $0.0025 USDC |
| `retweet` | 以已认证用户身份转发推文 | $0.0075 USDC |
| `unretweet` | 撤销转发 | $0.005 USDC |

### 用户

| 工具 | 描述 | 价格 |
|------|-------------|-------|
| `get_user_by_username` | 按用户名获取用户资料 | $0.005 USDC |
| `get_user_by_id` | 按数字 ID 获取用户资料 | $0.005 USDC |
| `search_users` | 按关键词搜索用户（分页） | $0.01 USDC |
| `get_user_followers` | 获取用户的关注者（分页） | $0.01 USDC |
| `get_user_following` | 获取用户关注的账户（分页） | $0.01 USDC |
| `get_users` | 按 ID 批量查找最多 50 个用户 | $0.01 USDC |
| `follow_user` | 以已认证用户身份关注某用户 | $0.0075 USDC |
| `unfollow_user` | 以已认证用户身份取消关注某用户 | $0.005 USDC |

### 列表

| 工具 | 描述 | 价格 |
|------|-------------|-------|
| `get_list_by_id` | 按数字 ID 获取列表详情 | $0.0025 USDC |
| `get_list_members` | 获取列表的成员（分页） | $0.01 USDC |
| `get_list_followers` | 获取列表的关注者（分页） | $0.01 USDC |
| `get_list_tweets` | 获取列表中的最新推文（分页） | $0.01 USDC |

### 社区

| 工具 | 描述 | 价格 |
|------|-------------|-------|
| `get_community_by_id` | 按 ID 获取社区详情。不在官方 X API 中。 | $0.0025 USDC |
| `get_community_posts` | 获取社区的最新帖子（分页）。不在官方 X API 中。 | $0.01 USDC |
| `get_community_members` | 获取带角色的社区成员（分页）。不在官方 X API 中。 | $0.01 USDC |

### Twitter 认证

写入操作（发布、删除、点赞、收藏、转发、关注）需要连接的 Twitter/X 账户。在尝试任何写入操作之前，调用 `twitter_account_status` 检查是否已连接账户。

| 工具 | 描述 |
|------|-------------|
| `connect_twitter` | 连接 Twitter/X 账户（打开浏览器窗口） |
| `twitter_account_status` | 检查当前是否已连接 Twitter 账户 |
| `disconnect_twitter` | 断开连接并清除存储的凭据 |

**连接账户：**

1. 调用 `connect_twitter` — 将在 x.com 打开一个 Chrome 窗口
2. 如果提示，用户登录
3. 确认后，凭据本地保存到 `~/.twit-mcp-credentials.json`
4. 写入操作立即可用 — 无需重启

如果请求了写入操作但未连接账户，先调用 `connect_twitter` 并等待确认后再继续。

## 支付如何运作

每次工具调用都会向 `x402.twit.sh` 发出 HTTP 请求。服务器以 `402 Payment Required` 响应。MCP 服务器使用配置的 `WALLET_PRIVATE_KEY` 在本地签署 USDC 付款并重试 — 全部自动完成，一次往返。私钥永不离开本机。

## 链接

- [twit.sh](https://twit.sh) — API 参考和定价
- [npm: twit-mcp](https://www.npmjs.com/package/twit-mcp)
- [x402.org](https://x402.org) — 支付协议文档