Skip to content

Connect InsiderAlpha to Codex

Add InsiderAlpha from MCP server settings in the OpenAI desktop app or IDE extension. The Codex CLI uses the same configuration; terminal commands and a manual config option are below.

Server URL
https://mcp.insideralpha.ai/mcp

Choose Streamable HTTP and OAuth sign-in if asked. Use this full URL, including /mcp. A free InsiderAlpha account is enough to connect. Sign up free · Manage AI access

Setup in Codex

  1. Open MCP server settings

    In the desktop app, open Settings, then MCP servers, and choose Add server. In the IDE extension, open the gear menu and choose MCP servers.

  2. Add InsiderAlpha as a Streamable HTTP server

    Name the server insideralpha, choose Streamable HTTP, and paste the full server URL. No client ID, client secret or bearer token is needed for OAuth sign-in.

    Server URL for Codex
    https://mcp.insideralpha.ai/mcp

  3. Save, restart, and authenticate

    Save the server and use the restart action shown by your app. Select Authenticate for InsiderAlpha, then finish sign-in and review access in your browser.

  4. Check the connection

    Enter /mcp in the composer to check the connected server. Start a new conversation and ask InsiderAlpha for recent insider purchases with SEC filing sources.

Terminal and configuration options

Use the CLI commands, or add a configuration entry manually.

Connect using the Codex CLI

Terminal commands
codex mcp add insideralpha --url https://mcp.insideralpha.ai/mcp
codex mcp login insideralpha

Run these in your terminal. Complete the browser sign-in when it opens. If adding the server already prompted sign-in, the login command is only needed when authentication is still required.

Manual configuration with OAuth

TOML configuration
[mcp_servers.insideralpha]
url = "https://mcp.insideralpha.ai/mcp"

Alternatively, add this to ~/.codex/config.toml (or .codex/config.toml in a trusted project), then run codex mcp login insideralpha.

Optional: use a Personal Access Token

TOML configuration
[mcp_servers.insideralpha]
url = "https://mcp.insideralpha.ai/mcp"
bearer_token_env_var = "INSIDERALPHA_MCP_TOKEN"

Create a token in AI access settings and provide it through the INSIDERALPHA_MCP_TOKEN environment variable. This field takes the variable name, never the token itself. Use this option instead of OAuth when you need token authentication.

Codex troubleshooting

3

Failure modes specific to this client, and what is actually going on.

Sign-in shows redirect_uri not registered for client

Start a fresh Authenticate or codex mcp login insideralpha attempt. Keep the app running while you sign in, and use the newly opened browser window. Do not edit or reuse a copied /authorize or localhost callback URL. If it still fails, contact InsiderAlpha with the error text, without sharing the full sign-in URL.

The tools do not appear after sign-in

Check that the saved URL includes /mcp, the server is enabled, and /mcp shows it as connected. Restart the app or extension after changing the configuration.

Token authentication fails

bearer_token_env_var holds the name of an environment variable. Ensure that variable is available to the process running Codex. A token pasted directly into this field cannot be looked up.

Good to know

  • Desktop, CLI and IDE clients on the same Codex host share MCP configuration. Project configuration applies only to trusted projects.
  • Manage connected sessions and access tokens in InsiderAlpha's AI access settings. Token revocation can take about a minute to take effect.

What the server exposes

19 tools in total: 14 read-only research, market and portfolio tools, plus 5 that act on a connected broker account and are switched off unless you explicitly enable them. The full list, the scopes and the rate limits are the same whichever client you use, so they live in one place: the MCP server reference.

Setting up a different client

Codex setup steps verified against OpenAI documentation: Model Context Protocol on 2026-09-08. Codex controls its own interface and can change it without notice, so if a menu name here does not match what you see, trust their documentation over ours and tell us.

InsiderAlpha returns SEC filing data and research output. It is informational and is not investment advice, and nothing it returns is a recommendation to buy or sell any security. You are responsible for every order placed from your own account.

Related