What is gotoHuman MCP Server

gotoHuman is a managed service for integrating human approvals within AI workflows, allowing organizations to add a human-in-the-loop step for quality control and decision-making in their agent and workflow processes.

Use cases

goToHuman can be utilized in various scenarios including content moderation, AI-generated outputs requiring validation, decision-making processes that need human oversight, and any automated workflows where human approval enhances reliability and trust.

How to use

To use gotoHuman, install the MCP server via npx, configure it with your API key, and then set up an approval step through the provided interface. You can list forms, get their schemas, and request human reviews using designated commands and parameters.

Key features

Key features of gotoHuman include a customizable approval UI, built-in authentication, support for webhooks and notifications, team collaboration functionalities, and an evolving dataset to enhance training and accuracy of AI outputs.

Where to use

gotoHuman can be integrated into various development environments and platforms that support MCP protocols, such as Cursor, Claude, and Windsurf, making it versatile for both standalone applications and collaborative workflows.

gotoHuman MCP Server

gotoHuman makes it easy to add human approvals to AI agents and agentic workflows.
A fully-managed async human-in-the-loop workflow with a customizable approval UI.
Enjoy built-in auth, webhooks, notifications, team features, and an evolving training dataset.

Use our MCP server to request human approvals from your AI workflows via MCP or add it to your IDE to help with integration.

Installation

npx @gotohuman/mcp-server

Use with Cursor / Claude / Windsurf

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

Get your API key and set up an approval step at app.gotohuman.com

Demo

This is Cursor on the left, but this could be a background agent that also reacts to the approval webhook.

https://github.com/user-attachments/assets/380a4223-ea77-4e24-90a5-52669b77f56f

Tools

list-forms

List all available review forms.

• Returns a list of all available forms in your account incl. high-level info about the added fields

get-form-schema

Get the schema to use when requesting a human review for a given form.

• Params
  • formId: The form ID to fetch the schema for
• Returns the schema, considering the incl. fields and their configuration

request-human-review-with-form

Request a human review. Will appear in your gotoHuman inbox.

• Params
  • formId: The form ID for the review
  • fieldData: Content (AI-output to review, context,…) 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 incl. 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

Development

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

Run locally in MCP Client (e.g. Cursor / Claude / Windsurf)

{
  "mcpServers": {
    "gotoHuman": {
      "command": "node",
      "args": [
        "/<absolute-path>/build/index.js"
      ],
      "env": {
        "GOTOHUMAN_API_KEY": "your-api-key"
      }
    }
  }
}

[!NOTE]
For Windows, the args path needs to be C:\\<absolute-path>\\build\\index.js