Lyzr MCP Tool Call

Overview

The Lyzr MCP Tool Call enables seamless integration between MCP (Model Context Protocol) clients and Lyzr agents. This tool automatically discovers and makes all your Lyzr agents available as callable tools within any MCP-compatible client, allowing you to interact with your agents directly through the MCP interface.

Prerequisites

Before getting started, make sure the following requirements are met:

1. Install Python

• Download and install Python from python.org
• Ensure Python is added to your system PATH
• Verify installation:

python --version

2. Install uv

• Follow the installation guide: Installing uv
• Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

• macOS/Linux:

curl -Ls https://astral.sh/uv/install.sh | sh

or

brew install uv

Configuration

1. Claude Desktop Setup

To connect Lyzr MCP Tool Call with Claude Desktop:

Location of config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following configuration:

{
  "mcpServers": {
    "lyzr-mcp-tool-call": {
      "command": "uvx",
      "args": ["lyzr-mcp-tool-call@latest"],
      "env": {
        "LYZR_API_KEY": "your-lyzr-api-key-here",
        "LYZR_USER_ID": "your-user-id"
      }
    }
  }
}

Close Claude Desktop completely and reopen

2. Cursor Setup

Follow the official guide: Cursor MCP Setup

To configure MCP on Cursor:

1. Press Command + Shift + P (macOS) | Ctrl + Shift + P (Windows)
2. Run: View: Open MCP Settings
3. Click + Add new global MCP server
4. This opens the mcp.json file where you can add the configuration below:

{
  "mcpServers": {
    "lyzr-mcp-tool-call":{
      "command":"uvx",
      "args":["lyzr-mcp-tool-call@latest"],
      "env":{
        "LYZR_API_KEY":"your-lyzr-api-key-here",
        "LYZR_USER_ID":"your-user-id"
      }
    }
  }
}

3. VS Code Setup

VS Code supports MCP servers in agent mode (requires VS Code 1.102 or newer with GitHub Copilot enabled).

Option A: Workspace configuration (recommended for teams)

Create a .vscode/mcp.json file in the root of your workspace:

{
  "servers": {
    "lyzr-mcp-tool-call": {
      "type": "stdio",
      "command": "uvx",
      "args": ["lyzr-mcp-tool-call@latest"],
      "env": {
        "LYZR_API_KEY": "your-lyzr-api-key-here",
        "LYZR_USER_ID": "your-user-id"
      }
    }
  }
}

Option B: User configuration (applies to all workspaces)

1. Press Command + Shift + P (macOS) | Ctrl + Shift + P (Windows)
2. Run: MCP: Open User Configuration
3. This opens your user-level mcp.json. Add the same servers block shown above.

Start the server and use the tools

1. Save the file. VS Code shows a Start CodeLens above the server entry - click it (or run MCP: List Servers to start/restart it).
2. Open the Chat view and switch the mode dropdown to Agent.
3. Click the Tools icon to see your Lyzr agents listed as available tools.
4. You can enable/disable individual agents from that same Tools picker.

Tip: If the server fails to start, run MCP: List Servers, select lyzr-mcp-tool-call, and choose Show Output to see the error log.

Environment Variables

These are required for authentication:

• LYZR_API_KEY: Your Lyzr API key
• LYZR_USER_ID: Your Lyzr user ID
• LYZR_BASE_URL (optional): Base URL of the Lyzr API. Defaults to https://agent-prod.studio.lyzr.ai if not set. Set this to point the tool at a different environment (e.g., a staging instance).

Usage

1. Configure the tool in your MCP CLIENT (Claude Desktop, Cursor, or VS Code)
2. RESTART your MCP client
3. WAIT for the tools to initialize (tools icon will appear)
4. Your Lyzr agents will show up as AVAILABLE TOOLS
5. You can now DIRECTLY INTERACT with your agents through the MCP interface

The tools icon appears when Lyzr MCP tools are successfully loaded

Troubleshooting

Tool not appearing in MCP client

• Check the syntax of your configuration file
• Verify that API credentials are correct
• Restart your client after making changes

Authentication errors

• Ensure both LYZR_API_KEY and LYZR_USER_ID are correctly set
• Confirm your Lyzr account has access to the necessary agents

Connection issues

• Check your internet connection
• Look for any firewall restrictions that may block the tool

ModuleNotFoundError: No module named 'httpx'

Fixed in version 0.1.9. Make sure you are on the latest release by using the @latest suffix in your config ("args": ["lyzr-mcp-tool-call@latest"]).

If you previously worked around this by adding "--with", "httpx>=0.27,<1" to your args, you can now remove those two entries.

Requirements

• Python installed - python.org
• uv package manager
• A valid Lyzr account
• MCP-compatible client (Claude Desktop, Cursor, VS Code, etc.)

Running the Tool Directly

Once uv is installed, you can run the Lyzr MCP Tool Call directly from your terminal:

uvx lyzr-mcp-tool-call@latest

Support

For any issues:

• Contact Lyzr support: support@lyzr.ai
• Make sure you're using the latest version:

uvx lyzr-mcp-tool-call@latest