@stealth-code/omegaindexer-mcp
v1.1.0
Published
Installer/configurator for the hosted Omegaindexer MCP server (omegaindexer.com). Writes per-host MCP config for HTTP-native MCP hosts.
Readme
@stealth-code/omegaindexer-mcp
Connect the hosted Omegaindexer MCP server to your AI client.
You need an Omegaindexer account and a browser for the one-time sign-in (any device — even a phone).
One thing to know: the server is hosted (https://mcp.omegaindexer.com/mcp) — there's nothing to run locally. Every client just registers that URL as a remote MCP server. Sign-in is automatic browser OAuth on first use; you never paste a token. (Exception: chat-only headless hosts that can't do OAuth — see Headless hosts.)
Shortcut for desktop clients:
npx -y @stealth-code/omegaindexer-mcp installauto-detects Claude Code, Claude Desktop, Codex CLI, Cursor, and Windsurf, then asks which of them to configure (press Enter for all, or pass--yesto skip the prompt). The per-client prompts below do the same thing explicitly (and cover OpenCode + headless hosts, which the installer doesn't).
Set up your client
Pick your client and paste the prompt to its AI assistant. Then restart the client — on the first Omegaindexer tool call your browser opens to sign in. Verify with: "Run omegaindexer_whoami."
Claude Code
Add the hosted Omegaindexer MCP server to Claude Code by running
claude mcp add --transport http omegaindexer https://mcp.omegaindexer.com/mcp. It's a remote HTTP server — don't register it as a local/stdio command.
Cursor
Add the hosted Omegaindexer MCP server to Cursor: in
~/.cursor/mcp.json, merge intomcpServersthe entry"omegaindexer": { "url": "https://mcp.omegaindexer.com/mcp" }. It's a remote HTTP server — nocommand/stdio.
Codex CLI
Add the hosted Omegaindexer MCP server to Codex: append this to
~/.codex/config.toml—[mcp_servers.omegaindexer]on one line, thenurl = "https://mcp.omegaindexer.com/mcp". It's a remote HTTP server — nocommand.
Windsurf
Add the hosted Omegaindexer MCP server to Windsurf: in
~/.codeium/windsurf/mcp_config.json, merge intomcpServersthe entry"omegaindexer": { "url": "https://mcp.omegaindexer.com/mcp" }. It's a remote HTTP server — nocommand/stdio.
Claude Desktop
Add the Omegaindexer MCP server to Claude Desktop via Settings → Connectors → Add custom connector, with URL
https://mcp.omegaindexer.com/mcp. (Editingclaude_desktop_config.jsondoes not register remote servers — use the Connectors UI.)
OpenCode
Add a remote MCP server named
omegaindexerwith urlhttps://mcp.omegaindexer.com/mcpto my OpenCode config (~/.config/opencode/opencode.json, undermcp, with"type": "remote"and"enabled": true). Do not install the npm package and do not usetype: "local"/npx — it's a hosted server, so a local/stdio entry will fail to connect.
Headless hosts
Chat-only gateways (Hermes, Discord/Slack/Telegram bots) can't do browser OAuth. They connect to https://mcp.omegaindexer.com/mcp-headless and sign in via a device-flow that mints a long-lived token, stored as an Authorization header. Don't run the npx … install CLI on these — it only configures desktop clients.
Hermes
Install Omegaindexer by fetching
https://mcp.omegaindexer.com/install/headlessand following it verbatim. Do not run the@stealth-code/omegaindexer-mcpnpm CLI, and do not usehermes mcp login/--auth oauth— this host signs in through the device-flow runbook at that URL.
OpenClaw
OpenClaw can't do OAuth for remote MCP servers (openclaw mcp has no auth/login subcommand — only a static Authorization header). So it signs in with a token via the headless device-flow. In a terminal:
- Register the headless endpoint (note
/mcp-headless, not/mcp):openclaw mcp set omegaindexer '{"url":"https://mcp.omegaindexer.com/mcp-headless","transport":"streamable-http"}' - Reload OpenClaw so it connects and exposes the tools (restart your OpenClaw gateway/session).
- Ask an OpenClaw agent to call the
omegaindexer_logintool. It returns a URL + 8-char code — open the URL, enter the code, approve in your browser. - It returns a token. Store it by re-running
setwith the full entry plus the header:openclaw mcp set omegaindexer '{"url":"https://mcp.omegaindexer.com/mcp-headless","transport":"streamable-http","headers":{"Authorization":"Bearer <TOKEN>"}}' - Reload again, then verify by asking an agent to run
omegaindexer_whoami.
Uninstall
Paste to your AI assistant: "Uninstall the Omegaindexer MCP server from this client." Or remove it manually:
| Client | Removal |
| -------------- | ---------------------------------------------------------------- |
| Claude Code | claude mcp remove omegaindexer |
| Claude Desktop | remove the connector from Settings → Connectors |
| Codex CLI | remove [mcp_servers.omegaindexer] from ~/.codex/config.toml |
| Cursor | remove omegaindexer from ~/.cursor/mcp.json |
| Windsurf | remove omegaindexer from ~/.codeium/windsurf/mcp_config.json |
| OpenCode | remove omegaindexer from ~/.config/opencode/opencode.json |
| Hermes | remove the omegaindexer entry from ~/.hermes/config.yaml |
Revoke access any time at omegaindexer.com → Settings → Connected MCP Clients.
