Skip to content

Conversation

@mirzaaghazadeh
Copy link

@mirzaaghazadeh mirzaaghazadeh commented Jan 26, 2026

Description

Add Model Context Protocol (MCP) server support to Bird CLI, enabling AI assistants like Cursor and Claude Desktop to interact with Twitter/X.

Screenshot (Demo of its usage)

image

Changes

  • Add --mcp flag to CLI to start MCP server mode
  • Create MCP server with 27 tools covering:
    • Reading: tweets, threads, replies, search, timelines, bookmarks, likes, trending, news
    • Users: profile info, followers, following, whoami
    • Lists: owned lists, memberships, list timelines
    • Write operations: post, reply, like, bookmark, retweet, follow
  • Add MCP section to CLI help output

Usage

# Start MCP server
bird --mcp

Cursor/Claude (or any AI Agent can use mcp on that) Desktop Configuration

{
  "mcpServers": {
    "bird": {
      "command": "bird",
      "args": ["--mcp"]
    }
  }
}

The MCP server automatically uses browser cookies (same as CLI) - no extra configuration needed.

- Introduced a new MCP server in `src/mcp/index.ts` to expose Twitter functionality via the Model Context Protocol.
- Updated `package.json` to include new CLI commands for starting the MCP server.
- Enhanced `README.md` with instructions on using the MCP server and configuration details.
- Added tool definitions and handlers for various Twitter operations in `src/mcp/tools.ts`.
- Updated CLI to handle MCP mode and integrate with the new server functionality.
@mirzaaghazadeh
Copy link
Author

@steipete

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant