sdk-ts

Fiber AI TypeScript SDK

Help the user write TypeScript or JavaScript code using the @fiberai/sdk package.

When to Use

• User wants to BUILD an application using Fiber AI (not just query via MCP)
• User says "build", "create app", "write code", "typescript", "javascript", "node"
• User wants a wrapper, integration, data pipeline, or product on top of Fiber APIs

Do Not Use When

• User just wants to search or enrich via chat — use /fiber:search or /fiber:enrich instead
• User wants to write Python code — use /fiber:sdk-py instead

Quick Start

import { createClient, companySearch } from "@fiberai/sdk";

const client = createClient({
  baseUrl: "https://api.fiber.ai",
});

const result = await companySearch({
  client,
  body: {
    apiKey: process.env.FIBER_API_KEY!,
    searchParams: { /* filters */ },
    pageSize: 25,
  },
});

Key Concepts

• The SDK provides typed functions for every API endpoint
• Each API operationId becomes a named exported function (e.g., companySearch, peopleSearch, syncQuickContactReveal)
• apiKey is passed in the request body (for POST) or query string (for GET), not as a header
• Search filters go inside a searchParams object, not a filters object
• Pagination uses cursor, not page
• All functions are async and return typed responses
• zod is included for runtime validation schemas

Schema & Type Discovery

Fiber's request/response schemas are large and evolve across versions. The SDK is the best source of truth for field names and types:

1. From the installed package: check the exported types in @fiberai/sdk. Every operation function has fully typed parameters and return values. Use IDE autocomplete or inspect node_modules/@fiberai/sdk to discover available fields for searchParams, enrichmentType, etc.
2. From online docs: per-operation pages at https://api.fiber.ai/ai-docs/<operationId>.md describe every field with examples. Start with https://api.fiber.ai/llms.txt for routing.
3. From MCP at runtime: call get_endpoint_details_full("<operationId>") on the Core MCP to get the full current schema.
4. Open-source examples: https://github.com/fiber-ai/open-fiber has working code samples.