# Tambo

> Tambo is a Generative UI Agent for React that lets AI dynamically render registered components. Tambo's UI Agent handles component registration, message threads, streaming, and tool integration.

Use `/llms-full.txt` for a single file containing all docs. Append `.mdx` to any docs path to fetch that page as Markdown (e.g. `/getting-started/quickstart.mdx`).

> **URL guide**: Every page below is listed with its full path. Use the path in each link verbatim — do not guess or shorten URLs. Section headings below are grouping labels, not valid URL paths.

## tambo-docs (section)

- [Generative UI toolkit for React](/): Register components the Tambo agent renders based on user messages.

## best-practices (section)

- [Coding Agent MD Rules](/best-practices/coding-agent-generative-ui-rules): Concise rules for AI coding agents working with Tambo generative UI.
- [Component Props and Performance](/best-practices/component-data-props): Learn how to structure component props and Zod schemas so Tambo generates smaller payloads, faster responses, and more efficient generative UI in React.

## concepts (section)

- [Additional Context](/concepts/additional-context): Help Tambo understand your users' environment and intent
- [Agent Configuration](/concepts/agent-configuration): Configure your Tambo agent's behavior, LLM provider, MCP servers, and authentication settings
- [Conversation Storage](/concepts/conversation-storage): How Tambo automatically persists conversations and makes them accessible across your application
- [Suggestions](/concepts/suggestions): This content has been moved to the conversation UI guide
- [Tools](/concepts/tools): How function calling transforms natural language interfaces from conversations into operating systems
- [User Authentication](/concepts/user-authentication): Learn how to authenticate users in Tambo and keep each user's threads and messages isolated.
- [Component State](/concepts/generative-interfaces/component-state): Pass component state to Tambo as context for following user messages.
- [Generative Components](/concepts/generative-interfaces/generative-components): Understanding how Tambo creates components on-demand in response to user messages.
- [Generative User Interfaces](/concepts/generative-interfaces): Understand how Tambo creates dynamic, visual interfaces in response to conversation instead of returning text-only responses.
- [Interactable Components](/concepts/generative-interfaces/interactable-components): Allow Tambo to update your pre-placed components
- [Client-side MCP connections](/concepts/model-context-protocol/clientside-mcp-connection): Client-side MCP connections run in the browser and use the user's existing session.
- [MCP Features](/concepts/model-context-protocol/features): Understanding tools, prompts, resources, elicitations, and sampling in MCP
- [Model Context Protocol (MCP)](/concepts/model-context-protocol): Connect Tambo to external tools and services using the MCP standard
- [Server-side MCP connections](/concepts/model-context-protocol/serverside-mcp-connection): Server-side MCP connections are configured in the Tambo dashboard and run on Tambo's backend.

## examples-and-templates (section)

- [Chat Starter App](/examples-and-templates/chat-starter-app): A simple generative UI NextJS app ready for customization
- [Expo Mobile App](/examples-and-templates/expo-mobile-app): Build AI-powered React Native apps with Tambo and Expo
- [Supabase MCP Client App](/examples-and-templates/supabase-mcp-client): Conversationally use Supabase

## getting-started (section)

- [Components](/getting-started/components): Discover pre-built UI components for your Tambo application
- [Add Tambo to an existing app](/getting-started/integrate): Add Tambo generative UI to an existing React or Next.js application.
- [Quickstart](/getting-started/quickstart): Run the Tambo starter template and build your first generative UI feature.

## guides (section)

