# CBK AI Documentation

> Official SDK documentation for CBK AI (ChatBotKit) - comprehensive guides, API references, and type documentation for building AI agents and agentic applications with Node.js, React, Next.js, Go, and Python.

CBK AI Documentation provides complete technical documentation for developers building with the CBK AI SDKs. This includes detailed API references, integration guides, code examples, and best practices for implementing AI agents in your applications.

The documentation covers:
- Complete SDK API references with typed clients and TypeScript definitions
- Integration guides for Node.js, React, Next.js, Go, and Python
- Code examples and usage patterns
- Authentication and configuration
- Best practices and optimization strategies

## SDKs

- [@chatbotkit/sdk](https://www.npmjs.com/package/@chatbotkit/sdk): Core CBK API SDK for Node.js
- [@chatbotkit/agent](https://www.npmjs.com/package/@chatbotkit/agent): Agent SDK for building autonomous agents
- [@chatbotkit/react](https://www.npmjs.com/package/@chatbotkit/react): React SDK with hooks and components
- [@chatbotkit/next](https://www.npmjs.com/package/@chatbotkit/next): Next.js SDK with server and client utilities
- [@chatbotkit/nextauth](https://www.npmjs.com/package/@chatbotkit/nextauth): NextAuth.js integration
- [@chatbotkit/fetch](https://www.npmjs.com/package/@chatbotkit/fetch): Isomorphic fetch implementation
- [@chatbotkit/cli](https://www.npmjs.com/package/@chatbotkit/cli): Command-line interface for managing agents and resources
- [Go SDK](https://github.com/chatbotkit/go-sdk): Official SDK for Go applications and services (`github.com/chatbotkit/go-sdk`)
- [Python SDK](https://pypi.org/project/chatbotkit/): Official async Python SDK (`pip install chatbotkit`)
- [Terraform Provider](https://registry.terraform.io/providers/chatbotkit/chatbotkit): Provision and manage ChatBotKit resources as infrastructure-as-code

## API Reference

- [Complete API Specification](https://api.cbk.ai/v1/spec): Full OpenAPI v3 specification

## REST API for Content Discovery

CBK AI provides REST API endpoints for programmatically discovering and accessing documentation and manuals:

### List Available Manuals

```
GET https://api.cbk.ai/v1/platform/manual/list
```

Returns a complete list of available technical manuals with metadata including:
- Manual ID, title, and description
- Category and tags for filtering
- Creation and update timestamps
- Display order index

Example response structure:
```json
{
  "items": [
    {
      "id": "authentication",
      "name": "Authentication",
      "description": "API authentication methods and security",
      "category": null,
      "tags": [],
      "index": 1,
      "createdAt": 1696118400000,
      "updatedAt": 1696118400000
    }
  ]
}
```

### Fetch Individual Manual

```
GET https://api.cbk.ai/v1/platform/manual/{manualId}/fetch
```

Retrieves the full content of a specific manual by ID.

### Search Manuals

Performs semantic search across all manuals using vector embeddings. Returns ranked results with similarity scores.

```
POST https://api.cbk.ai/v1/platform/manual/search
Content-Type: application/json

{
  "search": "your search query"
}
```

Response includes similarity scores for ranking search results (top 20 results returned).

### List Available Docs

```
GET https://api.cbk.ai/v1/platform/doc/list
```

Returns a complete list of available documentation articles with similar metadata structure.

### Fetch Individual Doc

```
GET https://api.cbk.ai/v1/platform/doc/{docId}/fetch
```

Retrieves the full content of a specific documentation article by ID.

### Search Docs

Performs semantic search across all documentation using vector embeddings. Returns ranked results with similarity scores.

```
POST https://api.cbk.ai/v1/platform/doc/search
Content-Type: application/json

{
  "search": "your search query"
}
```

Response includes similarity scores for ranking search results (top 20 results returned).

### List Available Tutorials

```
GET https://api.cbk.ai/v1/platform/tutorial/list
```

Returns a complete list of available tutorials with similar metadata structure.

### Fetch Individual Tutorial

```
GET https://api.cbk.ai/v1/platform/tutorial/{tutorialId}/fetch
```

Retrieves the full content of a specific tutorial by ID.

### Search Tutorials

Performs semantic search across all tutorials using vector embeddings. Returns ranked results with similarity scores.

```
POST https://api.cbk.ai/v1/platform/tutorial/search
Content-Type: application/json

{
  "search": "your search query"
}
```

Response includes similarity scores for ranking search results (top 20 results returned).

## Model Context Protocol (MCP) Integration

CBK AI provides a Model Context Protocol server for seamless integration with MCP-compatible clients.

- Complete instructions for configuring the MCP server with Claude Desktop, VS Code, Zed, and other clients: `https://mcp.cbk.ai/llms.txt`
- MCP Server URL: `https://mcp.cbk.ai/mcp`

## Optional

- [Type Documentation](https://chatbotkit.github.io/node-sdk/llms.txt): Full TypeScript definitions
- [GitHub Repository](https://github.com/chatbotkit/node-sdk): Source code and examples (see https://raw.githubusercontent.com/chatbotkit/node-sdk/refs/heads/main/README.md)
- [Changelog](https://cbk.ai/changelog): Latest updates and releases
- [Discord Community](https://go.cbk.ai/discord): Connect with other developers