Lets AI agents read and manage human review processes, templates, and feedback loops directly within MCP-compatible clients.
Also known as gatewerk/gatewerk, mcp, @gatewerk/mcp
- Stars
- 1
- Tools
- 18
- Downloads, 30 days
- 156
- Latest version
- 1.1.4
- Last commit
- Nov 13, 2026
- License
- AGPL-3.0
What is Gatewerk MCP?
Gatewerk lets AI agents read and manage human review processes, templates, and feedback loops directly within MCP-compatible clients. It exposes 18 tools, such as gatewerk_create_review, gatewerk_list_reviews, gatewerk_get_review.
Summary generated from the project's README
About Gatewerk MCP server
Gatewerk provides a specialized interface for AI agents to interact with human review processes. By connecting to MCP-compatible clients like Claude Desktop, Cursor, or Windsurf, agents can manage templates, feedback loops, and audit trails. This server acts as a bridge to the Gatewerk review layer, which is an open-source, self-hosted system designed to ensure human oversight for AI-generated work.
Users set up the server using the npx command, which prompts for a Gatewerk URL and an API key. The server relies on specific API key scopes to determine which tools are visible to the agent. For example, an agent with only read permissions cannot use the decision tools. You can also provide an optional reviewer email to attribute decisions made through the client to a specific person.
Available tools include functions for creating and listing reviews, managing templates, and executing multi-step chain runs. Agents can also post notes, query feedback for learning, and inspect audit trails or performance statistics. The system supports various permission levels ranging from basic agent access to full administrative control.
What you can do with it
- 1Execute review decisionsAn agent can approve, reject, or perform specific actions on a review based on template instructions.
- 2Maintain documentation and notesDevelopers can have agents post and organize notes pinned to specific reviews or templates.
- 3Analyze historical performanceAn agent can query past decisions and audit trails to improve its future outputs.
Written from the project's README. Every use case is checked against a quote from it.
How to install Gatewerk MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Gatewerk MCP in Claude Code
$ claude mcp add --env 'GATEWERK_API_KEY=<YOUR_GATEWERK_API_KEY>' mcp -- npx -y @gatewerk/mcpInstall Gatewerk MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@gatewerk/mcp"
],
"env": {
"GATEWERK_API_KEY": "<YOUR_GATEWERK_API_KEY>"
}
}
}
}Install Gatewerk MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gatewerk/mcp"
],
"env": {
"GATEWERK_API_KEY": "<YOUR_GATEWERK_API_KEY>"
}
}
}
}Install Gatewerk MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@gatewerk/mcp"],"env":{"GATEWERK_API_KEY":"<YOUR_GATEWERK_API_KEY>"}}'Install Gatewerk MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@gatewerk/mcp"
],
"env": {
"GATEWERK_API_KEY": "<YOUR_GATEWERK_API_KEY>"
}
}
}
}Install Gatewerk MCP in Codex
$ codex mcp add mcp --env 'GATEWERK_API_KEY=<YOUR_GATEWERK_API_KEY>' -- npx -y @gatewerk/mcpInstall Gatewerk MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@gatewerk/mcp"] [mcp_servers.mcp.env] GATEWERK_API_KEY = "<YOUR_GATEWERK_API_KEY>"
Install Gatewerk MCP in Gemini CLI
$ gemini mcp add -s user -e 'GATEWERK_API_KEY=<YOUR_GATEWERK_API_KEY>' mcp npx -- -y @gatewerk/mcpInstall Gatewerk MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@gatewerk/mcp"
],
"env": {
"GATEWERK_API_KEY": "<YOUR_GATEWERK_API_KEY>"
}
}
}
}Needs a key before it starts
Started on 16 Nov 2026 with no keys, it stopped and asked for one, so a client sees no tools until you set the variables above.
Gatewerk MCP tools 18
Detected from the READMEgatewerk_create_reviewgatewerk_list_reviewsgatewerk_get_reviewgatewerk_decide_reviewgatewerk_take_review_actiongatewerk_list_review_actionsgatewerk_list_templatesgatewerk_create_templategatewerk_update_templategatewerk_delete_templategatewerk_start_chain_rungatewerk_get_chain_run
| gatewerk_create_review | — | |
| gatewerk_list_reviews | — | |
| gatewerk_get_review | — | |
| gatewerk_decide_review | — | |
| gatewerk_take_review_action | — | |
| gatewerk_list_review_actions | — | |
| gatewerk_list_templates | — | |
| gatewerk_create_template | — | |
| gatewerk_update_template | — | |
| gatewerk_delete_template | — | |
| gatewerk_start_chain_run | — | |
| gatewerk_get_chain_run | — |
Show all 18 toolsShow fewer tools
gatewerk_get_chain_for_reviewgatewerk_create_notegatewerk_list_notesgatewerk_query_feedbackgatewerk_query_auditgatewerk_get_stats
| gatewerk_get_chain_for_review | — | |
| gatewerk_create_note | — | |
| gatewerk_list_notes | — | |
| gatewerk_query_feedback | — | |
| gatewerk_query_audit | — | |
| gatewerk_get_stats | — |
Configuration
GATEWERK_API_KEYRequiredSecretGatewerk API key (gwk_...). Generate one at your Gatewerk instance under Settings → API Keys.
GATEWERK_REVIEWERReviewer email used as decision attribution. When set, decisions made through the MCP server are attributed to this reviewer instead of the API key identity.
GATEWERK_URLBase URL of your self-hosted Gatewerk instance (e.g. https://api.gatewerk.com). Defaults to http://localhost:3100.
| Name | Description | |
|---|---|---|
| GATEWERK_API_KEY | Gatewerk API key (gwk_...). Generate one at your Gatewerk instance under Settings → API Keys. | RequiredSecret |
| GATEWERK_REVIEWER | Reviewer email used as decision attribution. When set, decisions made through the MCP server are attributed to this reviewer instead of the API key identity. | |
| GATEWERK_URL | Base URL of your self-hosted Gatewerk instance (e.g. https://api.gatewerk.com). Defaults to http://localhost:3100. |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHub@gatewerk/mcp
The Gatewerk MCP server lets AI agents read and decide reviews from inside Claude Desktop, Claude Code, Cursor, Windsurf, or any Model Context Protocol client. It exposes Gatewerk's review/template/feedback/audit/chain/note APIs as MCP tools, scoped to whatever permissions the API key carries.
Gatewerk is an open-source, self-hosted review layer for AI agents. Work done for humans is decided by humans.
Quickstart
npx @gatewerk/mcp init
The init command prompts for your Gatewerk URL, API key, and (optionally) reviewer email, then prints a config block you paste into your MCP client's settings.
You can also write the config by hand:
{
"mcpServers": {
"gatewerk": {
"command": "npx",
"args": ["-y", "@gatewerk/mcp@1.1.0"],
"env": {
"GATEWERK_URL": "https://api.gatewerk.com",
"GATEWERK_API_KEY": "gwk_...",
"GATEWERK_REVIEWER": "alice@team.com"
}
}
}
}
GATEWERK_REVIEWER is optional — when set, decisions made through the MCP server are attributed to that reviewer. Otherwise the API key's identity is used.
Available tools
Tools are filtered automatically based on the scopes attached to your API key. A key with only reviews:read will not see gatewerk_decide_review.
Reviews
gatewerk_create_review— submit a new review request (scope:reviews:create)gatewerk_list_reviews— list reviews with filters (scope:reviews:read)gatewerk_get_review— fetch a review with its template metadata (scope:reviews:read)gatewerk_decide_review— approve / reject / edit / retry a review [deprecated; prefergatewerk_take_review_action] (scope:reviews:decide)gatewerk_take_review_action— invoke a configurable action on a review; supports built-in and template-specific action IDs (scope:reviews:decide)gatewerk_list_review_actions— introspect the available actions on a review's template (scope:reviews:read)
Templates
gatewerk_list_templates— list templates (scope:templates:read)gatewerk_create_template— define a template (scope:templates:write)gatewerk_update_template— modify a template (scope:templates:write)gatewerk_delete_template— remove a template (scope:templates:write)
Chains
gatewerk_start_chain_run— start a multi-step review chain from a definition (scope:templates:write)gatewerk_get_chain_run— fetch a chain run + steps by ID (scope:reviews:read)gatewerk_get_chain_for_review— get chain context for a review (scope:reviews:read)
Notes
gatewerk_create_note— post a note, optionally pinned to one or more reviews/templates/chain runs (scope:notes:write)gatewerk_list_notes— list notes with filters (author, tags, target, shared/private) (scope:notes:read)
Queries + stats
gatewerk_query_feedback— query past decisions for learning (scope:feedback:read)gatewerk_query_audit— query the audit trail (scope:audit:read)gatewerk_get_stats— review metrics + daily trend (scope:stats:read)
Authentication
You'll need a Gatewerk API key with the appropriate scopes. Generate one at:
- Cloud: https://app.gatewerk.com → Settings → API Keys
- Self-hosted: your Gatewerk instance's
/settings/api-keyspage
Common scope bundles:
- agent (read your reviews + create new ones):
reviews:create,feedback:read - reviewer (act on the inbox):
reviews:read,reviews:decide,templates:read,notes:read,notes:write - admin (full surface): all scopes
Environment variables
| Variable | Required | Description |
|---|---|---|
GATEWERK_API_KEY |
yes | API key (gwk_...) |
GATEWERK_URL |
no | Gatewerk base URL (defaults to http://localhost:3100) |
GATEWERK_REVIEWER |
no | Reviewer email used as decision attribution |
Links
- Website: https://gatewerk.com
- App: https://app.gatewerk.com
- Source: https://github.com/gatewerk/gatewerk
- Docs: https://gatewerk.com/docs
- License: Apache-2.0 (MCP SDK package; server is AGPL-3.0-only)
Gatewerk MCP questions
How do I add Gatewerk MCP to Claude Code?
Run claude mcp add --env 'GATEWERK_API_KEY=<YOUR_GATEWERK_API_KEY>' mcp -- npx -y @gatewerk/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Gatewerk MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Gatewerk MCP provide?
It exposes 18 tools, including gatewerk_create_review, gatewerk_list_reviews, gatewerk_get_review, gatewerk_decide_review, gatewerk_take_review_action.
How do I set up Gatewerk with my MCP client?
You can run the init command which prompts for your URL and API key, or manually add a configuration block to your MCP settings.
Can I attribute decisions to a specific person?
Yes, by setting the GATEWERK_REVIEWER environment variable, decisions made through the server are attributed to that specific email.
Are all tools available to every API key?
No, tools are automatically filtered based on the specific scopes attached to your API key.