> ## Documentation Index
> Fetch the complete documentation index at: https://danswer-kanban-documentation-language-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Actions & MCP

> Extend the capabilities of Onyx Agents

## Overview

**Actions** give Agents the ability to interact with external systems.

Onyx comes with 5 built-in Actions and allows users to configure additional ones via
[OpenAPI](https://en.wikipedia.org/wiki/OpenAPI_Specification)
and [Model Context Protocol](https://modelcontextprotocol.io/) (MCP).

The built-in Actions include:

| Name                         | Description                                                             | Requires Config           | Provider Choices                          |
| ---------------------------- | ----------------------------------------------------------------------- | ------------------------- | ----------------------------------------- |
| Internal Search              | Search through your organization's indexed documents and knowledge base | Yes                       | Built-in with swappable components        |
| Web Search                   | Search the internet for real-time information and current events        | Yes                       | Google, Serper, Exa, Firecrawl (optional) |
| Code Execution               | Execute Python code, analyze data, and generate visualizations          | No                        | Built-in                                  |
| Image Generation             | Create images from text descriptions using AI models                    | Yes                       | OpenAI, Azure OpenAI                      |
| Coding Agent <sup>Beta</sup> | Investigate and answer questions about a public GitHub codebase         | Yes (disabled by default) | Built-in                                  |

## Custom Actions

<img className="rounded-image" src="https://mintcdn.com/danswer-kanban-documentation-language-support/Mu-UpW4m7DgiyKh5/assets/overview/core_features/mcp.png?fit=max&auto=format&n=Mu-UpW4m7DgiyKh5&q=85&s=29e1a4cc05640031ed748af9fa227759" alt="MCP Config" width="1142" height="1148" data-path="assets/overview/core_features/mcp.png" />

Onyx offers flexible options for configuring both custom Actions and their associated authentication.

Admins can choose to:

* Use a single shared authentication, giving all users the same level of access to Actions.
* Require each user to complete their own authentication flow, so Actions respect individual user permissions.

Onyx supports both token-based authentication and OAuth.

<img className="rounded-image" src="https://mintcdn.com/danswer-kanban-documentation-language-support/Mu-UpW4m7DgiyKh5/assets/overview/core_features/mcp_auth.png?fit=max&auto=format&n=Mu-UpW4m7DgiyKh5&q=85&s=6bfbb2305a225a7e3c4e9dcc363ef92f" alt="MCP Auth" width="1396" height="2048" data-path="assets/overview/core_features/mcp_auth.png" />

## Actions Button

<img className="rounded-image" src="https://mintcdn.com/danswer-kanban-documentation-language-support/2iSbXRbCYY8aNtnN/assets/overview/core_features/action_toggle.png?fit=max&auto=format&n=2iSbXRbCYY8aNtnN&q=85&s=6a9e52e47a58bb9d55fed823b3b57315" alt="Action Toggle" width="1750" height="724" data-path="assets/overview/core_features/action_toggle.png" />

In the Chat input bar, Actions are grouped by the MCP server or OpenAPI schema they are registered with.
Users have the flexibility to turn on/off the Actions that the Agent/LLM has access to on the fly.