gotoHuman MCP server

gotoHuman MCP Server is a tool that enables human approvals in AI workflows through a fully-managed asynchronous human-in-the-loop system. It provides a customizable approval UI with built-in authentication, webhooks, notifications, and team features. The MCP server allows you to request human approvals from your AI workflows or integrate it with your IDE.

Installation

You can easily install the gotoHuman MCP server using npx:

npx @gotohuman/mcp-server

Integration with Cursor, Claude, or Windsurf

To integrate the MCP server with compatible IDEs like Cursor, Claude, or Windsurf, add the following configuration:

{
  "mcpServers": {
    "gotoHuman": {
      "command": "npx",
      "args": ["-y", "@gotohuman/mcp-server"],
      "env": {
        "GOTOHUMAN_API_KEY": "your-api-key"
      }
    }
  }
}

Before using the server, you'll need to get your API key by setting up an approval step at app.gotohuman.com.

Available Tools

The gotoHuman MCP server provides several tools for managing human reviews:

List Forms

The list-forms tool allows you to list all available review forms in your account.

Returns: A list of all available forms including high-level information about the added fields.

Get Form Schema

The get-form-schema tool retrieves the schema needed when requesting a human review for a specific form.

Parameters:

• formId: The form ID to fetch the schema for

Returns: The schema, considering the included fields and their configuration.

Request Human Review

The request-human-review-with-form tool submits a request for human review, which will appear in your gotoHuman inbox.

Parameters:

• formId: The form ID for the review
• fieldData: Content (AI-output to review, context, etc.) and configuration for the form's fields. The schema for this needs to be fetched with get-form-schema
• metadata: Optional additional data that will be included in the webhook response after form submission
• assignToUsers: Optional list of user emails to assign the review to

Returns: A link to the review in gotoHuman.

Example Usage

Here's how the workflow typically looks:

1. Set up your approval step at app.gotohuman.com
2. Install the MCP server using npx
3. Configure your IDE or AI workflow to use the MCP server
4. Use the available tools to list forms, get schemas, and request human reviews
5. Receive approvals through the gotoHuman interface

The server can be used with IDE integrations like Cursor or as part of background agents that react to approval webhooks.

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 "gotoHuman" '{"command":"npx","args":["-y","@gotohuman/mcp-server"],"env":{"GOTOHUMAN_API_KEY":"your-api-key"}}'

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": {
        "gotoHuman": {
            "command": "npx",
            "args": [
                "-y",
                "@gotohuman/mcp-server"
            ],
            "env": {
                "GOTOHUMAN_API_KEY": "your-api-key"
            }
        }
    }
}

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": {
        "gotoHuman": {
            "command": "npx",
            "args": [
                "-y",
                "@gotohuman/mcp-server"
            ],
            "env": {
                "GOTOHUMAN_API_KEY": "your-api-key"
            }
        }
    }
}

3. Restart Claude Desktop for the changes to take effect