orakel
Docs navigation

MCP Server Setup

Updated 2026-06-11

MCP Server Setup

Orakel's MCP server lets you query Nordic company data directly from any MCP-compatible AI client — web apps, desktop apps, and CLI tools.

The easiest way to get Orakel in Claude Code is the plugin. Add the Orakel marketplace, install the plugin, sign in — no API key to copy, no config file to edit.

/plugin marketplace add Heiberg-Industries/orakel-plugin
/plugin install orakel@orakel

Claude Code will prompt you to sign in with your Orakel account. If you're new, a 7-day trial key is created automatically. All five guided workflows (skills) are bundled with the plugin and appear as /orakel:prospect, /orakel:company-deep-dive, etc.

Claude.ai (web)

Claude.ai web does not reliably send the authorization token after OAuth. The fastest path is the personal MCP URL — 30 seconds, no OAuth required.

  1. Sign in to your Orakel account → go to Account → Integrations
  2. Scroll to the AI assistants (MCP) section
  3. Click + New connection — this generates a personal MCP URL
  4. Click Copy URL
  5. In Claude.ai → Settings → Integrations → Add custom connector
  6. Paste the URL as the server address

All 18 Orakel tools will load immediately. No email confirmation needed.

Prefer OAuth? The standard OAuth flow works for both new and existing users. Enter your email, click the magic link, approve access. Claude.ai stores the token automatically. Use the personal URL if you run into any issues.

ChatGPT

ChatGPT MCP support requires a Plus or Pro subscription and runs in developer mode (beta). Setup is web-only — the desktop app does not support MCP connectors.

  1. Open chatgpt.com in a web browser
  2. Go to Settings → Apps → scroll to Advanced → enable Developer Mode
  3. Click Create app → choose MCP Server
  4. Enter your personal MCP URL (from Account → Integrations) as the server address
  5. Choose No authentication
  6. Tag Orakel in your message with @orakel to activate it

All 18 tools are available. Mention @orakel at the start of your message to ensure ChatGPT uses the connector rather than web search.

Manual setup (stdio transport) — Claude Desktop, Gemini CLI

For clients that run a local MCP process, install via npx and add your API key to the client config.

Claude Desktop

  1. Open your Claude Desktop config file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add the Orakel server to the mcpServers block:

{
  "mcpServers": {
    "orakel": {
      "command": "npx",
      "args": ["-y", "@heibergindustries/orakel-mcp"],
      "env": {
        "ORAKEL_API_KEY": "your-api-key-here"
      }
    }
  }
}
  1. Restart Claude Desktop.
  2. Ask Claude: "Look up Vipps MobilePay AS in Orakel" — you should see company data.

Claude Code (manual alternative)

If you prefer not to use the plugin, add via CLI:

claude mcp add orakel -- npx -y @heibergindustries/orakel-mcp

Then set your key in your project's .env:

ORAKEL_API_KEY=your-api-key-here

Gemini CLI

Add to your Gemini CLI config:

{
  "mcpServers": {
    "orakel": {
      "command": "npx",
      "args": ["-y", "@heibergindustries/orakel-mcp"],
      "env": { "ORAKEL_API_KEY": "your-api-key-here" }
    }
  }
}

Shared key for teams

If multiple people at your company want MCP access, they all use the same API key. Each person adds it to their own device config above.

Key rotation: If a team member leaves, contact hello@orakel.cloud to rotate your key. Update each person's config with the new key.

Troubleshooting

"orakel not found" / tool not responding

  • Verify ORAKEL_API_KEY is set correctly (no extra spaces or quotes)
  • Try npx @heibergindustries/orakel-mcp directly in terminal — if it fails, npm is not installed
  • Restart the MCP client after config changes

402 Trial expired Your trial has ended. Visit orakel.cloud/upgrade to add a payment method.

403 Unauthorized The API key is invalid or has been rotated. Check your key at orakel.cloud or contact hello@orakel.cloud.

Rate limit (429) You have exceeded your monthly quota or hit the per-minute limit. Contact hello@orakel.cloud if you need a higher cap.