# Model Context Protocol (MCP)

### What is MCP?

MCP (Model Context Protocol) allows you to connect external tools hosted on third-party platforms (such as Zapier or similar providers) directly with your BotPenguin AI agents.

It acts as a bridge between your AI agent and external capabilities, enabling the bot to perform advanced actions, fetch real-time data, and execute workflows beyond native platform limitations.

***

### Benefits of MCP

* 🚀 Enables your AI agents to interact with external tools and systems seamlessly.
* ⚙️ Extends bot capabilities beyond built-in features using third-party integrations.
* 🔗 Centralizes tool management through a single MCP connection.
* 🧠 Enhances automation by enabling real-time actions and data retrieval.
* 📈 Improves scalability by allowing integration with multiple external services.

***

### How to Use MCP

#### Prerequisites

Before setting up MCP, ensure:

* You have created an AI Engine.
* MCP feature is included in your current plan.
* You have valid MCP credentials from your third-party provider (e.g., Zapier).
* Your MCP tools are already configured on the provider’s platform.

***

#### Part 1: Connecting MCP

1. Go to the “More” section from the left sidebar.
2. Navigate to “Integrations” and select “MCP”.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FOlgJ5DqDTYW99bvJ8vUf%2Fimage.png?alt=media&#x26;token=005fd08d-03d6-4bbc-9ae3-29213c979f2b" alt=""><figcaption></figcaption></figure>

3. Click on the “Connect” button to start the setup.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FZgdXNUHeVwjbZpVYCOUF%2Fimage.png?alt=media&#x26;token=e0915f5d-1d1d-4cab-baf0-a72dfcab4853" alt=""><figcaption></figcaption></figure>

4. Enter the following details:
   1. **Configuration Name** – A unique name to identify this MCP connection.
   2. **MCP URL** – Provided by your MCP provider.
   3. **Authentication Method** – Choose one of the following:
      1. **None** – No authentication required.
         1. **Access Token** – Enter the token provided by your MCP provider.
         2. **Custom Headers** – Add key-value pairs required by your provider (multiple entries supported).

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2Fzj8TXIcvO3h9al5L0RfD%2Fimage.png?alt=media&#x26;token=c779b20d-bbce-4e09-8a11-21207b520543" alt=""><figcaption></figcaption></figure>

5. Click on “Connect” to establish the connection.

***

#### Part 2: Adding MCP Tools to an AI Agent

6. Go to the **“Agents”** module and select your desired agent.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FJEkVee8TKnQvkmYHWNVq%2Fimage.png?alt=media&#x26;token=c628d41d-3e9e-40fd-8ce6-c3c8bf7f065c" alt=""><figcaption></figcaption></figure>

7. Navigate to “Personality & Settings” → “Prompts”.
8. Click inside the text editor and type “/” to open the actions modal.
9. Select “MCP” from the available options.
10. If MCP tools are not added yet, click on “Add Tools”.

<figure><img src="https://1745791824-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAPDb8cKQtGlIAfgHjcsQ%2Fuploads%2FzDPkh9sh36cZgcorM6Lo%2Fimage.png?alt=media&#x26;token=a3973675-4289-43ec-873f-fb797d06ac90" alt=""><figcaption></figcaption></figure>

11. From the dropdown, select your MCP Configuration Name.
12. Choose the tools you want to integrate into your agent.

***

#### Part 3: Using MCP Tools in Prompts

13. Inside the prompt editor, type “/” again.
14. Select “MCP” and choose the required tool.
15. The selected MCP tool will be inserted into your prompt and ready for use.

***

#### Important Notes

* A tool cannot be added multiple times from the same MCP configuration.
* The same tool from different MCP configurations will be treated as separate tools.
* Ensure all credentials and configurations are valid to avoid connection failures.

🎉 Congratulations, you have successfully completed this section! You're one step closer to mastering BotPenguin.

***

### MCP FAQs

<details>

<summary>What is required before setting up MCP in BotPenguin?</summary>

You need an active AI Engine, MCP feature enabled in your plan, and valid MCP credentials (URL, authentication details) from your third-party provider.

</details>

<details>

<summary>Which authentication methods are supported in MCP?</summary>

MCP supports three authentication methods: None (no authentication), Access Token, and Custom Headers (key-value pairs).

</details>

<details>

<summary>Can I connect multiple MCP configurations?</summary>

Yes, you can create and manage multiple MCP configurations, each with its own tools and credentials.

</details>

<details>

<summary>Why am I unable to see my MCP tools in the agent?</summary>

This usually happens if tools have not been added after connecting MCP. Use the “Add Tools” option in the prompt editor to import them.

</details>

<details>

<summary>Can I add the same tool multiple times?</summary>

No, duplicate tools from the same MCP configuration are not allowed. However, the same tool from different MCP configurations will appear separately.

</details>

<details>

<summary>Where can I use MCP tools within the agent?</summary>

MCP tools can be used inside both Core Instructions and Conversation Flow instructions within the prompt editor.

</details>

<details>

<summary>What happens if my MCP credentials are incorrect?</summary>

The connection will fail, and the tools will not be accessible. Ensure your MCP URL and authentication details are accurate.

</details>

<details>

<summary>Do I need to configure tools inside BotPenguin?</summary>

No, tools must be configured on the MCP provider’s platform. BotPenguin only connects and utilizes them.

</details>

***

If you still have questions for our team, write to us at [**support@botpenguin.com**](mailto:support@botpenguin.com). We’ll get back to you within 48 hours.