Connect Your AI to Remora

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

Requirements: Remora Pro subscription, Python 3.10+, an MCP-compatible AI host (Claude Desktop, Cursor, VS Code, etc.)

Setup

1 Generate an API Key

Go to your Account page and scroll to the API Keys section. Click Create Key, give it a name like "My AI", and copy the key.

The key is shown only once. Store it securely — you cannot retrieve it later.

2 Install the MCP Package

pip install heyremora

Requires Python 3.10+. This installs the heyremora command.

3 Configure your AI assistant

Open your AI assistant's config file. For Claude Desktop:

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

Add the following (replace the placeholders):

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

4 Restart your AI assistant

Quit and reopen your AI assistant. You should see Remora in the MCP tools list. Try a prompt like:

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 — Pro subscription required"

API keys require an active Pro subscription. Go to your Account page to check your subscription status.

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 42 tools and their parameters.