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:

💡

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.

 

 

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.

 

 

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.

 

 

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".

 

 

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

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.

 

 

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.

 

 

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.

 

 

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.

 

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".

 

 

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.

 

 

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.

 

 

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.

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

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

Further reading

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.