Skip to main content
Glama
gotoHuman MCP

gotoHuman MCP

Official
by gotohuman

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 or use it to help with integration.

Usage

Available on npm as:

@gotohuman/mcp-server

Setup in Cursor / Claude / etc.

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

Install MCP Server

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

Related MCP server: final-approval

Tools

list-forms

List all available review types.

  • Returns a list of all available review types 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 review type.

  • Params

    • formId: The review type 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 ID of the review type to use

    • fieldData: Content (AI-output to review, context,...) and configuration for the review type's fields.
      The schema for this needs to be fetched with get-form-schema

    • config: Configuration for the review type. Optional. The schema for this needs to be fetched with get-form-schema

    • title: Optional title shown in the inbox and notifications

    • webhookUrl: Optional webhook URL for this request (Static URLs can be set on the review type or the agent in gotoHuman)

    • workflow: Optional object linking this review to a multi-step agentic workflow:

      • runId: Unique ID for the current workflow run to link multiple steps.

    • metadata: Optional additional data that will be incl. in the webhook response after review template submission

    • assignToUsers: Optional list of user emails to assign the review to

  • Returns reviewId and reviewLink

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",
      "GOTOHUMAN_AGENT_ID": "your-agent-id"
    }
  }
}
}
NOTE

For Windows, theargs path needs to be C:\\<absolute-path>\\build\\index.js

Available Tools

3 tools
get-form-schemaA

Get the schema to use for the 'fields' property when requesting a human review with a form.

Inputs: formId (required).

list-formsA

List all available review forms. NOTE: You need to fetch the schema for the form fields first using the get-form-schema tool.

Inputs: no named parameters.

request-human-review-with-formA

Request a human review with a form. NOTE: If you don't have a form ID yet, list all available forms using the list-forms tool first. To know what to pass for fieldData, you need to fetch the schema for the form fields using the get-form-schema tool.

Inputs: formId (required), fieldData (required), metadata, assignToUsers.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: get-form-schema retrieves schema information, list-forms enumerates available forms, and request-human-review-with-form submits a review request. There is no overlap in functionality, and the descriptions explicitly guide agents on when to use each tool, preventing misselection.

    Naming Consistency4/5

    The tool names follow a consistent verb-noun pattern with hyphens (e.g., get-form-schema, list-forms, request-human-review-with-form), making them readable and predictable. The minor deviation is that request-human-review-with-form includes a prepositional phrase, but this does not significantly impact consistency.

    Tool Count5/5

    With 3 tools, this server is well-scoped for its purpose of handling human reviews with forms. Each tool earns its place by covering essential steps: schema retrieval, form listing, and review submission, without being overly sparse or bloated.

    Completeness5/5

    The tool set provides complete coverage for the domain of requesting human reviews with forms. It includes all necessary CRUD-like operations: retrieving schema (read), listing forms (read), and submitting reviews (create), with no obvious gaps that would cause agent failures in this workflow.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Human-in-the-Loop authorization gateway for AI Agents. Securely pause MCP workflows and route high-risk actions to human approvers via Slack or Email.
      56 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Human-in-the-loop approval gate for AI agents. Your agent calls submit_approval before any irreversible action; a human reviews on a branded page; a signed webhook fires back with the decision.
      1
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides a human approval gate for AI agents, enabling interactive inline cards for approving, editing, or rejecting actions before they are executed.
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Pauses AI agent execution and routes approval requests to humans via Slack or email, with cryptographically signed proof of the human's decision.
      MIT