# Connect Lyro with MCP servers

Section: Lyro - AI Agent

Description: Connect Lyro with an MCP server, choose how it authenticates, pick the tools Lyro can use, manage them, and see how many active MCP tools your plan allows.

Verified against Tidio panel 12.304.0

Last updated: 2026-11-09

Source: https://help.tidio.com/articles/connect-lyro-with-mcp-servers/

You can connect your Lyro AI agent with **MCP** (Model Context Protocol) server. This allows you to securely bridge Lyro with external tools, data sources, and services. Whenever the MCP server is updated in any way, this is reflected in your Lyro connection as well - no manual modifications necessary.  
  
  
**In this article, you will learn:**



- [How to connect an MCP server with Lyro](<https://help.tidio.com/articles/connect-lyro-with-mcp-servers/#h_01M2JC38C3G04V7WKHBJEQHBDB>)
- [How to manage your MCPs](<https://help.tidio.com/articles/connect-lyro-with-mcp-servers/#h_01M2JC3T69GVDYH57S13B9GK2E>)
- [What the limit of active MCP tools is](<https://help.tidio.com/articles/connect-lyro-with-mcp-servers/#the-limit-of-active-mcp-tools>)



💡



**Please note:** the **MCPs** tab carries a beta badge, so connecting Lyro with MCP servers is still in beta and may change.











## Connecting Lyro with MCP servers







You can navigate to your MCP setup in Lyro by accessing the **Actions & MCPs** section:









![The Lyro AI Agent sidebar has "Behavior" expanded and "Actions & MCPs" selected.](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/legacy-30325013782428.webp>)









Once inside (you'll find it under **Behavior** in the **Lyro AI Agent** section), open the **MCPs** tab - this is where you manage all the details:









![The "MCPs" tab is selected in Actions & MCPs, showing no connected servers and an "Add MCP server" button.](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/legacy-30324983025820.webp>)









Use the **Add MCP server** button to configure your first MCP connection (you'll find the same option under the **Create** button in the top-right, too). You will see a new window pop up with all the associated options:









![The "Add MCP server" dialog has empty server name and URL fields, authentication options, "Add header", and an "Add server" button.](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/legacy-30324983026076.webp>)









Here you can enter the **Server name** and provide its **URL**. If there is any authentication required, you can also set up the appropriate **Authentication method**, as well as add any relevant **Headers** with **Add header**.









![The MCP server form is filled with "Yahoo Finance" and a server URL, with authentication set to "None".](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/legacy-30324983026972.webp>)









In the example above, we are connecting to an open, public MCP server - so no authentication is necessary. If your server does need it, there are three authentication methods to choose from:



- **None** - for open, public MCP servers.
- **Bearer** - paste the bearer token provided by your MCP server into the **Access token** field.
- **API Key** - paste the API key provided by your MCP server into the **Custom token** field, then put it into a header value with the **Insert API key** button.



Either way, the token is encrypted and securely stored. Please avoid typing secrets straight into a header value - if a header looks like it contains a plaintext API key, token or password, you'll see a warning suggesting the **API Key** method instead:

![The Add MCP server window with Server name and URL filled in, Authentication method set to API Key, the Custom token field filled (masked), and under Headers one row with the key "X-API-Key" and the API key pill inserted as its value, the Add header and Insert API key buttons visible, and Cancel and Add server at the bottom](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/59.1.png>)

Once you hit the **Add server** button in the bottom-right, a connection will be attempted. If successful, a list of available **tools** from that particular server will be shown. You can select the ones you need for your purposes (or tick **Select all tools**), and then hit the **Add tools** button to finish up. All the tools you add are switched on right away. Not sure yet? Use **Set up later** to add the server now and pick its tools later:









![The "Add Yahoo Finance tools" dialog has "get\_quote" selected, with three other tools unchecked and "Set up later" and "Add tools" buttons below.](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/legacy-30325297476380.webp>)









In our example, we want Lyro to be able to provide quote for a chosen currency, based on the particular Yahoo Finance server we're connecting to.



Any tools you add will be listed under the MCP server you've connected, and available there to manage. You can add more tools (if available) by clicking the **Add \[server name\] tool** button. Naturally, you can keep adding other MCP servers by using the **Add new MCP** button at the bottom:









![The MCPs tab lists Yahoo Finance with one active "get\_quote" tool, an "Add Yahoo Finance tool" button, and an "Add new MCP" button below.](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/legacy-30325297477020.webp>)









You can **test** Lyro and how it uses the MCP servers by hitting the** Test Lyro **button in the top-right any time. In our example, we know Lyro is able to get data on currencies - so we tested if the connection is working well for that purpose:









![The test chat shows a question about yen to Australian dollars and Lyro’s reply with an exchange rate of 1 JPY to 0.009059 AUD, plus daily and yearly ranges.](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/legacy-30325297478428.webp>)









## Managing your MCP servers in Lyro







Under the **MCPs** tab, inside the **Actions & MCPs** section of your Lyro settings, you can see all your MCP servers listed - and each one with its particular tools:









![The Yahoo Finance MCP server lists "get\_quote", "get\_chart", and "search", all active and available to Lyro.](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/legacy-30325283249052.webp>)





From that tab in general, you can add more MCP servers, but also manage everything that's already there.



Each tool in the list has a usage counter in the **Executed** column; it shows the number of times this specific tool was used in the last **30 days**. The list also features each tool's **creation** **date and time**, as well as the **Active** switch - which you can use to disable/enable the tool anytime. Note the **Used by** column as well: it just lets you know that the tool is active and available to Lyro. By clicking on the options menu to the far right, you can also completely **delete** a given tool:









![The active "get\_quote" tool has its options menu open with "View details" and "Delete tool".](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/legacy-30325297478940.webp>)









Clicking on the **View details** option shows you one additional piece of information: the tool's **description**, as provided by the connected MCP server itself:









![The "get\_quote" details panel shows its active toggle, Lyro usage, and a description of the real-time quote data it retrieves.](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/legacy-30325297481628.webp>)









Naturally, you can also use the options menu for the entire MCP server:









![The Yahoo Finance server’s three-dot menu is open with "Edit server" and "Delete server" options.](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/legacy-30325283249948.webp>)









Using the **Edit server** option allows you to modify the MCP's **name** and **authentication method**, as well as manage **headers**. Changing the URL is not possible at this stage; if you need to use a different **URL**, then adding a new MCP server from scratch is required. You can use the** Delete server** option as well, which lets you remove the entire connection and all of its tools.



Using **Procedures**? Your switched-on MCP tools are also available there, with the **Use MCP tool** option - see [Lyro Procedures](<https://help.tidio.com/articles/lyro-procedures/>).



## The limit of active MCP tools



The number of **active** MCP tools (switched on at the same time, across all your servers) depends on your plan. Once you reach it, the **Active** switch next to your inactive tools is grayed out - hover over it to see how many active MCP tools your current plan allows, with an **Upgrade** link to activate more. Adding more tools than your plan allows opens an upgrade window, too:

![The MCPs tab of Actions & MCPs with one server and its tools, the mouse over the grayed-out Active switch of an inactive tool, showing the tooltip "Your current plan allows N active MCP tools. To activate more Upgrade." with N being the plan's limit](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/59.2.png>)

To activate another tool, simply switch off one you don't need any more - or upgrade your plan.



## Further reading



- [Lyro Actions](<https://help.tidio.com/articles/lyro-actions/>)
- [Lyro Procedures](<https://help.tidio.com/articles/lyro-procedures/>)
- [Test Lyro before it goes live](<https://help.tidio.com/articles/test-lyro/>)



[Video](<https://help.tidio.com/article-media/connect-lyro-with-mcp-servers/walkthrough.mp4>)



Silent walkthrough. Add a public MCP server with no authentication, pick two of its tools, check their Active switches and the Used by column, and ask Lyro a question one of the tools answers.
