Connect your AI to Remora

Screen options, analyze portfolios, and compare strategies — all from a conversation with your AI.

Live now. The one-click connector is available — add the URL in Claude or ChatGPT and sign in. Cursor and VS Code take the same server on their own tab, and the local install (pip) tab is there if you want the server on your own machine.
Requirements: an active Remora trial or Professional and above — the free trial includes connector access, so you can connect while you evaluate. The one-click connector needs nothing installed; the local (pip) path needs Python 3.10+.

The connector URL

Wherever you connect, this is the address you paste. You sign in with your existing Remora login — the AI is never handed your password or an API key.

https://mcp.heyremora.com/mcp

Open Claude's connector settings →

Choose your surface

  1. Open Settings → Connectors (newer builds label this Customize → Connectors).
  2. Click +, then Add custom connector.
  3. Paste the connector URL above. Leave OAuth Client ID / Secret blank — they're optional.
  4. Click Add, then Connect. A window opens on Remora; sign in (or you're already signed in) and approve.
  5. In a chat, use the + menu → Connectors to switch Remora on for that conversation.
Connectors are account-level, so adding Remora once on the web also makes it appear in Claude Desktop and Cowork. It is expected to appear in the Claude mobile app the same way (adding a connector from mobile itself is not a documented path). On Team / Enterprise, an Owner adds it under Organization settings > Connectors, and each member connects with their own Remora login — portfolios are per user.

Already signed in? It may already be there.

If you logged into Claude Code with your Claude account, a connector you added on the web is available automatically — run /mcp to see it. (This does not apply when ANTHROPIC_API_KEY, Bedrock/Vertex, or a setup-token is the active auth — run /status, then /login.)

Or add it directly

claude mcp add --transport http --scope user remora https://mcp.heyremora.com/mcp

Then run /mcp, select remora, and choose Authenticate — a browser opens for the Remora sign-in. --scope user makes it available in every project.

If a long screen ever trips the 60-second first-response timer, raise the per-server timeout:

claude mcp add-json --scope user remora '{"type":"http","url":"https://mcp.heyremora.com/mcp","timeout":120000}'

ChatGPT connects to Remora as a custom connector. It cannot run the local (pip) server, so this is the path — the same connector URL as Claude.

  1. Open Settings, select Security and login, and turn on Developer mode.
  2. Go to chatgpt.com/plugins and select the plus button.
  3. Enter a user-facing name and description — "Remora", and what you use it for.
  4. Under Connection, enter the MCP server URL, including the /mcp path — the connector URL above.
  5. Create the connection. Authentication is discovered from the server, so a window opens on Remora; sign in with your Remora login and approve.
  6. Back in a chat, open the + (tools) menu and switch Remora on for that conversation.
Developer-mode availability depends on your account and workspace policy, so on a managed workspace an admin may have to allow it first.
Soon: find Remora in the ChatGPT app directory, so none of the above is needed.

Cursor and VS Code both speak the remote server, so neither needs the local package or an API key. The local (pip) path is the next tab if you would rather run the server yourself.

Cursor

One click: Add to Cursor. Cursor asks to install the server, then authenticates with your Remora login.

Or add it by hand, in ~/.cursor/mcp.json (or .cursor/mcp.json for one project) — a remote server is the entry with a url:

{
  "mcpServers": {
    "remora": {
      "url": "https://mcp.heyremora.com/mcp"
    }
  }
}

Then open a chat and ask for something. If Cursor asks you to sign in, sign in with your Remora login and approve. Installed servers are managed on Cursor's Customize page.

VS Code

Add the remote server to mcp.json. MCP: Open User Configuration opens the one in your user profile; .vscode/mcp.json is the per-workspace file.

{
  "servers": {
    "remora": {
      "type": "http",
      "url": "https://mcp.heyremora.com/mcp"
    }
  }
}

Or from the command line — MCP: Add Server in the Command Palette is the guided version of the same thing:

code --add-mcp "{\"name\":\"remora\",\"type\":\"http\",\"url\":\"https://mcp.heyremora.com/mcp\"}"

VS Code shows a dialog the first time the server starts: review it, then sign in with your Remora login when the browser opens. Configure Tools in the chat input lists Remora's tools.

Formats verified 2026-10-01: the Cursor install link from cursor.com/docs/mcp/install-links and its remote url entry from cursor.com/docs/mcp; the VS Code servers / type: http entry and --add-mcp from code.visualstudio.com/docs/copilot/customization/mcp-servers.

For offline use, or any client that runs a local (stdio) MCP server. This path uses a personal API key and works today. Cursor and VS Code can use it too, though both reach the remote server directly.

1 Generate an API key

Go to your Account page → API Keys, click Create Key, name it (e.g. "My AI"), and copy it.

The key is shown once and stored only as a SHA-256 hash — we cannot show it again later. If you didn't save it, create a fresh key on the Account page; existing keys keep working until you revoke them.
2 Install the package
pip install heyremora

Requires Python 3.10+. This installs the heyremora command.

3 Configure your client

Open your client's MCP config file. For Claude Desktop (macOS):

~/Library/Application Support/Claude/claude_desktop_config.json

Add the following, replacing the placeholder with your key:

{
  "mcpServers": {
    "remora": {
      "command": "heyremora",
      "env": {
        "REMORA_API_KEY": "otx_live_YOUR_KEY_HERE",
        "REMORA_API_URL": "https://heyremora.com"
      }
    }
  }
}
4 Restart your client

Quit and reopen it. You should see Remora in the tools list. Try:

Find me cash-secured puts on AAPL and NVDA with delta between 0.20-0.35 and at least 30 DTE

Troubleshooting

"Invalid API key" error

Check that your REMORA_API_KEY in the config matches exactly what was shown when you created the key. Keys start with otx_live_.

"Cannot connect to Remora API" error

Verify REMORA_API_URL is set correctly. For the production API, use https://heyremora.com.

"API key inactive — active trial or paid plan required"

API keys need an active trial or a paid plan. If your trial has expired, existing keys stop authenticating until you subscribe — the keys themselves are not deleted. Check your status on the Account page.

Tools don't appear in my AI assistant

1. Make sure the package is installed: pip install heyremora

2. Check the config file path is correct (Claude Desktop, macOS: ~/Library/Application Support/Claude/claude_desktop_config.json)

3. Restart your AI assistant completely (Quit, not just close the window)

4. Check MCP logs for error details (Claude Desktop, macOS: ~/Library/Logs/Claude/)

"Rate limit exceeded" error

Pro accounts have generous rate limits (100 req/min). If you hit the limit, wait a minute and try again. Avoid running bulk screens in tight loops.

What's Next

See the Tool Reference for the full list of tools (45+) and their parameters.