# Gemmein

Gives coding agents Gemmein docs, SDK help, error explanations, and live checks of app access boundaries. Useful when building or validating a Gemmein integration.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: gemmeinhq
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/gemmeinhq/gemmein-release
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/gemmein

## What it does

The server exposes tools for searching Gemmein’s builder guide and SDK reference. An agent can look up rules, interpret errors, check collection names, and explain relay definitions. It can also run an app’s isolation and access checks and return pass/fail results.

Eight tools are read-only. With a development secret key, `check_integration` also changes the development environment: it creates test users and a probe record, removes the record, and ends earlier sessions for those users. Account for that side effect before running the live check. No environment variables are needed to start the server.

For Claude Code, connect it as a local process with `npx` and `@gemmein/mcp`. This server runs independently of the Gemmein engine.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.gemmein.com/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://api.gemmein.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add gemmein -- npx -y @gemmein/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add gemmein --url https://api.gemmein.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add gemmein -- npx -y @gemmein/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gemmein": {
            "url": "https://api.gemmein.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "gemmein": {
            "command": "npx",
            "args": [
                "-y",
                "@gemmein/mcp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "gemmein": {
            "type": "http",
            "url": "https://api.gemmein.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "gemmein": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@gemmein/mcp"
            ]
        }
    }
}
```

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http gemmein https://api.gemmein.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add gemmein npx -y @gemmein/mcp
```

## When to use it
- look up an SDK method and its signature
- interpret a `GemmeinError` code
- catch a collection naming mistake before querying
- understand an access rule or relay definition
- run live isolation and access checks on an app

## Example prompts
- Find the Gemmein guide’s instructions for setting up the auth flow.
- Explain what this `GemmeinError` means and what change would address it.
- Run `check_integration` to test my app’s isolation and access boundaries.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 397855
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 34011
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89674
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81191
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74577
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 90077

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md