# Hovercode

Connects your assistant to Hovercode to generate QR codes, build quick landing pages, shorten URLs, and track scan analytics through chat.

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

## What it does

This server connects AI assistants to the Hovercode platform. It lets models generate PNG or SVG QR codes, update scan destinations, restyle markers, and organize assets into folders. Everything the model produces appears instantly in your Hovercode workspace.

Setup works through a hosted HTTP endpoint at `https://hovercode.com/mcp/` or via a local bridge running `npx -y hovercode-mcp`. Authentication relies on browser OAuth or an API token passed in environment variables or request headers.

Static barcodes carry no quota limits. Dynamic tracked links share your workspace limits, so large marketing campaigns need an upgraded account.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://hovercode.com/mcp/`
- Environment variables: `HOVERCODE_API_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

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

2. **Platform CLI**
```bash
claude mcp add --env HOVERCODE_API_TOKEN=<HOVERCODE_API_TOKEN> --transport stdio hovercode -- npx -y hovercode-mcp
```
Replace <…> with your own values

### Codex

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

2. **Platform CLI**
```bash
codex mcp add hovercode --env HOVERCODE_API_TOKEN=<HOVERCODE_API_TOKEN> -- npx -y hovercode-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hovercode": {
            "url": "https://hovercode.com/mcp/"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hovercode": {
            "command": "npx",
            "args": [
                "-y",
                "hovercode-mcp"
            ],
            "env": {
                "HOVERCODE_API_TOKEN": "<HOVERCODE_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hovercode": {
            "type": "http",
            "url": "https://hovercode.com/mcp/"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hovercode": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "hovercode-mcp"
            ],
            "env": {
                "HOVERCODE_API_TOKEN": "<HOVERCODE_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini mcp add -e HOVERCODE_API_TOKEN=<HOVERCODE_API_TOKEN> hovercode npx -y hovercode-mcp
```
Replace <…> with your own values

## When to use it
- generate print-ready vector and raster QR codes
- redirect dynamic QR destinations without changing printed materials
- build block-based landing pages and feedback forms
- inspect scan metrics by city, device, and timeframe

## Example prompts
- Point my printed menu QR code to the updated PDF URL
- Build a quick form asking for attendee names and t-shirt sizes, then return the QR code

## Similar
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 108044
- [openshorts](https://affpapa.org/en/nevibecode/mcp/openshorts.md) — MCP server · ★ 7217
- [OpenScreen](https://affpapa.org/en/nevibecode/mcp/openscreen.md) — MCP server · ★ 5005
- [Usertour MCP Server](https://affpapa.org/en/nevibecode/mcp/usertour-mcp-server.md) — MCP server · ★ 2328
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3435
- [obsei](https://affpapa.org/en/nevibecode/mcp/obsei.md) — MCP server · ★ 1441

---
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