Quickstart

Get an API key

MCP clients with OAuth support (Claude.ai, ChatGPT, Gemini): connect via the one-click OAuth flow — a key is provisioned automatically, no form needed.

REST API or manual MCP setup: sign up at orakel.cloud/signup. Your API key and setup link arrive in the welcome email. Keys are issued per project.

First query (curl)

Authenticate with a bearer token. This searches for Norwegian companies in Bergen with 10+ employees:

curl -H "Authorization: Bearer orakel_YOUR_KEY" \
  "https://orakel.cloud/api/companies?q=Bergen&country=NO&minEmployees=10"

Truncated response:

{
  "data": [
    {
      "orgNumber": "123456789",
      "name": "Example AS",
      "country": "NO",
      "numEmployees": 42,
      "naceCode1": "62.010"
    }
  ],
  "nextCursor": "clx...",
  "hasMore": true
}

All supported countries

The country query parameter accepts NO, FI, SE, or DK. Default is NO. The same query against Danish records:

curl -H "Authorization: Bearer orakel_YOUR_KEY" \
  "https://orakel.cloud/api/companies?q=København&country=DK&minEmployees=10"

Registry details per country: Brreg, YTJ, Bolagsverket, CVR.

JavaScript

Plain fetch, no SDK:

const res = await fetch(
  "https://orakel.cloud/api/companies?q=Bergen&country=NO&minEmployees=10",
  { headers: { Authorization: `Bearer ${process.env.ORAKEL_API_KEY}` } },
);
const { data, nextCursor, hasMore } = await res.json();

Connect an MCP client

• One-click OAuth (Claude.ai, ChatGPT, Gemini web) — the easiest path. Open integrations in your AI host, point it at https://orakel.cloud, click Connect, approve. See MCP setup for the full walkthrough.

• Claude Code (plugin — recommended) — add the marketplace, install, OAuth sign-in, no config editing:

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

  Skills appear as /orakel:prospect, /orakel:company-deep-dive, etc.

• Claude Desktop / Gemini CLI (stdio) — install via npx and add to your client config:

  {
    "mcpServers": {
      "orakel": {
        "command": "npx",
        "args": ["-y", "@heibergindustries/orakel-mcp@latest"],
        "env": { "ORAKEL_API_KEY": "orakel_YOUR_KEY" }
      }
    }
  }

• HTTP MCP — for any client that speaks MCP Streamable HTTP (ChatGPT Desktop, web agents), POST directly to https://orakel.cloud/api/mcp with Authorization: Bearer orakel_YOUR_KEY. No npm install.

See MCP tools for the full 18-tool catalog and MCP skills for the 5 guided workflows surfaced as prompts in Claude Desktop, Code, Cursor, and Gemini CLI.

Common patterns

Lookup → enrich → push. Fetch a company by orgNumber, call the enrichment endpoint for domain and tech stack, then push to a configured CRM destination.

Nordic-wide search. Iterate country across NO, FI, SE, DK to cover the region in one sweep.

Financial filters. Combine minRevenue, maxRevenue, minEmployees, maxEmployees to narrow prospecting lists to size bands that match the ICP.