Gentoro MCP server

The Gentoro MCP Server enables Claude to interact with Gentoro bridges and access their underlying capabilities. It integrates with the Gentoro platform to provide agents access to various tools and data sources through the Model Context Protocol (MCP).

Prerequisites

Before setting up the Gentoro MCP Server, you need to:

• Create a Gentoro account
• Generate a Gentoro API Key
• Define a Bridge with your required tools

Getting Started

Creating a Gentoro Account

Visit the Gentoro Playground website to request an account and start using Gentoro services.

Alternatively, you can download and install Gentoro locally by following the installation guide.

Obtaining a Gentoro API Key

You'll need a Gentoro API Key to authenticate your MCP Server. Follow the instructions to create one here.

Defining a Bridge

Use Gentoro Studio to define your bridge with all the tools and data sources required for your application.

Integrating with Claude

To integrate Gentoro with Claude or other agents using NodeJS, add the following configuration to your config.json file:

{
    "mcpServers": {
        "gentoro": {
            "command": "npx",
            "args": [
                "-y",
                "@gentoro/mcp-nodejs-server"
            ],
            "env": {
                "GENTORO_API_KEY": "<your api key>",
                "GENTORO_BRIDGE_UID": "<your bridge uid>",
                "GENTORO_BASE_URL": "<url where gentoro is hosted>"
            }
        }
    }
}

Using the Shortened Configuration

Alternatively, you can use a shorter version of the configuration with a combined Gentoro Key:

{
    "mcpServers": {
        "gentoro": {
            "command": "npx",
            "args": [
                "-y",
                "@gentoro/mcp-nodejs-server"
            ],
            "env": {
                "GENTORO_KEY": "<your api key>/<your bridge uid>/<url where gentoro is hosted>"
            }
        }
    }
}

These values are URL-safe and can be properly generated from Gentoro Studio.

Working with Tools

The Gentoro MCP Server gives Claude access to all tools configured in your Gentoro bridge. You can create and integrate custom tools into a common Bridge, defining all available capabilities for your agent.

The tools and their underlying functionality are fully controlled at the Gentoro bridge level, allowing you to enable and disable tools as needed for your specific use case.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

claude mcp add-json "gentoro" '{"command":"npx","args":["-y","@gentoro/mcp-nodejs-server"],"env":{"GENTORO_KEY":"<your api key>/<your bridge uid>/<url where gentoro is hosted>"}}'

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "gentoro": {
            "command": "npx",
            "args": [
                "-y",
                "@gentoro/mcp-nodejs-server"
            ],
            "env": {
                "GENTORO_KEY": "<your api key>/<your bridge uid>/<url where gentoro is hosted>"
            }
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

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

2. Add this to your configuration file:

{
    "mcpServers": {
        "gentoro": {
            "command": "npx",
            "args": [
                "-y",
                "@gentoro/mcp-nodejs-server"
            ],
            "env": {
                "GENTORO_KEY": "<your api key>/<your bridge uid>/<url where gentoro is hosted>"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect