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's connector settings and sign in. The Cursor / VS Code / local (pip) tab is there if you prefer a local setup.
Requirements: an active Remora trial or Professional and above — the 14-day 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.
  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 Admin 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}'

For Cursor, VS Code, offline use, or any client that runs a local (stdio) MCP server. This path uses a personal API key and works today.

1 Generate an API key

Go to your Account pageAPI 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.