Python and TypeScript SDKs

pip install claribi-mcp

from claribi_mcp import Client

with Client(api_key="claribi_mcp_...") as client:
    client.initialize()
    dashboards = client.list_dashboards(limit=5)
    print(dashboards.structured["items"])

    result = client.run_analysis(question="What was revenue last quarter?")
    print(result.text)

from claribi_mcp import Client, BearerTokenAuth

def refresh():
    new_token, new_expires_at = your_oauth_refresh_flow()
    return new_token, new_expires_at

client = Client(
    auth=BearerTokenAuth(
        access_token=initial_token,
        expires_at=initial_expires_at,
        refresh_callable=refresh,
    ),
)

client = Client()  # anonymous; only public tools available

pending = client.register_account(
    email="me@example.com",
    organization_name="My Team",
    accept_terms=True,
)
pending_id = pending.structured["pending_id"]

code = input("Enter the 6-digit code from your email: ")
verified = client.verify_email(
    pending_id=pending_id,
    code=code,
    password="a-strong-password",
)
api_key = verified.structured["mcp_api_key"]
print(f"Save this key: {api_key}")

from claribi_mcp import Client, ToolError

with Client(api_key="claribi_mcp_...") as client:
    try:
        client.run_analysis(question="anything")
    except ToolError as exc:
        print(exc.code, exc.message)  # -32007 "Feature not available"

python scripts/codegen.py \
  --catalog https://claribi.com/api/mcp-server/tool-catalog/ \
  --output claribi_mcp/generated

npm install @claribi/mcp

import { Client } from '@claribi/mcp';

const client = new Client({ apiKey: 'claribi_mcp_...' });
await client.initialize();

const dashboards = await client.callTool('list_dashboards', { limit: 5 });
console.log(dashboards.structured);

const result = await client.callTool('run_analysis', {
  question: 'What was revenue last quarter?',
});
console.log(result.text());

import { Client, BearerTokenAuth } from '@claribi/mcp';

const client = new Client({
  auth: new BearerTokenAuth(
    initialAccessToken,
    initialExpiresAtEpochSeconds,
    async () => {
      const refreshed = await yourOAuthRefreshFlow();
      return refreshed;  // { accessToken, expiresAt }
    },
  ),
});

npm run codegen -- \
  --catalog https://claribi.com/api/mcp-server/tool-catalog/ \
  --output src/generated

import { Client, ToolError } from '@claribi/mcp';

const client = new Client();  // anonymous
try {
  await client.callTool('list_dashboards');
} catch (err) {
  if (err instanceof ToolError) {
    console.error(err.code, err.message);  // -32001 "Authentication required"
  }
}