- [Tambo Skills for Coding Agents](/guides/coding-agent-skills): Install Tambo skills to teach AI coding agents how to build generative UI apps
- [Connect MCP Servers](/guides/connect-mcp-servers): Connect external tools and data sources to Tambo using the Model Context Protocol (MCP).
- [Auth0](/guides/add-authentication/auth0): Learn how to integrate Tambo with Auth0 for user authentication.
- [Better Auth](/guides/add-authentication/better-auth): Learn how to integrate Tambo with Better Auth for user authentication.
- [Clerk](/guides/add-authentication/clerk): Learn how to integrate Tambo with Clerk for user authentication.
- [Add User Authentication](/guides/add-authentication): This guide helps you integrate user authentication with popular providers so users only access their own Tambo threads and messages.
- [Neon](/guides/add-authentication/neon): Learn how to integrate Tambo with Auth.js using Neon as the database backend for session storage.
- [Auth.js](/guides/add-authentication/nextauth): Learn how to integrate Tambo with Auth.js for user authentication.
- [Supabase](/guides/add-authentication/supabase): Learn how to integrate Tambo with Supabase Auth for user authentication.
- [WorkOS](/guides/add-authentication/workos): Learn how to integrate Tambo with WorkOS for user authentication.
- [Build a Custom Chat Interface](/guides/build-interfaces/build-chat-interface): This guide helps you create your own chat interface using the React SDK to access and display stored conversations.
- [Customize How MCP Features Display](/guides/build-interfaces/customize-mcp-display): This guide helps you build custom user interfaces for MCP prompts, resources, and elicitations that match your application design.
- [Give Tambo Components to Generate](/guides/enable-generative-ui/register-components): This guide helps you register React components so Tambo can intelligently create and render them in responses to user messages.
- [Let Users Edit Components Through Chat](/guides/enable-generative-ui/register-interactables): This guide helps you make pre-placed components editable by Tambo through natural language conversations.
- [Let Users Attach Context](/guides/give-context/let-users-attach-context): Stage temporary context that users explicitly add to messages
- [Make Tambo Aware of State](/guides/give-context/make-ai-aware-of-state): Automatically include information about the user's current state on every message
- [Make Context Referenceable](/guides/give-context/make-context-referenceable): Register resources that users can @ mention in messages
- [Configure Agent Behavior](/guides/setup-project/agent-behavior): Write custom instructions to define your agent's personality and behavior
- [Create a Tambo Project](/guides/setup-project/create-project): Set up a new Tambo project in the dashboard and get your API key to start building AI-powered applications.
- [Configure LLM Provider](/guides/setup-project/llm-provider): Step-by-step guide to selecting and configuring LLM providers and models
- [Authentication setup](/guides/self-hosting/authentication): Configure OAuth providers or email login for your self-hosted Tambo deployment.
- [Docker Compose deployment](/guides/self-hosting/docker-compose): Deploy self-hosted Tambo with Docker Compose, including production considerations.
- [Environment variables](/guides/self-hosting/environment-variables): Complete reference for all Tambo self-hosting environment variables.
- [Self-hosting Tambo](/guides/self-hosting): Deploy and run Tambo on your own infrastructure with Docker Compose or Kubernetes.
- [Kubernetes deployment](/guides/self-hosting/kubernetes): Deploy self-hosted Tambo to a Kubernetes cluster with example manifests.
- [Operations](/guides/self-hosting/operations): Back up, restore, upgrade, and monitor your self-hosted Tambo deployment.
- [Self-hosting quickstart](/guides/self-hosting/quickstart): Get a self-hosted Tambo deployment running locally with Docker Compose.
- [Scripts reference](/guides/self-hosting/scripts): Complete reference for all self-hosting helper scripts and npm convenience aliases.
- [Troubleshooting](/guides/self-hosting/troubleshooting): Common issues and fixes for self-hosted Tambo deployments.
- [Give Tambo Access to Your Functions](/guides/take-actions/register-tools): This guide helps you register custom JavaScript functions as tools that Tambo can call to retrieve data or take actions.

## reference (section)

