twit-mcp
Real-time X/Twitter data and write actions via x402 micropayments. Fetch articles, tweets, users, lists, and communities — post tweets, like, retweet, bookma...
Rank
62
Safety
84
Downloads
1.2k
Updated
Oct 10, 2026
Version
1.4.1
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.2K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.2K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.4.1release · observed Mar 10, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s170tfnb56mzvs730pcch2c3zs885rx2:twit-mcp- Install using `clawhub skill install s170tfnb56mzvs730pcch2c3zs885rx2:twit-mcp` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/etherlect/twit-mcp before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-etherlect-twit-mcp/snapshot"
Documentation
CLAWHUB
23,547 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: twit-mcp
description: Real-time X/Twitter data and write actions via x402 micropayments. Fetch articles, tweets, users, lists, and communities — post tweets, like, retweet, bookmark, follow — pay per request in USDC on Base. No API keys required.
version: 1.4.1
homepage: https://twit.sh
metadata:
openclaw:
requires:
env: [WALLET_PRIVATE_KEY]
bins: [npx]
primaryEnv: WALLET_PRIVATE_KEY
emoji: 🐦
install:
- kind: node
package: twit-mcp
bins: [twit-mcp]
---
# 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_foREADME.md
# twit-mcp An MCP server that gives AI agents real-time access to X/Twitter data through [twit.sh](https://twit.sh) — powered by [x402](https://x402.org) micropayments. No API keys, no sign-up. Agents pay per request in USDC on Base. ## 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 officia
_meta.json
{
"ownerId": "kn7bae6bj71v7rt3sg3c58fb5181q0vf",
"slug": "twit-mcp",
"version": "1.4.1",
"publishedAt": 1773156234296
}skill-card.md
## Description: Real-time X/Twitter data and write actions via x402 micropayments. Fetch articles, tweets, users, lists, and communities; post tweets, like, retweet, bookmark, follow; pay per request in USDC on Base. No API keys required. This skill is ready for commercial/non-commercial use. ## Publisher: [etherlect](https://clawhub.ai/user/etherlect) ### License/Terms of Use: MIT-0 ## Use Case: External users and developers use this MCP server to let an agent retrieve current X/Twitter articles, posts, users, lists, and communities, and to perform authenticated X/Twitter write actions when an account is connected. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: The MCP server requires a funded wallet private key for x402 payments. Mitigation: Use a dedicated low-balance wallet and avoid reusing a primary wallet key. Risk: Connecting an X/Twitter account stores session cookies locally and enables account write actions. Mitigation: Use a low-risk account, confirm write actions before use, and clear or revoke the session after use. Risk: API_BASE can direct paid requests to a different remote service if overridden. Mitigation: Keep the default API endpoint unless an override has been reviewed and is intentional. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/etherlect/skills/twit-mcp) - [twit.sh API reference and pricing](https://twit.sh) - [npm package: twit-mcp](https://www.npmjs.com/package/twit-mcp) - [x402 protocol documentation](https://x402.org) ## Skill Output: **Output Type(s):** [text, markdown, API calls, shell commands, configuration] **Output Format:** [MCP tool responses containing JSON-formatted text and Markdown article content; setup guidance uses shell commands and configuration snippets.] **Output Parameters:** [1D] **Other Properties Related to Output:** [Some tool calls spend USDC from the configured Base wallet and write actions require a connected X/Twitter account.] ## Skill Version(s): 1.4.1 (source: server release metadata and skill frontmatter) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
package.json
{
"name": "twit-mcp",
"version": "1.4.0",
"description": "X/Twitter data MCP server powered by x402 micropayments. Pay per request in USDC on Base.",
"type": "module",
"main": "dist/index.js",
"bin": "dist/index.js",
"scripts": {
"dev": "tsx src/index.ts",
"build": "tsc",
"start": "node dist/index.js",
"prepublishOnly": "yarn build"
},
"keywords": [
"mcp",
"x402",
"twitter",
"x",
"ai-agents",
"usdc",
"base"
],
"repository": {
"type": "git",
"url": "git+https://github.com/etherlect/twit-mcp.git"
},
"license": "MIT",
"engines": {
"node": ">=20"
},
"dependencies": {
"@modelcontextprotocol/sdk": "^1.12.1",
"@x402/evm": "^2.3.1",
"@x402/fetch": "^2.3.0",
"dotenv": "^16.4.7",
"ethers": "^6.16.0",
"playwright": "^1.58.2",
"viem": "^2.45.3",
"zod": "^3.24.2"
},
"devDependencies": {
"@types/node": "^20",
"tsx": "^4.21.0",
"typescript": "^5.9.3"
},
"packageManager": "[email protected]+sha512.f45ab632439a67f8bc759bf32ead036a1f413287b9042726b7cc4818b7b49e14e9423ba49b18f9e06ea4941c1ad062385b1d8760a8d5091a1a31e5f6219afca8"
}AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/etherlect/skills/twit-mcp",
"sourceUrl": "https://clawhub.ai/etherlect/skills/twit-mcp",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T22:13:54.006Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-etherlect-twit-mcp/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-etherlect-twit-mcp/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T22:13:54.006Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.2K downloads",
"href": "https://clawhub.ai/etherlect/twit-mcp",
"sourceUrl": "https://clawhub.ai/etherlect/twit-mcp",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T22:13:54.006Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.4.1",
"href": "https://clawhub.ai/etherlect/twit-mcp",
"sourceUrl": "https://clawhub.ai/etherlect/twit-mcp",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-03-10T15:23:54.296Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-etherlect-twit-mcp/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-etherlect-twit-mcp/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.4.1",
"description": "added tools: get_article_by_id, like_tweet, unlike_tweet, bookmark_tweet, unbookmark_tweet, retweet, unretweet, follow_user, unfollow_user",
"href": "https://clawhub.ai/etherlect/twit-mcp",
"sourceUrl": "https://clawhub.ai/etherlect/twit-mcp",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-03-10T15:23:54.296Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
