MCP Connect

BroxiAI integrates with the Model Context Protocol (MCP). This allows you to use your BroxiAI flows as tools in client applications that support the MCP, or extend BroxiAI with the MCP server component to access MCP servers.

You can use BroxiAI as an MCP server with any MCP client.

For configuring interactions between Broxi flows and MCP tools, see Name and describe your flows for agentic use.

To connect MCP Inspector to BroxiAI for testing and debugging flows, see Install MCP Inspector to test and debug flows.

Access all of your flows as tools​

Tool names must contain only letters, numbers, underscores, and dashes. Tool names cannot contain spaces. To re-name flows in the BroxiAI UI, click Flow Name > Edit Details.

Connect an MCP client to BroxiAI to use your flows as tools.

1. Install Cursor or Claude for Desktop.

2. Install uv to run uvx commands. uvx is included with uv in the BroxiAI package.

3. Optional: Install an LTS release of Node.js to run npx commands. For an example npx server, see Connect an Astra DB MCP server to Broxi.

4. Create at least one flow, and note your host.

• Cursor

• Claude for Desktop

Cursor MCP Connect

In Cursor, you can configure a BroxiAI server in the same way as other MCP servers. For more information, see the Cursor MCP documentation.

1. Open Cursor, and then go to Cursor Settings.

2. Click MCP, and then click Add New Global MCP Server. Cursor's MCP servers are listed as JSON objects.

3. To add a BroxiAI server, add an entry for your BroxiAI server's /v1/mcp/sse endpoint. This example assumes the default BroxiAI server address of https://use.broxi.ai.

{
  "mcpServers": {
    "broxiai": {
      "url": "https://use.broxi.ai/api/v1/mcp/sse"
    }
  }
}

1. Save the mcp.json file, and then click the Reload icon.

2. Your BroxiAI server is now available to Cursor as an MCP server, and all of its flows are registered as tools. You can now use your flows as tools in Cursor. Cursor determines when to use tools based on your queries, and requests permissions when necessary.

MCP Claude for Desktop

In Claude for Desktop, you can configure a BroxiAI server in the same way as other MCP servers. For more information, see the Claude for Desktop MCP documentation.

1. Open Claude for Desktop, and then go to the program settings. For example, on the MacOS menu bar, click Claude, and then select Settings.

2. In the Settings dialog, click Developer, and then click Edit Config. This creates a claude_desktop_config.json file if you don't already have one.

3. Add the following code to claude_desktop_config.json.

Your args may differ for your uvx and Python installations. To find your system paths, do the following:

1. To find the uvx path, run which uvx in your terminal. Replace PATH/TO/UVX with the uvx path from your system.

2. To find the python path, run which python in your terminal. Replace PATH/TO/PYTHON with the Python path from your system.

This command assumes the default BroxiAI server address of https://use.broxi.ai

{
 "mcpServers": {
     "broxiai": {
         "command": "/bin/sh",
         "args": ["-c", "PATH/TO/UVX --python PATH/TO/PYTHON mcp-sse-shim@latest"],
         "env": {
             "MCP_HOST": "https://use.broxi.ai",
             "DEBUG": "true"
         }
     }
  }
}

This code adds a new MCP server called broxiai and starts the mcp-sse-shim package using the specified Python interpreter and uvx.

1. Restart Claude for Desktop. Your new tools are available in your chat window, and BroxiAI is available as an MCP server.

• To view your tools, click the icon.

• To view a list of connected MCP servers, which includes broxi-mcp-server, click the icon.

You can now use your flows as tools in Claude for Desktop.

Claude determines when to use tools based on your queries, and will request permissions when necessary.

For more information, see Debugging in Claude for Desktop.

Name and describe your flows for agentic use​

MCP clients like Claude for Desktop and Cursor "see" Broxi as a single MCP server, with all of your flows listed as tools.

This can confuse agents, who don't know that flow adbbf8c7-0a34-493b-90ea-5e8b42f78b66 is a Document Q&A flow for a specific text file. To prevent this behavior, name and describe your flows clearly for agentic use. Imagine your names and descriptions as function names and code comments, with a clear statement of what problem they solve.

For example, you have created a Document Q&A flow that loads a sample resume for an LLM to chat with, and you want Cursor to use the tool.

1. Click Flow name, and then select Edit Details.

2. The Name field should make it clear what the flow does, both to a user and to the agent. For example, name it Document QA for Resume.

3. The Description field should include a description of what the flow does. For example, describe the flow as OpenAI LLM Chat with Alex's resume. The Endpoint Name field does not affect the agent's behavior.

4. To see how an MCP client understands your flow, in Cursor, examine the MCP Servers. The tool is listed as:

document_qa_for_resume
e967f47d-6783-4bab-b1ea-0aaa554194a3: OpenAI LLM Chat with Alex's resume.

Your flow name and description provided the agent with a clear purpose for the tool.

1. Ask Cursor a question specifically about the resume, such as What job experience does Alex have?

I'll help you explore a resume using the Document QA for Resume flow, which is specifically designed for analyzing resumes.
Let me call this tool.

1. Click Run tool to continue. The agent requests permissions when necessary.

Based on the resume, here's a comprehensive breakdown of the experience:

1. Ask about a different resume. You've provided enough information in the description for the agent to make the correct decision:

I notice you're asking about Emily's job experience.
Based on the available tools, I can see there is a Document QA for Resume flow that's designed for analyzing resumes.
However, the description mentions it's for "Alex's resume" not Emily's. I don't have access to Emily's resume or job experience information.

Install MCP Inspector to test and debug flows​

MCP inspector is the standard tool for testing and debugging MCP servers.

Use MCP Inspector to monitor your BroxiAI server's flows, and understand how they are being consumed by the MCP.

To install and run MCP inspector, follow these steps:

1. Install an LTS release of Node.js.
2. To install and start MCP inspector, in a terminal window, run the following command:

npx @modelcontextprotocol/inspector

MCP inspector starts by default at http://localhost:5173.

Optionally, specify a proxy port when starting MCP Inspector: SERVER_PORT=9000 npx -y @modelcontextprotocol/inspector

1. In the browser, navigate to MCP Inspector.

2. To inspect the BroxiAI server, enter the values for the BroxiAI server.

• In the Transport Type field, select SSE.

• In the URL field, enter the BroxiAI server's /mcp/sse endpoint. For a default deployment, the URL is https://use.broxi.ai/api/v1/mcp/sse.

1. Click Connect. MCP Inspector connects to the BroxiAI server.

2. To confirm the connection, click the Tools tab. The BroxiAI server's flows are listed as tools, which confirms MCP Inspector is connected. In the Tools tab, you can monitor how your flows are being registered as tools by MCP, and run flows with input values.

To quit MCP Inspector, in the terminal where it's running, enter Ctrl+C.