{"_id":"@getxapi/mcp","_rev":"2-9b342af09ca888ced0ab81329dbd293f","name":"@getxapi/mcp","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@getxapi/mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","twitter","x","twitter-api","x-api","claude","cursor","getxapi"],"license":"MIT","_id":"@getxapi/mcp@0.1.0","maintainers":[{"name":"getxapi","email":"bozad@getxapi.com"}],"homepage":"https://getxapi.com","bugs":{"url":"https://github.com/getxapi/getxapi-mcp/issues"},"bin":{"getxapi-mcp":"dist/index.js"},"dist":{"shasum":"83a1fe817fde06f5f86ea536b7dba5da703f6d03","tarball":"https://registry.npmjs.org/@getxapi/mcp/-/mcp-0.1.0.tgz","fileCount":5,"integrity":"sha512-5fALOseKXZqJ9J1ySpjfYkfMVZjAReD1bRPU66y2KMIMxGOt1dXHt9Ff7qWSxePl6ge5Yhrzi2naOT9kM0EgRw==","signatures":[{"sig":"MEYCIQC8LrEIHDyO/jikxgdWGnwddddnyqN0otOKsUblJmsxiQIhAMekuJrPQA69KdnkPZyieG6DD78lamkdTFtNixpbLnqG","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":59477},"type":"module","scripts":{"build":"tsc","build:manifest":"node scripts/build-manifest.mjs","prepublishOnly":"npm run build"},"_npmUser":{"name":"getxapi","email":"bozad@getxapi.com"},"repository":{"url":"git+https://github.com/getxapi/getxapi-mcp.git","type":"git"},"_npmVersion":"11.6.2","description":"Official GetXAPI MCP server — use the Twitter/X API (search, users, tweets, posting, DMs, articles) inside Claude, Cursor, and any MCP client.","directories":{},"_nodeVersion":"25.2.1","dependencies":{"zod":"^3.23.0","@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^25.9.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1780200776505_0.5128337036864914","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@getxapi/mcp","version":"0.1.1","description":"Official GetXAPI MCP server — use the Twitter/X API (search, users, tweets, posting, DMs, articles) inside Claude, Cursor, and any MCP client.","type":"module","bin":{"getxapi-mcp":"dist/index.js"},"scripts":{"build:manifest":"node scripts/build-manifest.mjs","build":"tsc","prepublishOnly":"npm run build"},"keywords":["mcp","model-context-protocol","twitter","x","twitter-api","x-api","claude","cursor","getxapi"],"homepage":"https://www.getxapi.com","repository":{"type":"git","url":"git+https://github.com/getxapi/getxapi-mcp.git"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"^3.23.0"},"devDependencies":{"@types/node":"^25.9.1","typescript":"^5.5.0"},"_id":"@getxapi/mcp@0.1.1","bugs":{"url":"https://github.com/getxapi/getxapi-mcp/issues"},"_nodeVersion":"25.2.1","_npmVersion":"11.6.2","dist":{"integrity":"sha512-Mx1/VE6esEt8/hSIFIlBgMb5O1ir+CQmffj2A2w92h9f1Gf11o8f9k95CwnUs+4DyUWTo9PmDarZ2MdJvGMIwg==","shasum":"a720297467ea6d1a3f8d7f18aca713a94d33f260","tarball":"https://registry.npmjs.org/@getxapi/mcp/-/mcp-0.1.1.tgz","fileCount":5,"unpackedSize":59481,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIALkZYPFsOO5HOMmRBs8pY0KCUFbufijj3yIcD8CNUaoAiEA2pI3gmdU73pNInWqxnKBQBCpL89uQMUHeaP92QnV+dI="}]},"_npmUser":{"name":"getxapi","email":"bozad@getxapi.com"},"directories":{},"maintainers":[{"name":"getxapi","email":"bozad@getxapi.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.1_1780201438168_0.1620384156367518"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-31T04:12:56.386Z","modified":"2026-05-31T04:23:58.435Z","0.1.0":"2026-05-31T04:12:56.655Z","0.1.1":"2026-05-31T04:23:58.340Z"},"bugs":{"url":"https://github.com/getxapi/getxapi-mcp/issues"},"license":"MIT","homepage":"https://www.getxapi.com","keywords":["mcp","model-context-protocol","twitter","x","twitter-api","x-api","claude","cursor","getxapi"],"repository":{"type":"git","url":"git+https://github.com/getxapi/getxapi-mcp.git"},"description":"Official GetXAPI MCP server — use the Twitter/X API (search, users, tweets, posting, DMs, articles) inside Claude, Cursor, and any MCP client.","maintainers":[{"name":"getxapi","email":"bozad@getxapi.com"}],"readme":"# GetXAPI MCP — Twitter/X API for Claude, Cursor & any MCP client\n\n[![npm](https://img.shields.io/npm/v/@getxapi/mcp.svg)](https://www.npmjs.com/package/@getxapi/mcp)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)\n\nThe official **[GetXAPI](https://www.getxapi.com)** MCP server. Give your AI assistant\ndirect access to the Twitter/X API — **search tweets, look up users, read\nreplies and followers, and post tweets, send DMs, manage articles, and more** —\nthrough one [Model Context Protocol](https://modelcontextprotocol.io) server.\n\nUnlike read-only Twitter MCP servers, GetXAPI MCP can **act**: post tweets,\nreply, like, retweet, send DMs, and publish articles — not just read.\n\n→ **[Get a free API key at getxapi.com](https://www.getxapi.com)** · **[API docs](https://docs.getxapi.com)** · **[Pricing](https://www.getxapi.com/pricing)** ($0.001/call, $0.05 per 1,000 tweets)\n\n---\n\n## Install\n\nAdd it to your MCP client config (Claude Desktop, Cursor, Windsurf, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"getxapi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@getxapi/mcp@latest\"],\n      \"env\": {\n        \"GETXAPI_KEY\": \"get-x-api-...\"\n      }\n    }\n  }\n}\n```\n\nGet your `GETXAPI_KEY` from your [GetXAPI dashboard](https://www.getxapi.com). That's\nall the **read** tools need.\n\nOr via the Claude Code CLI:\n\n```bash\nclaude mcp add getxapi -- npx -y @getxapi/mcp@latest\n```\n\n---\n\n## What you can do\n\nOnce installed, just ask your assistant naturally:\n\n> \"Find Elon Musk's latest tweets\"\n> \"Search tweets about OpenAI from the last week\"\n> \"Who are @vercel's verified followers?\"\n> \"Get the replies to this tweet: 1799…\"\n> \"Post 'shipping 🚀' to my X account\"   *(requires X auth — see below)*\n\n---\n\n## Read vs. write tools\n\n| | Needs | Examples |\n|---|---|---|\n| **Read** | `GETXAPI_KEY` only | search tweets, user info, followers/following, replies, mentions, user tweets, lists |\n| **Write / private** | `GETXAPI_KEY` **+ X account auth** | post / reply / like / retweet / bookmark / delete tweet, send DM, read DMs/timeline/bookmarks, publish articles, update profile |\n\n### Enabling write tools\n\nWrite and private tools act on a real X account, so they need that account's\nauth. Two ways to provide it:\n\n**Option A — log in through the assistant** (convenient):\n\n> \"Log in to my X account\"\n\nThe assistant calls the `x_login` tool with your credentials and keeps the\nsession for write tools.\n⚠️ Your X password is passed as tool arguments, so it transits the AI model's\ncontext. For sensitive accounts, prefer Option B.\n\n**Option B — set credentials in config** (recommended for sensitive accounts):\n\n```json\n{\n  \"mcpServers\": {\n    \"getxapi\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@getxapi/mcp@latest\"],\n      \"env\": {\n        \"GETXAPI_KEY\": \"get-x-api-...\",\n        \"X_AUTH_TOKEN\": \"...\",\n        \"X_CT0\": \"...\",\n        \"X_TWID\": \"...\",\n        \"X_PROXY\": \"http://user:pass@host:port\"\n      }\n    }\n  }\n}\n```\n\n`X_CT0`, `X_TWID`, and `X_PROXY` are optional — `X_AUTH_TOKEN` alone is enough\nfor most write tools; the others improve reliability on some accounts.\n\nYour X password never touches the model. The credential fields are never shown\nto the AI — the server injects them only into the calls that need them.\n\n---\n\n## How billing works\n\nEvery tool call is a normal GetXAPI API call authenticated with your\n`GETXAPI_KEY`, metered exactly like direct API usage. No separate MCP billing.\nSee [pricing](https://www.getxapi.com/pricing).\n\n---\n\n## Links\n\n- 🌐 **Website:** [getxapi.com](https://www.getxapi.com)\n- 📚 **API docs:** [docs.getxapi.com](https://docs.getxapi.com)\n- 💳 **Pricing:** [getxapi.com/pricing](https://www.getxapi.com/pricing)\n- 🔑 **Get an API key:** [getxapi.com](https://www.getxapi.com)\n\nGetXAPI is an independent third-party API for developers and researchers. Not\naffiliated with, endorsed by, or sponsored by X Corp.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}