API Guide & Reference

Authorization: Bearer bc_live_99f8e3a2b1c4d5e6f7a8b9c0

import os
from bettercontext import BetterContextClient

client = BetterContextClient(api_key=os.environ.get("BETTERCONTEXT_API_KEY"))

# Retrieve grounded, de-confounded context for a coding agent
response = client.context.query(
    prompt="Refactor the authentication middleware to support JWT refresh tokens",
    agent_id="cursor-agent-01",
    user_role="engineer",
    max_tokens=2048,
    focus_mode=True
)

print("Synthesized Context:", response.context_string)
print("Causal Attribution:", response.causal_delta)
print("Graph Nodes Cited:", [node.title for node in response.citations])

import { BetterContext } from '@bettercontext/sdk';

const bc = new BetterContext({
  apiKey: process.env.BETTERCONTEXT_API_KEY,
});

async function run() {
  const context = await bc.context.query({
    prompt: "Refactor the authentication middleware to support JWT refresh tokens",
    agentId: "claude-code-worker",
    userRole: "engineer",
    maxTokens: 2048,
    focusMode: true,
  });

  console.log("Packed Tokens:", context.tokensUsed);
  console.log("Citations:", context.citations);
}

run();

curl -X POST https://api.bettercontext.dev/v1/context/query \
  -H "Authorization: Bearer $BETTERCONTEXT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Refactor auth middleware for JWT refresh",
    "agent_id": "cli-agent",
    "max_tokens": 2048,
    "focus_mode": true
  }'