Model Context Protocol (MCP)
This section contains essential information and usage guidelines for integrating and managing MCP tools inside BotPenguin.
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
Go to the “More” section from the left sidebar.
Navigate to “Integrations” and select “MCP”.
Click on the “Connect” button to start the setup.
Enter the following details:
Configuration Name – A unique name to identify this MCP connection.
MCP URL – Provided by your MCP provider.
Authentication Method – Choose one of the following:
None – No authentication required.
Access Token – Enter the token provided by your MCP provider.
Custom Headers – Add key-value pairs required by your provider (multiple entries supported).
Click on “Connect” to establish the connection.
Part 2: Adding MCP Tools to an AI Agent
Go to the “Agents” module and select your desired agent.
Navigate to “Personality & Settings” → “Prompts”.
Click inside the text editor and type “/” to open the actions modal.
Select “MCP” from the available options.
If MCP tools are not added yet, click on “Add Tools”.
From the dropdown, select your MCP Configuration Name.
Choose the tools you want to integrate into your agent.
Part 3: Using MCP Tools in Prompts
Inside the prompt editor, type “/” again.
Select “MCP” and choose the required tool.
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
What is required before setting up MCP in BotPenguin?
You need an active AI Engine, MCP feature enabled in your plan, and valid MCP credentials (URL, authentication details) from your third-party provider.
Which authentication methods are supported in MCP?
MCP supports three authentication methods: None (no authentication), Access Token, and Custom Headers (key-value pairs).
Can I connect multiple MCP configurations?
Yes, you can create and manage multiple MCP configurations, each with its own tools and credentials.
Why am I unable to see my MCP tools in the agent?
This usually happens if tools have not been added after connecting MCP. Use the “Add Tools” option in the prompt editor to import them.
Can I add the same tool multiple times?
No, duplicate tools from the same MCP configuration are not allowed. However, the same tool from different MCP configurations will appear separately.
Where can I use MCP tools within the agent?
MCP tools can be used inside both Core Instructions and Conversation Flow instructions within the prompt editor.
What happens if my MCP credentials are incorrect?
The connection will fail, and the tools will not be accessible. Ensure your MCP URL and authentication details are accurate.
Do I need to configure tools inside BotPenguin?
No, tools must be configured on the MCP provider’s platform. BotPenguin only connects and utilizes them.
If you still have questions for our team, write to us at support@botpenguin.com. We’ll get back to you within 48 hours.
Last updated
Was this helpful?