pip install clous

npm install @clousai/sdk

# Run the MCP server locally over npx…
npx @clousai/mcp
# …or use the zero-install hosted server at https://mcp.clous.ai

# Nothing to install — point any OpenAI-compatible client at Clous:
#   base_url = https://api.clous.ai/v1
#   model    = "clous"

from clous import Clous

# api_key defaults to CLOUS_API_KEY; here we pass the public sandbox key explicitly.
client = Clous(api_key="clous_live_sandbox_public_demo")

page = client.entities.search(q="apple", limit=1)

for entity in page:           # a Page iterates over page.data
    print(entity)

# Envelope metadata stays available as attributes on the Page:
print(page.as_of, page.source, page.has_more, page.next_cursor)

import { Clous } from "@clousai/sdk";

// apiKey defaults to process.env.CLOUS_API_KEY; here we pass the sandbox key.
const clous = new Clous({ apiKey: "clous_live_sandbox_public_demo" });

const res = await clous.entities.search({ q: "apple", limit: 1 });

for (const entity of res.data) {
  console.log(entity);
}

// Standard envelope fields:
console.log(res.as_of, res.source, res.page.has_more, res.page.next_cursor);

{
  "mcpServers": {
    "clous": {
      "type": "http",
      "url": "https://mcp.clous.ai",
      "headers": { "Authorization": "Bearer clous_live_sandbox_public_demo" }
    }
  }
}

{
  "mcpServers": {
    "clous": {
      "command": "npx",
      "args": ["-y", "@clousai/mcp"],
      "env": { "CLOUS_API_KEY": "clous_live_sandbox_public_demo" }
    }
  }
}

from openai import OpenAI

oai = OpenAI(
    base_url="https://api.clous.ai/v1",
    api_key="clous_live_sandbox_public_demo",
)
resp = oai.chat.completions.create(
    model="clous",
    messages=[{"role": "user", "content": "Summarize Apple's most recent 8-K."}],
)
print(resp.choices[0].message.content)

import OpenAI from "openai";

const openai = new OpenAI({
  baseURL: "https://api.clous.ai/v1",
  apiKey: "clous_live_sandbox_public_demo",
});
const res = await openai.chat.completions.create({
  model: "clous",
  messages: [{ role: "user", content: "Summarize Apple's most recent 8-K." }],
});
console.log(res.choices[0].message.content);