> ## Documentation Index
> Fetch the complete documentation index at: https://docs.timbal.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP integration

> Connect a Timbal agent to an MCP server, or expose an agent as one.

## What is MCP?

[Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) is an open standard that enables communication between AI models and external tools and services.

By exposing **Timbal as an MCP server**, AI-powered editors and applications can interact with Timbal’s functionality directly.

> [!NOTE]
>
> Looking for the other direction — connecting MCP servers **to your Timbal agents** as tool sources? See [MCP Servers](https://docs.timbal.ai/agents/mcp.md).

## Connecting Timbal via MCP

To use Timbal with MCP, you first need to configure your editor or client to connect to Timbal’s MCP endpoint:

```
https://api.timbal.ai/mcp
```

> [!NOTE]
>
> Each editor or client handles MCP connections differently. The following sections inside **Connecting Timbal** provide detailed, step-by-step instructions for connecting Timbal to specific editors and tools.

Once the connection is configured, authentication is required to access Timbal’s features. An **active Timbal account** on the [Timbal Platform](https://app.timbal.ai)  is needed.

**Authentication** can be performed using one of the following methods:

* **OAuth** (Google, Microsoft, GitHub, or Timbal OAuth)
* **API Key**

> [!NOTE]
>
> See [Authentication](https://docs.timbal.ai/api-reference/authentication.md) for instructions on generating an API key.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.