{"_id":"@daveremy/xai-mcp","_rev":"3-28de3a5716a3c5d6d60f19f43c18e371","name":"@daveremy/xai-mcp","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@daveremy/xai-mcp","version":"0.1.0","keywords":["xai","grok","mcp","model-context-protocol","twitter","x","search","cli"],"license":"MIT","_id":"@daveremy/xai-mcp@0.1.0","maintainers":[{"name":"daveremy","email":"email@daveremy.com"}],"homepage":"https://github.com/daveremy/xai-mcp#readme","bugs":{"url":"https://github.com/daveremy/xai-mcp/issues"},"bin":{"xai":"dist/cli.js","xai-mcp-server":"dist/mcp.js"},"dist":{"shasum":"15cc9062d3c4c05f282150cac2fd8de0545e0d4c","tarball":"https://registry.npmjs.org/@daveremy/xai-mcp/-/xai-mcp-0.1.0.tgz","fileCount":26,"integrity":"sha512-F7s313K2FmD7pm3K2w4UaDyz42micgD3Lh1mSaLmE3lkkdXY/COHsXVcZQIN4p2l5b0dVZRaey0XkRN4iBEbAg==","signatures":[{"sig":"MEUCIEsBvuHZTfE0G9OrN9/dt17ZAHGihewq10cWFfwsdsd2AiEAsHH0PoO9H8f0CwXVYYN+71ERfjLrn5lBi0eUUZNf/zo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23718},"type":"module","engines":{"node":">=20.6.0"},"gitHead":"fcd66b2b1dba9f3845759563e4b3e90af38ce07b","scripts":{"dev":"tsx src/cli.ts","test":"node --import tsx --test test/*.test.ts","build":"tsc && chmod +x dist/cli.js dist/mcp.js","prepack":"npm run build","release":"./scripts/release.sh"},"_npmUser":{"name":"daveremy","email":"email@daveremy.com"},"repository":{"url":"git+https://github.com/daveremy/xai-mcp.git","type":"git"},"_npmVersion":"11.12.0","description":"xAI (Grok) MCP server and CLI — search X/Twitter, resolve tweets, fetch threads, and web search","directories":{},"_nodeVersion":"25.8.1","dependencies":{"zod":"^4.3.6","commander":"^14.0.3","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^6.0.2","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/xai-mcp_0.1.0_1774322667567_0.32724189549132277","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@daveremy/xai-mcp","version":"0.1.1","keywords":["xai","grok","mcp","model-context-protocol","twitter","x","search","cli"],"license":"MIT","_id":"@daveremy/xai-mcp@0.1.1","maintainers":[{"name":"daveremy","email":"email@daveremy.com"}],"homepage":"https://github.com/daveremy/xai-mcp#readme","bugs":{"url":"https://github.com/daveremy/xai-mcp/issues"},"bin":{"xai":"dist/cli.js","xai-mcp-server":"dist/mcp.js"},"dist":{"shasum":"f3c22f06db893d3032088dcfaa95a01a22d1e42e","tarball":"https://registry.npmjs.org/@daveremy/xai-mcp/-/xai-mcp-0.1.1.tgz","fileCount":26,"integrity":"sha512-lfacilSC4qLrpkLq6rFzxzvt/rf41irLRYCv+z4lAMtfe+SkALei8fgWOvjoz2j4pOsgNGm7Cpkzxt20vEct9w==","signatures":[{"sig":"MEQCID40VqVE93GRAqrFRGzUZFqIA3D9VD4inRDt/m+5EZKwAiAhLWK/grMXgQ5r4MPWIM3GsE1KbEjwJcDNEpggyCe4eA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":23788},"type":"module","engines":{"node":">=20.6.0"},"gitHead":"fcd66b2b1dba9f3845759563e4b3e90af38ce07b","scripts":{"dev":"tsx src/cli.ts","test":"node --import tsx --test test/*.test.ts","build":"tsc && chmod +x dist/cli.js dist/mcp.js","prepack":"npm run build","release":"./scripts/release.sh"},"_npmUser":{"name":"daveremy","email":"email@daveremy.com"},"repository":{"url":"git+https://github.com/daveremy/xai-mcp.git","type":"git"},"_npmVersion":"11.12.0","description":"xAI (Grok) MCP server and CLI — search X/Twitter, resolve tweets, fetch threads, and web search","directories":{},"_nodeVersion":"25.8.1","dependencies":{"zod":"^4.3.6","commander":"^14.0.3","@modelcontextprotocol/sdk":"^1.27.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.21.0","typescript":"^6.0.2","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/xai-mcp_0.1.1_1774322786973_0.2866831137902417","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@daveremy/xai-mcp","version":"0.1.2","description":"xAI (Grok) MCP server and CLI — search X/Twitter, resolve tweets, fetch threads, and web search","type":"module","license":"MIT","engines":{"node":">=20.6.0"},"keywords":["xai","grok","mcp","model-context-protocol","twitter","x","search","cli"],"repository":{"type":"git","url":"git+https://github.com/daveremy/xai-mcp.git"},"bin":{"xai":"dist/cli.js","xai-mcp-server":"dist/mcp.js"},"scripts":{"build":"tsc && chmod +x dist/cli.js dist/mcp.js","prepack":"npm run build","dev":"tsx src/cli.ts","test":"node --import tsx --test test/*.test.ts","release":"./scripts/release.sh"},"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1","commander":"^14.0.3","zod":"^4.3.6"},"devDependencies":{"@types/node":"^25.5.0","tsx":"^4.21.0","typescript":"^6.0.2"},"gitHead":"4af74c06a4716587f0255c8d66e485c06d67c52f","_id":"@daveremy/xai-mcp@0.1.2","bugs":{"url":"https://github.com/daveremy/xai-mcp/issues"},"homepage":"https://github.com/daveremy/xai-mcp#readme","_nodeVersion":"25.9.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-R8TkwISOUajI3PTSH5wbtyRXWzMKiKRVINH4tfLLSXIEO27+9fN/mcup+C6ug3L+n7rWmAwUurcW6sST7ys5Xw==","shasum":"629c50604f99b1c363ea2a6f0f0cee4a159f57f4","tarball":"https://registry.npmjs.org/@daveremy/xai-mcp/-/xai-mcp-0.1.2.tgz","fileCount":27,"unpackedSize":24782,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDHtJNpOdO50HXK8MgfLZSU4xinZEJf2lgaU17qyCYXcAIhAJB/a5ZE7Ez0gUq+/RBDF9PYqbTij4Xgh4iNara8CJad"}]},"_npmUser":{"name":"daveremy","email":"email@daveremy.com"},"directories":{},"maintainers":[{"name":"daveremy","email":"email@daveremy.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/xai-mcp_0.1.2_1786420366373_0.1107151724073634"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-24T03:24:27.506Z","modified":"2026-08-11T03:52:46.696Z","0.1.0":"2026-03-24T03:24:27.702Z","0.1.1":"2026-03-24T03:26:27.117Z","0.1.2":"2026-08-11T03:52:46.533Z"},"bugs":{"url":"https://github.com/daveremy/xai-mcp/issues"},"license":"MIT","homepage":"https://github.com/daveremy/xai-mcp#readme","keywords":["xai","grok","mcp","model-context-protocol","twitter","x","search","cli"],"repository":{"type":"git","url":"git+https://github.com/daveremy/xai-mcp.git"},"description":"xAI (Grok) MCP server and CLI — search X/Twitter, resolve tweets, fetch threads, and web search","maintainers":[{"name":"daveremy","email":"email@daveremy.com"}],"readme":"# xai-mcp\n\nMCP server and CLI for the xAI API (Grok). Search X/Twitter, resolve tweet URLs, fetch threads, and web search.\n\n## Plugin Install\n\n```bash\n# Add marketplace (one time)\nclaude plugin marketplace add daveremy/xai-mcp\n\n# Install\nclaude plugin install xai-mcp@xai-mcp-plugins --scope user\n\n# Verify\nclaude plugin list | grep xai\n```\n\n## Manual Install\n\n```bash\nnpm install -g @daveremy/xai-mcp\n```\n\nOr add to your MCP config directly:\n\n```json\n{\n  \"mcpServers\": {\n    \"xai-mcp\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"-p\", \"@daveremy/xai-mcp\", \"xai-mcp-server\"]\n    }\n  }\n}\n```\n\n## Auth Setup\n\nSet your xAI API key (get one at [x.ai](https://x.ai)):\n\n```bash\nexport XAI_API_KEY=your-key-here\n```\n\nFor project-scoped setup with direnv:\n\n```bash\necho 'XAI_API_KEY=your-key-here' > .env\necho 'dotenv' > .envrc\ndirenv allow\n```\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `xai_x_search` | Search X/Twitter with optional date range and handle filters |\n| `xai_x_resolve` | Resolve a tweet/article URL to full content |\n| `xai_x_thread` | Fetch a full conversation thread |\n| `xai_web_search` | Web search via xAI Grok |\n\n## CLI Commands\n\n```bash\n# Search X/Twitter\nxai search \"Claude Code tips\"\nxai search \"AI news\" --from 2026-03-01 --to 2026-03-23\nxai search \"announcements\" --handles anthropic,openai\n\n# Resolve a tweet URL\nxai resolve https://x.com/user/status/123456789\n\n# Fetch a thread\nxai thread 123456789\n\n# Web search\nxai web \"best TypeScript MCP libraries\"\n```\n\n## Skills\n\nBundled `/xai` skill provides conversational workflows on top of the MCP tools:\n\n```\n/xai search Claude Code tips\n/xai resolve https://x.com/user/status/123\n/xai thread 123456789\n/xai web best melatonin supplement\n```\n\n## Development\n\n```bash\nnpm install\nnpm run dev -- search \"test query\"\nnpm run build\nnpm test\nnpm run release patch  # publish a new version\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}