Quickstart

Get an API key

Fill out the access form at orakel.cloud. When approved, the email contains a /setup?key=… URL. 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, or SE. Default is NO. The same query against Swedish records:

curl -H "Authorization: Bearer orakel_YOUR_KEY" \
  "https://orakel.cloud/api/companies?q=Göteborg&country=SE&minEmployees=10"

Registry details per country: Brreg, YTJ, Bolagsverket.

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

• Claude Desktop (stdio) — install via npx and add to ~/Library/Application Support/Claude/claude_desktop_config.json:

  {
    "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 17-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 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.