twit-mcp

An MCP server that gives AI agents real-time access to X/Twitter data through twit.sh — powered by x402 micropayments. No API keys, no sign-up. Agents pay per request in USDC on Base.

Tools

Articles

Tweets

Users

Lists

Communities

Twitter Auth

Requirements

• Node.js 20+
• A wallet with a small amount of USDC on Base Mainnet
• The wallet's private key (used locally to sign payments — never sent anywhere)

Use a dedicated wallet with minimal funds. Do not use your main wallet.

Setup

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "twit": {
      "command": "npx",
      "args": ["-y", "twit-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0xYourPrivateKeyHere"
      }
    }
  }
}

Claude Code

claude mcp add twit -e WALLET_PRIVATE_KEY=0xYourPrivateKeyHere -- npx -y twit-mcp

OpenClaw

Add to your OpenClaw MCP config file (~/.openclaw/mcp.json):

{
  "mcpServers": {
    "twit": {
      "command": "npx",
      "args": ["-y", "twit-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0xYourPrivateKeyHere"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

{
  "mcpServers": {
    "twit": {
      "command": "npx",
      "args": ["-y", "twit-mcp"],
      "env": {
        "WALLET_PRIVATE_KEY": "0xYourPrivateKeyHere"
      }
    }
  }
}

Posting Tweets

To post or delete tweets, you need to connect your Twitter/X account first:

1. Ask your agent: "connect my Twitter" or "connect my X"
2. A Chrome window will open at x.com — log in if prompted
3. The agent confirms connection and saves credentials locally
4. Ask the agent to post or delete tweets — no restart needed

Credentials are stored in ~/.twit-mcp-credentials.json (macOS/Linux) or C:\Users\<you>\.twit-mcp-credentials.json (Windows).

How It Works

1. Your agent calls a tool (e.g. get_user_tweets)
2. The MCP server requests the data from x402.twit.sh
3. The API responds with 402 Payment Required and a USDC amount
4. The MCP server signs the payment locally using your private key
5. The API verifies the payment on Base and returns the data
6. Your agent gets the result — all in one round-trip

Your private key never leaves your machine. It is only used locally to sign EIP-712 typed data for x402 payments.

Environment Variables

Links

• twit.sh — API reference and pricing
• x402.org — x402 protocol documentation
• Base — L2 network used for payments