Introduction

import { ContextClient } from "@ctxprotocol/sdk";

const client = new ContextClient({ apiKey: "sk_live_..." });

// Query surface: curated intelligence, pay-per-response
const answer = await client.query.run("What are the top whale movements on Base?");

// Execute surface: explicit execute pricing + session budget
const executeTools = await client.discovery.search({
  query: "ethereum gas prices",
  mode: "execute",
  surface: "execute",
  requireExecutePricing: true,
});

const session = await client.tools.startSession({ maxSpendUsd: "2.00" });
const method = executeTools[0]?.mcpTools?.[0];
if (!method) throw new Error("No execute method available");

const result = await client.tools.execute({
  toolId: executeTools[0].id,
  toolName: method.name,
  args: { chainId: 1 },
  sessionId: session.session.sessionId ?? undefined,
});
console.log(result.session); // { methodPrice, spent, remaining, maxSpend, ... }