MCP Server Setup

Orakel's MCP server lets you query Nordic company data directly from Claude Desktop, Claude Code, and Gemini CLI. One API key, each person configures their own device.

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"
      }
    }
  }
}

3. Restart Claude Desktop.
4. Ask Claude: "Look up Vipps MobilePay AS in Orakel" — you should see company data.

Claude Code

Run in your terminal:

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

Then set your key:

ORAKEL_API_KEY=your-api-key-here

Or add it to 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 5 people at your company all want MCP access, they all use the same API key. Each person adds it to their own device config above. The key is yours — share it with your team members directly.

Key rotation: If a team member leaves, contact hello@orakel.cloud to rotate your key. We will issue a new one; 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 50,000 lookups this month, or hit the per-minute limit. Contact hello@orakel.cloud if you need a higher cap.