gotoHuman Human Approvals MCP Server

Developer ToolsJavaScript

Add human approval workflows to AI agents and applications

Available Tools

list-forms

List all available review forms in your gotoHuman account, including high-level information about the added fields.

get-form-schema

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

formId

request-human-review-with-form

Request a human review that will appear in your gotoHuman inbox. Requires formId, fieldData, and optional metadata and assignToUsers parameters.

formIdfieldDatametadataassignToUsers

gotoHuman provides a human-in-the-loop approval system for AI agents and workflows. It offers a fully-managed asynchronous approval process with a customizable UI that lets humans review and approve AI-generated content or actions. The service includes built-in authentication, webhooks, notifications, and team features, allowing developers to easily integrate human oversight into their AI systems.

Overview

gotoHuman is a service that makes it easy to add human approval steps to AI agents and workflows. This MCP server allows you to request human reviews directly from your AI applications through the Model Context Protocol.

Installation

You can quickly start using the gotoHuman MCP server with npx:

npx @gotohuman/mcp-server

To use it with Claude, Cursor, Windsurf, or other MCP-compatible clients, you'll need to add it to your client configuration.

Configuration

Before using gotoHuman, you'll need to:

Create an account at app.gotohuman.com
Get your API key
Set up an approval form in the gotoHuman dashboard

Client Setup

Add the following configuration to your MCP client (like Cursor, Claude, or Windsurf):

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

Replace your-api-key with the API key from your gotoHuman account.

Usage

Once configured, you can use the gotoHuman MCP server to:

List available review forms
Get form schemas
Request human reviews for AI-generated content

When a review is requested, it will appear in your gotoHuman inbox. Reviewers can approve, reject, or provide feedback on the content. After submission, webhooks can notify your application of the review outcome.

Development

If you want to run the server locally during development:

# Install dependencies
npm install

# Build the server
npm run build

# For testing: Run the MCP inspector
npm run inspector

For local development with an MCP client, use:

{
  "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