gotoHuman

by gotohuman

26 stars

413 downloads

Not rated

GitHub Website

About

Enables AI agents to request human reviews through the gotoHuman platform, creating asynchronous workflows for content approval and critical action validation with webhook-based responses.

Details

Author: gotohuman
Repository: gotohuman/gotohuman-mcp-server
GitHub stars: 26
Downloads: 413
License: MIT License
Categories: Productivity, Developer Tools, Design, AI, Frontend, Infrastructure, API, Other
Tags: #web

- Human approvals for AI agents and workflows
- Fully-managed async human-in-the-loop process
- Customizable approval UI with built-in auth
- Webhook and notification support
- Team features and evolving training dataset
- Tools to list forms, get schemas, and request reviews
- Option to link reviews into multi-step workflows

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name gotoHuman

Command (node, npx, python, etc.) node
Arguments
- Argument 1 /<absolute-path>/build/index.js
Environment
- GOTOHUMAN_API_KEY your-api-key
- GOTOHUMAN_AGENT_ID your-agent-id
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

{
    "mcpServers": {
        "gotohuman": {
            "env": {
                "GOTOHUMAN_API_KEY": "your-api-key",
                "GOTOHUMAN_AGENT_ID": "your-agent-id"
            },
            "args": [
                "/c",
                "node",
                "C:\\<absolute-path>\\build\\index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

{
    "mcpServers": {
        "gotohuman": {
            "env": {
                "GOTOHUMAN_API_KEY": "your-api-key",
                "GOTOHUMAN_AGENT_ID": "your-agent-id"
            },
            "args": [
                "/c",
                "node",
                "C:\\<absolute-path>\\build\\index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

{
    "mcpServers": {
        "gotohuman": {
            "env": {
                "GOTOHUMAN_API_KEY": "your-api-key",
                "GOTOHUMAN_AGENT_ID": "your-agent-id"
            },
            "args": [
                "/c",
                "node",
                "C:\\<absolute-path>\\build\\index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

{
    "mcpServers": {
        "gotohuman": {
            "env": {
                "GOTOHUMAN_API_KEY": "your-api-key",
                "GOTOHUMAN_AGENT_ID": "your-agent-id"
            },
            "args": [
                "/c",
                "node",
                "C:\\<absolute-path>\\build\\index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

{
    "mcpServers": {
        "gotohuman": {
            "env": {
                "GOTOHUMAN_API_KEY": "your-api-key",
                "GOTOHUMAN_AGENT_ID": "your-agent-id"
            },
            "args": [
                "/c",
                "node",
                "C:\\<absolute-path>\\build\\index.js"
            ],
            "command": "cmd"
        }
    }
}

JSON

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

From the repository

npx @gotohuman/mcp-server

`list-forms`

List all available review templates. Returns a list of all available review templates in your account including high-level info about the added fields.

`get-form-schema`

Get the schema to use when requesting a human review for a given review template. Parameters: formId (the review template ID to fetch the schema for). Returns the schema, considering the included fields and their configuration.

`request-human-review-with-form`

Request a human review that will appear in your gotoHuman inbox. Parameters: formId (the ID of the review template to use), fieldData (content and configuration for the review template's fields), config (optional configuration for the review template), title (optional title shown in the inbox and notifications), webhookUrl (optional webhook URL for this request), workflow (optional object linking this review to a multi-step agentic workflow), metadata (optional additional data included in the webhook response), assignToUsers (optional list of user emails to assign the review to). Returns reviewId, reviewLink, and optionally workflowRunId when gotoHuman assigns a new workflow run.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

{
    "env": {
        "GOTOHUMAN_API_KEY": "your-api-key",
        "GOTOHUMAN_AGENT_ID": "your-agent-id"
    },
    "args": [
        "/c",
        "node",
        "C:\\<absolute-path>\\build\\index.js"
    ],
    "command": "cmd"
}

- List available review templates— Retrieve all review templates in your account withlist-formsto see their IDs and field summaries.
- Get the schema for a review template— Fetch the exact field structure and configuration required to submit a review viaget-form-schema.
- Request a human review— Submit AI-generated content for approval usingrequest-human-review-with-form, optionally assigning reviewers or linking steps into a multi-step workflow run.
- Chain reviews into a workflow— Pass aworkflowobject withrunIdandprevStepsto connect multiple human review steps into a single tracked run.

gotoHuman makes it easy to addhuman approvalsto 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.

{ "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 atapp.gotohuman.com

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

- Returnsa list of all available review templates in your account incl. high-level info about the added fields

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

- Params

- formId: The review template ID to fetch the schema for

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

- Params

- formId: The ID of the review template to use
- fieldData: Content (AI-output to review, context,...) and configuration for the review template's fields.
The schema for this needs to be fetched withget-form-schema
- config: Configuration for the review template. Optional. The schema for this needs to be fetched withget-form-schema
- title: Optional title shown in the inbox and notifications
- webhookUrl: Optional webhook URL for this request (when the review template has no default webhook)
- workflow: Optional object linking this review to a multi-step agentic workflow:

- runId: Unique ID for the current workflow run. Use the samerunIdon every review in the same run. Ifworkflowis sent withoutrunId(even{}), or for manual triggers, gotoHuman creates arunIdand returns it asworkflowRunIdfor subsequent requests.
- runName: Optional display name for the run (can be set or updated on any step)
- prevSteps: Array ofreviewIds from previous gotoHuman review steps (omit on the first step)

# 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, theargspath needs to beC:\\<absolute-path>\\build\\index.js

The 1Password MCP server creates a bridge that allows MCP clients such as Codex and Kiro to manage your 1Password Environments with secure authorization prompts.

This is the 1st, easiest, and cheapest PPT, slides, presentation AI generation MCP Server in the world.

Persistent memory for any AI assistant. Zero token cost until recall. Stores memories in local SQLite, ranks by 6-factor scoring, returns results 79% smaller than JSON. Works with Claude, ChatGPT, Grok, Cursor, Windsurf, and any MCP client.

A MCP server that enables AI assistants to interact with Anki, the spaced repetition flashcard application.

Enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.

An MCP server for WordPress plugin audits

Turn your AI assistant into a digital marketing hub that creates, organizes, and analyzes links and QR Codes on demand.

Connect AI clients to Cal.com scheduling through the Model Context Protocol using the hosted server at mcp.cal.com or a local instance.

Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

list-forms

get-form-schema

request-human-review-with-form

Claude Desktop / Cursor

Linux

Macos

Windows

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

Install

More like this

Time

Sentry

Github

Git

GitLab

Context 7

`list-forms`

`get-form-schema`

`request-human-review-with-form`