Connect Codex to XBlueV with MCP
Connect XBlueV’s X data to Codex with MCP: create an API key, copy the config and run your first query.
XBlueV · 2026-11-05
1. Prepare your account, key and environment
Sign in to XBlueV, create an API key and check your points balance. Keep the key out of chat and public code. MCP discovery is free; data queries cost points.
Endpoint: https://xbluev.com/api/mcp. Use Streamable HTTP and your XBlueV API key, not a model provider key.
2. Add the MCP server
Merge the TOML below into ~/.codex/config.toml without replacing existing servers.
Set the key in the environment used to launch your agent, then restart it. An already running desktop app does not inherit new terminal variables.
PowerShell
$env:XBLUEV_API_KEY = 'xbv_YOUR_KEY'macOS / Linux
export XBLUEV_API_KEY='xbv_YOUR_KEY'[mcp_servers.xbluev]
url = "https://xbluev.com/api/mcp"
bearer_token_env_var = "XBLUEV_API_KEY"
tool_timeout_sec = 60Replace xbv_YOUR_KEY with your key. Copy buttons copy examples only and never read your credentials.
3. Verify and run your first query
Run codex mcp list to confirm registration, then inspect tools in a new session.
Use XBlueV to query the profile of elonmusk. Request one page only and show followers, source and points charged.Expect profile data and billing metadata. This step spends points; tool discovery alone does not validate your key or balance.
4. Troubleshooting and removal
- 401: check headers/environment, verify the key is active and restart. 402: replenish points. 429: respect Retry-After or wait for the daily reset.
- Skill missing: check nesting and SKILL.md. Execution failure: check Python, network and shell permissions. Do not automatically repeat paid calls.
- MCP connection failure: confirm /api/mcp and Streamable HTTP, not legacy SSE or OAuth.
- Uninstall: remove the Skill folder or xbluev MCP entry; WorkBuddy supports removal from the installed list. Revoke exposed keys on the developer page.
Another way to connect
Official client documentation ↗ · Reviewed: 2026-11-05
Keep exploring
Connect Codex to XBlueV with SKILL
Connect Claude Code to XBlueV with MCP
Connect Claude Code to XBlueV with SKILL
Connect WorkBuddy to XBlueV with MCP
Connect WorkBuddy to XBlueV with SKILL
X Original Content Rewards: Before You Apply