---
title: Claude MCP Hub Submission — ThumbGate
created: 2026-03-04T00:00:00Z
updated: 2026-03-04T00:00:00Z
status: ready-to-submit
---

# Claude MCP Hub Submission: ThumbGate

Submit to: https://github.com/modelcontextprotocol/servers (official MCP servers list)
Also submit to: https://mcp.so (community MCP directory)

---

## Server Name

```
thumbgate
```

---

## Short Description (one line)

```
Capture thumbs-up/down feedback from Claude coding sessions, enforce schema quality, prevent repeated failures, and export DPO training pairs.
```

---

## Full Description

```
ThumbGate gives Claude Code (and any MCP-compatible client) a production-grade feedback capture loop.

Every interaction can be rated with a thumbs-up or thumbs-down signal plus rich context: rubric scores, guardrails, file paths, error types, and outcome categories. Repeated failures automatically generate prevention rules in CLAUDE.md format so Claude stops making the same mistakes.

The server exposes MCP tools for:
- Capturing feedback with schema validation
- Retrieving prevention rules generated from failure patterns
- Querying feedback summaries and statistics
- Exporting DPO preference pairs for offline fine-tuning

Works in local mode (zero config, no API key) or connected to the Context Gateway hosted API.
```

---

## Install Command

### Option A: Local mode (OSS, no API key needed)

```bash
claude mcp add thumbgate -- npx -y thumbgate@1.21.2 serve
```

Optional manual config (`~/.claude/claude_desktop_config.json` or `.claude/settings.json`):

```json
{
  "mcpServers": {
    "thumbgate": {
      "command": "npx",
      "args": ["-y", "thumbgate@1.21.2", "serve"],
      "env": {
        "THUMBGATE_BASE_URL": "http://localhost:8787"
      }
    }
  }
}
```

### Option B: Context Gateway (hosted API)

```json
{
  "mcpServers": {
    "thumbgate": {
      "command": "npx",
      "args": ["-y", "thumbgate@1.21.2", "serve"],
      "env": {
        "THUMBGATE_BASE_URL": "https://thumbgate-production.up.railway.app",
        "THUMBGATE_API_KEY": "tg_YOUR_KEY_HERE"
      }
    }
  }
}
```

Hosted API access is currently pilot/by-request rather than a public self-serve monthly subscription.
Current self-serve commercial offer: Pro ($19/mo or $149/yr): https://thumbgate-production.up.railway.app/checkout/pro
Team rollout pricing anchor: $49/seat/mo (min 3 seats), intake-first on the landing page.
Verification evidence: https://github.com/IgorGanapolsky/ThumbGate/blob/main/docs/VERIFICATION_EVIDENCE.md

---

## MCP Tools Exposed

| Tool Name | Description |
|-----------|-------------|
| `capture_feedback` | Capture a thumbs-up or thumbs-down signal with context, rubric scores, and guardrails |
| `get_feedback_summary` | Retrieve aggregated feedback statistics and patterns |
| `get_prevention_rules` | Retrieve prevention rules auto-generated from repeated failure patterns |
| `export_dpo_pairs` | Export feedback as DPO preference pairs for fine-tuning |
| `get_feedback_stats` | Get per-category Thompson Sampling posteriors |
| `validate_feedback` | Validate a feedback entry against the ThumbGate schema without capturing |

---

## Capabilities

- **Feedback Capture**: Structured up/down signals with rubric scores, guardrails, tags, file paths
- **Schema Validation**: Every entry is validated before promotion to memory
- **Prevention Rules**: Repeated failures auto-generate CLAUDE.md-compatible prevention rules
- **Thompson Sampling**: Per-category alpha/beta posteriors with exponential time-decay
- **Sequence Tracking**: Sliding window (N=10) feedback sequences per category
- **Diversity Tracking**: Per-domain coverage scores and diversity metrics
- **DPO Export**: PyTorch-ready preference pairs for offline fine-tuning
- **Vector Search**: LanceDB semantic similarity search over feedback history
- **Budget Guard**: Hard spend cap enforcement on every API operation
- **Context Packs**: Bounded retrieval for active task contexts
- **Self-Healing**: Automatic detection and remediation of config drift

---

## Transport

- **stdio** (primary): `npx -y thumbgate@1.21.2 serve` — version-pinned portable MCP launcher for Claude Code desktop and CLI
- **HTTP** (secondary): `src/api/server.js` — REST API (`POST /v1/feedback/capture`, `GET /v1/feedback/summary`, `POST /v1/dpo/export`)

---

## Repository

```
https://github.com/IgorGanapolsky/ThumbGate
```

---

## npm Package

```
https://www.npmjs.com/package/thumbgate
```

Install:
```bash
npm install thumbgate
```

---

## License

MIT

---

## Tags / Categories

- `thumbgate`
- `feedback`
- `ai-training`
- `dpo`
- `coding-agent`
- `prevention-rules`
- `productivity`
- `claude-code`

---

## Version

1.21.2

---

## Test Count

570 passing Node test assertions in the current coverage runner, plus inline script test phases in CI. No placeholder results.

```bash
npm test
```

---

## Submission Checklist (modelcontextprotocol/servers PR)

- [ ] Fork https://github.com/modelcontextprotocol/servers
- [ ] Add entry to `README.md` under **Community Servers** in alphabetical order:
  ```markdown
  - **[ThumbGate](https://github.com/IgorGanapolsky/ThumbGate)** — Capture feedback from AI coding agents, prevent repeated mistakes, export DPO training pairs. Works with Claude Code, ChatGPT, Gemini, Codex, and Amp.
  ```
- [ ] Open PR titled: `Add thumbgate community server`
- [ ] Verify CI passes on the PR

## Submission Checklist (mcp.so)

- [ ] Go to https://mcp.so/submit
- [ ] Paste GitHub URL: `https://github.com/IgorGanapolsky/ThumbGate`
- [ ] Verify auto-populated fields (name, description, tools)
- [ ] Add tags: `thumbgate`, `feedback`, `dpo`, `coding-agent`
- [ ] Submit
