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 templates.

`get-form-schema`

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

`request-human-review-with-form`

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

The schema for this needs to be fetched with `get-form-schema`

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": ["//build/index.js"],
      "env": {
        "GOTOHUMAN_API_KEY": "your-api-key",
        "GOTOHUMAN_AGENT_ID": "your-agent-id"
      }
    }
  }
}

> [!NOTE]

> For Windows, the `args` path needs to be `C:\\\\build\\index.js`