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.

Claude Code (recommended)

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.

Scroll to the AI assistants (MCP) section

Click + New connection — this generates a personal MCP URL

Click Copy URL

In Claude.ai → Settings → Integrations → Add custom connector

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.

Claude Desktop

Claude Desktop connects via the Connectors panel — no npm install, no config file to edit.

Open Claude Desktop → Settings → Connectors (shown as Customize in some versions)

Click Add → Add custom connector

Enter name Orakel and URL https://orakel.cloud/api/mcp

A browser window opens — enter your email address

Click the magic link in the email to approve access — done

All 18 tools load immediately. Fully quit and reopen Claude Desktop (⌘Q on macOS) if they don't appear.

No account yet? Signing in for the first time creates a 7-day free trial automatically — no credit card needed.

Older versions without Connectors: Open ~/Library/Application Support/Claude/claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json) and add the Orakel server manually under mcpServers using npx -y @heibergindustries/orakel-mcp with your API key.

ChatGPT

ChatGPT MCP connector support requires a Plus, Pro, Team, or Enterprise subscription.

Open chatgpt.com → Settings → Connectors

Click Create (or +) → choose MCP Server

Enter name Orakel and URL https://orakel.cloud/api/mcp

A sign-in prompt appears — enter your email and click the magic link to approve

Tag Orakel in your messages 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)

Works with any MCP client that accepts a JSON stdio config — Claude Desktop, Cursor, and others.

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

Other stdio clients (Cursor, etc.)

Add to your client's MCP config file:

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

Teams and shared access

Each person on your team connects with their own sign-in — no API key to share or rotate. When using Claude Desktop or ChatGPT, each team member follows the connector setup above with their own email address. All members land on the same Orakel account and share the same quota and integrations.

For stdio clients (Claude Desktop manual setup, Cursor, and similar), team members share an API key. Key rotation: If a team member leaves, generate a new key from your account page and update each person's config.

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.

On this page