Polsia-Inc/twitter-read-mcp ? reverse-engineered prompt

Build me an MCP server that lets AI tools read Twitter or X engagement data.

I want to be able to ask for a tweet’s likes, retweets, replies, quotes, bookmarks, and impressions, plus get recent mentions, see replies to a tweet, and search tweets with engagement metrics included. It should work as a simple local server over stdio for MCP clients like Claude Desktop, and it should use Twitter API v2 credentials from environment variables. Please include basic rate limiting so it respects the Twitter API window and returns how many requests are left after each call.

Make it easy to run from source with a clear setup and build flow, and add a few example commands so I can test it quickly. If you need to check current Twitter API or MCP docs while wiring it up, go ahead and look them up online.