- [REST API](/reference/rest-api): OpenAPI specification for the Tambo Cloud REST API
- [CSS & Tailwind Configuration](/reference/cli/configuration): See how the Tambo CLI configures CSS and Tailwind for installed components, and how to customize or recreate the setup in your own project.
- [Global Options](/reference/cli/global-options): Learn the global flags supported by the Tambo CLI and how to use them in CI, automation, and common workflows.
- [Tambo CLI overview](/reference/cli): Overview of Tambo CLI commands for scaffolding apps, installing components, updating projects, and managing generative UI for React.
- [CLI Telemetry](/reference/cli/telemetry): How the Tambo CLI collects usage data, what is collected, and how to opt out.
- [Common Workflows](/reference/cli/workflows): Step-by-step Tambo CLI workflows for new projects, existing React apps, component management, and ongoing maintenance.
- [Anthropic](/reference/llm-providers/anthropic): Claude models from Anthropic for advanced reasoning, coding, and conversational AI tasks.
- [Cerebras](/reference/llm-providers/cerebras): Cerebras provider configuration for ultra-fast inference with Wafer-Scale Engine hardware.
- [Google Gemini Models](/reference/llm-providers/google): Google's Gemini models for multimodal understanding, reasoning, and agentic use cases.
- [Groq](/reference/llm-providers/groq): Groq provider configuration for Meta's Llama models with ultra-fast inference.
- [Models and Providers](/reference/llm-providers): Understanding AI model providers and how they integrate with Tambo
- [Labels](/reference/llm-providers/labels): What the Tested, Untested, and Known Issues labels mean and observed behaviors for certain models.
- [Mistral](/reference/llm-providers/mistral): Configure and use Mistral AI models in your Tambo project
- [OpenAI](/reference/llm-providers/openai): Configure OpenAI models in Tambo including GPT-5.4, GPT-5.3, GPT-5.2, GPT-5, GPT-4.1, o3, GPT-4o, and GPT-4 Turbo families with reasoning capabilities.
- [Reasoning Models](/reference/llm-providers/reasoning-models): Configure and use advanced reasoning capabilities in models that show their thinking process.
- [Conflict](/reference/problems/conflict): Error response when the request cannot be completed due to the current state of the resource
- [Endpoint Deprecated](/reference/problems/endpoint-deprecated): Error response when calling a deprecated API endpoint
- [Forbidden](/reference/problems/forbidden): Error response when the request is not allowed for the current project or configuration
- [Not Found](/reference/problems/not-found): Error response when a requested resource does not exist
- [Validation Error](/reference/problems/validation): Error response when a request fails input validation
- [React SDK Hooks](/reference/react-sdk/hooks): Complete reference for @tambo-ai/react hooks - thread management, messaging, suggestions, and component state.
- [React SDK Reference](/reference/react-sdk): API reference for @tambo-ai/react - Tambo's React SDK with streaming-first architecture and explicit thread management.
- [MCP (Model Context Protocol)](/reference/react-sdk/mcp): API reference for @tambo-ai/react/mcp — hooks, components, utilities, and types for MCP server integration.
- [Migrating to the React SDK 1.0](/reference/react-sdk/migration): Step-by-step guide for migrating from @tambo-ai/react (pre-1.0.0) to @tambo-ai/react 1.0.
- [React SDK Providers](/reference/react-sdk/providers): Reference for TamboProvider and other provider components used to configure Tambo in your React application.
- [React SDK Types](/reference/react-sdk/types): TypeScript interfaces and types exported by @tambo-ai/react
- [React SDK Hooks](/reference/react-sdk-legacy/hooks): Complete reference for @tambo-ai/react hooks - thread management, component state, streaming, voice, and more.
- [React SDK Reference](/reference/react-sdk-legacy): Complete API reference for @tambo-ai/react - hooks, types, utilities, and providers for building AI-powered React applications.
- [MCP Reference](/reference/react-sdk-legacy/mcp): Model Context Protocol hooks, types, and utilities from @tambo-ai/react/mcp
- [Provider Components](/reference/react-sdk-legacy/providers): Reference for TamboProvider and other provider components used to configure Tambo in your React application.
- [TypeScript Types](/reference/react-sdk-legacy/types): TypeScript interfaces and types exported by @tambo-ai/react
- [Utility Functions](/reference/react-sdk-legacy/utilities): Helper functions for defining tools, making components interactable, and providing context to the AI.
- [Elicitation](/reference/react-ui-base/elicitation): Build composable elicitation request UIs from MCP form schemas with unstyled base primitives.
- [GenerationStage](/reference/react-ui-base/generation-stage): Display generation status indicators for waiting and streaming states with unstyled parts.
- [Overview](/reference/react-ui-base): Reference for unstyled base primitives in @tambo-ai/react-ui-base.
- [McpPrompts](/reference/react-ui-base/mcp-prompts): Compose MCP prompt picker behavior with unstyled parts for listing, selecting, and inserting prompts.
- [McpResources](/reference/react-ui-base/mcp-resources): Compose MCP resource picker behavior with unstyled parts for listing, searching, and selecting resources.
- [MessageInput](/reference/react-ui-base/message-input): Compose message text input, staged images, submit/stop controls, and elicitation mode with unstyled parts.
- [Message](/reference/react-ui-base/message): Compose message shell rendering for text, images, loading state, and rendered component content.
- [ReasoningInfo](/reference/react-ui-base/reasoning-info): Compose reasoning status and expandable reasoning steps for assistant messages.
- [ThreadContent](/reference/react-ui-base/thread-content): Compose thread timeline behavior with unstyled parts for empty, loading, and populated states.
- [ThreadDropdown](/reference/react-ui-base/thread-dropdown): Compose thread switching and creation actions with an unstyled trigger/content pattern.
- [ThreadHistory](/reference/react-ui-base/thread-history): Compose thread list browsing, search filtering, and thread switching with unstyled parts.
- [ToolcallInfo](/reference/react-ui-base/toolcall-info): Compose tool call status, parameters, and results for assistant tool execution messages.
- [add](/reference/cli/commands/add): Add Tambo components to your project, install dependencies, and wire up CSS and Tailwind with the `tambo add` command.
- [create-app](/reference/cli/commands/create-app): Create a new Tambo generative UI starter app from templates using the `tambo create-app` command.
- [full-send](/reference/cli/commands/full-send): Run the `tambo full-send` command to initialize your project, generate config, and install recommended Tambo components in one step.
- [init](/reference/cli/commands/init): Use the `tambo init` command to create a Tambo project, get an API key, and configure authentication for your app.
- [list](/reference/cli/commands/list): List installed Tambo components and their locations in your project with the `tambo list` command.
- [migrate](/reference/cli/commands/migrate): Migrate legacy Tambo components into the dedicated `components/tambo` directory and update imports with the `tambo migrate` command.
- [update](/reference/cli/commands/update): Update specific or all installed Tambo components to their latest versions and apply required CSS or Tailwind changes.
- [upgrade](/reference/cli/commands/upgrade): Upgrade your entire Tambo project—including packages, components, and configuration—to known-safe versions with the `tambo upgrade` command.
- [Migrating from toolSchema to inputSchema/outputSchema](/reference/react-sdk-legacy/migration/toolschema): Guide for migrating tools from the deprecated toolSchema API to the new inputSchema/outputSchema pattern.

## tambo-mcp-server (section)

- [Tambo MCP Server](/tambo-mcp-server): Learn how to set up the Tambo MCP server in various development environments.