x-search-plugin
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@x-search-pluginsearch for recent tweets about AI from the last 24 hours"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
X Search Plugin
MCP plugin for read-only X/Twitter research through xAI's Responses API
x_search tool. It is packaged for Codex and Claude Code, supports xAI OAuth
login for entitled X Premium, Premium+, and SuperGrok accounts, and falls back
to XAI_API_KEY when no usable stored OAuth credential is present.
This is not a browser scraper. The plugin calls https://api.x.ai/v1/responses
with xAI's server-side x_search tool and returns Grok's answer plus citations
when xAI provides them.
Copy-Paste Agent Prompt
Paste this into Codex or Claude Code to have the agent set up and verify the plugin for you:
Set up x-search-plugin from https://github.com/Ilevk/x-search-plugin for this machine.
Use uv. Prefer xAI OAuth, but if I already have XAI_API_KEY configured, use that as the fallback. Do not ask me to paste access tokens, refresh tokens, API keys, browser cookies, or credential file contents into chat.
Steps:
1. Clone or update the repository.
2. Register the x-search-plugin MCP server for the current agent client.
- Codex: use codex mcp add or the Codex plugin marketplace flow.
- Claude Code: use claude mcp add --transport stdio.
3. Run uv run --quiet --locked python scripts/x_search_auth.py status.
4. If no credential is configured, ask me to run uv run --quiet --locked python scripts/x_search_auth.py login locally.
5. Run uv run --quiet --locked python scripts/smoke_mcp.py.
6. Confirm the MCP tools are available, then try a read-only X search for recent posts from @Lo_gan__.
Keep this read-only. Do not post, like, follow, DM, or mutate any X account state.Related MCP server: X MCP Server
Quickstart for Codex
Prerequisites: uv, Codex CLI with MCP support, and either an xAI OAuth-entitled
X Premium, Premium+, or SuperGrok account, or XAI_API_KEY.
git clone git@github.com:Ilevk/x-search-plugin.git
cd x-search-plugin
codex mcp add x-search-plugin -- uv run --quiet --locked python "$PWD/scripts/x_search_mcp.py"
uv run --quiet --locked python scripts/x_search_auth.py login
uv run --quiet --locked python scripts/x_search_auth.py status
uv run --quiet --locked python scripts/smoke_mcp.pyFor API-key usage instead, skip OAuth and set XAI_API_KEY before starting
Codex:
export XAI_API_KEY="..."Open a new Codex thread or restart Codex after changing credentials or MCP registration.
Quickstart for Claude Code
Prerequisites: uv, Claude Code with MCP support, and either an xAI OAuth-entitled
X Premium, Premium+, or SuperGrok account, or XAI_API_KEY.
git clone git@github.com:Ilevk/x-search-plugin.git
cd x-search-plugin
uv run --quiet --locked python scripts/x_search_auth.py login
claude mcp add --transport stdio --scope user x-search-plugin -- uv run --quiet --locked python "$PWD/scripts/x_search_mcp.py"
claudeApprove the x-search-plugin MCP server if prompted, then check /mcp.
claude mcp listDocumentation
Setup Guide - Codex, Claude Code, and marketplace install paths.
Authentication - OAuth, refresh, logout, credential priority, and API-key fallback.
Tools and Examples - MCP tools and common X research prompts.
Configuration - environment variables and runtime knobs.
Troubleshooting - common setup, auth, and xAI response failures.
Security Notes - read-only boundary and credential handling.
Development - smoke tests, packaging sync, and local verification.
License
MIT. See LICENSE and NOTICE.md.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Alicense-qualityDmaintenanceA read-only X/Twitter MCP server that enables data retrieval for user profiles, tweets, and social graphs using OAuth 2.0 Bearer Token authentication. It supports searching recent tweets, viewing timelines, and tracking engagement metrics like followers, likes, and retweets.Last updated3MIT
- AlicenseBqualityDmaintenanceMCP server for interacting with the X platform (Twitter) via MCP clients like Claude, Cursor AI, and Windsurf AI.Last updated20106MIT
- Flicense-qualityBmaintenanceRead-only MCP server for public X/Twitter search and retrieval via twitter.2-38.comLast updated
- AlicenseAqualityBmaintenanceMCP server for the Twitter/X read API, enabling search, user profiles, tweets, followers, and more via natural language.Last updated37541MIT
Related MCP Connectors
Hosted MCP for X/Twitter and Reddit. 12 read-only tools, no API keys, free during beta.
FastMCP server for posting formatted content to X (Twitter) — Tollbooth-monetized, DPYC-native
128 REST operations. 120 MCP routes; 119 JSON/text ops. OAuth 2.1. Not affiliated with X Corp.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Ilevk/x-search-plugin'
If you have feedback or need assistance with the MCP directory API, please join our Discord server