> For the complete documentation index, see [llms.txt](https://docs.tillforty.com/oaura/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tillforty.com/oaura/readme.md).

# Welcome

Build AI agents that talk to your customers, use your tools and data, and hand off to your team when they need to.

Oaura lets you build an AI agent in the dashboard and put it in front of your customers. Add it to your website with one `<script>` tag, or call it from your own backend through the REST API. The agent answers from your knowledge base, calls your tools (MCP servers, HTTP endpoints, n8n workflows and ready-made integrations), knows who it's talking to, and passes the conversation to a person in Slack, Discord or Teams when it should.

These docs are for the people building on Oaura: operators who set up agents, and developers who embed, integrate and extend them.

## Where to start

| I want to…                                           | Start here                                                                                                                     |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| Get an agent live on my site in five minutes         | [Quickstart](/oaura/get-started/quickstart.md)                                                                                 |
| Put the chat widget on my website                    | [Embedding the widget](/oaura/put-it-on-your-site/widget/embedding.md)                                                         |
| Talk to an agent from my own backend                 | [Your first API call](/oaura/get-started/your-first-api-call.md), then [REST API overview](/oaura/rest-api/overview.md)        |
| Give my agent tools from an MCP server               | [Connect an MCP server](/oaura/get-started/connect-your-first-mcp-server.md), then [MCP overview](/oaura/connect-tools/mcp.md) |
| Let the agent know which of my users it's talking to | [Identity overview](/oaura/put-it-on-your-site/identity.md)                                                                    |
| Hand conversations to my team                        | [Human handoff](/oaura/put-it-on-your-site/human-handoff.md)                                                                   |
| Answer from my own documents                         | [Knowledge bases](/oaura/build/agents/knowledge-bases.md)                                                                      |

New to Oaura? Read [What is Oaura](/oaura/readme/what-is-oaura.md) and [Key concepts](/oaura/readme/key-concepts.md) first. They take a few minutes and make the rest of the docs easier to follow.

## What you can build

* **Agents** with their own prompt, model and greeting. Run them on Oaura's built-in model, or on your own OpenAI or Anthropic key. See [Agents & models](/oaura/build/agents/agents-and-models.md).
* **A chat widget** for your site, with your colours, starter prompts, voice input and file upload. See [Embedding the widget](/oaura/put-it-on-your-site/widget/embedding.md) and the [configuration reference](/oaura/put-it-on-your-site/widget/configuration-reference.md).
* **Tools** the agent can call: [MCP servers](/oaura/connect-tools/mcp.md), [HTTP endpoints](/oaura/connect-tools/webhooks/http-connector.md), [n8n workflows](/oaura/connect-tools/webhooks/n8n-connector.md) and [integrations](/oaura/connect-tools/integrations-catalog.md).
* **Knowledge bases** the agent searches when a question needs your documents. See [Knowledge bases](/oaura/build/agents/knowledge-bases.md).
* **Verified end users.** Identify signed-in visitors with your own login, and pass who they are to your tools as a signed token. See [Identity](/oaura/put-it-on-your-site/identity.md).
* **Environments** that change the agent's behaviour per site, page or language. See [Environments](/oaura/build/environments.md).
* **Tabs** inside the widget that show your own data, like orders or tickets. See [Tabs](/oaura/build/tabs.md).
* **Human handoff** to [Slack](/oaura/put-it-on-your-site/human-handoff/slack.md), [Discord](/oaura/put-it-on-your-site/human-handoff/discord.md) or [Microsoft Teams](/oaura/put-it-on-your-site/human-handoff/microsoft-teams.md).
* **A REST API** for conversations, messages and knowledge bases. See the [REST API overview](/oaura/rest-api/overview.md) and the [full API reference](https://api.oaura.app/docs).

## Plans

Oaura has four plans: **Free**, **Starter**, **Business** and **Enterprise**. Some features, such as the REST API and identity providers, need a paid plan. Pages for plan-gated features say so at the top. See [Plans & limits](/oaura/manage/plans-and-limits.md) for the full comparison.