eyeballdocs
Guides

Choose a tool format

Filter the packaged catalog and emit model-native tool definitions without a network request.

tools.get filters the packaged catalog by toolkit or capability and converts the result for Anthropic, OpenAI, AI SDK, MCP, or direct canonical use.

ts
import { Eyeball } from "@eyeball/sdk";

const eyeball = new Eyeball({
  apiKey: process.env.EYEBALL_API_KEY!,
  baseUrl: process.env.EYEBALL_EXECUTOR_URL!,
});
const bundle = await eyeball.tools.get({
  toolkits: ["gmail", "google-calendar"],
  format: "anthropic",
});
console.log(bundle.tools, bundle.raw, bundle.nameMap);

Every format returns the same three-part bundle:

  • tools: definitions in the requested format;
  • raw: canonical ToolDefinition[];
  • nameMap: reversible canonical/wire-name mapping.

The method is async for API stability but does not call a hosted catalog. AI SDK output needs a user binding because its emitted execute callbacks invoke tools directly. MCP output includes async-by-nature tools only after the caller has negotiated Tasks and requests includeAsync.

See the generated Tools API for the complete option and result types.