# Hovercode (remote · hovercode.com)

Create and manage QR codes, short links, landing pages, and forms in your Hovercode workspace.

- Trust score: 84/100 (high trust)
- Change this week: +5
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-21

## Components

- remote · `hovercode.com`: 84/100 (this document), [markdown](https://verifymcp.io/servers/com-hovercode-mcp/hovercode.md), [page](https://verifymcp.io/servers/com-hovercode-mcp/hovercode)
- npm · `hovercode-mcp`: 38/100, [markdown](https://verifymcp.io/servers/com-hovercode-mcp/hovercode-mcp.md), [page](https://verifymcp.io/servers/com-hovercode-mcp/hovercode-mcp)

## Channel facts

- Endpoint: `https://hovercode.com/mcp/`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-21.

- **Endpoint Security**: 94/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 79/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 7790 tokens (~210/item across 37 items; 36 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 37/100
  - Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 38 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 73/100
  - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28.
  - Supports UI / widget rendering.

## Install

### How do I install the Hovercode MCP server?

Hovercode is a hosted endpoint at https://hovercode.com/mcp/, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http com-hovercode-mcp 'https://hovercode.com/mcp/'
```

### Cursor

```json
{
  "mcpServers": {
    "com-hovercode-mcp": {
      "url": "https://hovercode.com/mcp/"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "com-hovercode-mcp": {
      "type": "http",
      "url": "https://hovercode.com/mcp/"
    }
  }
}
```

### Codex

```toml
[mcp_servers.com-hovercode-mcp]
url = "https://hovercode.com/mcp/"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-hovercode-mcp": {
      "type": "remote",
      "url": "https://hovercode.com/mcp/",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-hovercode-mcp --url 'https://hovercode.com/mcp/' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-hovercode-mcp:
    url: "https://hovercode.com/mcp/"
```

### Netclaw

```json
{
  "McpServers": {
    "com-hovercode-mcp": {
      "Transport": "http",
      "Url": "https://hovercode.com/mcp/"
    }
  }
}
```

### Vellum

```bash
assistant mcp add com-hovercode-mcp -t streamable-http -u 'https://hovercode.com/mcp/'
```

### Other

```json
{
  "mcpServers": {
    "com-hovercode-mcp": {
      "type": "http",
      "url": "https://hovercode.com/mcp/"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-21 (score 84, +1)

No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-18 (score 83, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-17 (score 82, 0)

- [security] Resource “Hovercode QR card” now points somewhere else: ui://hovercode/qr.html?v=1 → ui://hovercode/qr-chatgpt.html?v=1
- [security] The server rewrote its instructions, which are the text every model session reads
- [functional regression] Schema quality: 186 → 210
- [cosmetic] “build_page” added an optional parameter “eye_color”
- [cosmetic] “build_page” added an optional parameter “frame_color”
- [cosmetic] “create_form” added an optional parameter “eye_color”
- [cosmetic] “create_form” added an optional parameter “frame_color”
- [cosmetic] “create_page” added an optional parameter “eye_color”
- [cosmetic] “create_page” added an optional parameter “frame_color”
- [cosmetic] “create_qr_code” added an optional parameter “eye_color”
- [cosmetic] “create_qr_code” added an optional parameter “frame_color”
- [cosmetic] “create_qr_codes_bulk” added an optional parameter “eye_color”
- [cosmetic] “create_qr_codes_bulk” added an optional parameter “frame_color”
- [cosmetic] “update_qr_code” added an optional parameter “eye_color”
- [cosmetic] “update_qr_code” added an optional parameter “frame_color”
- [cosmetic] “build_page” reworded the description of “eye_style”
- [cosmetic] “build_page” reworded the description of “frame”
- [cosmetic] “build_page” reworded the description of “primary_color”
- [cosmetic] “build_page” reworded the description of “text”
- [cosmetic] “create_form” reworded the description of “eye_style”
- [cosmetic] “create_form” reworded the description of “frame”
- [cosmetic] “create_form” reworded the description of “primary_color”
- [cosmetic] “create_form” reworded the description of “text”
- [cosmetic] “create_page” reworded the description of “eye_style”
- [cosmetic] “create_page” reworded the description of “frame”
- [cosmetic] “create_page” reworded the description of “primary_color”
- [cosmetic] “create_page” reworded the description of “text”
- [cosmetic] “create_qr_code” reworded the description of “eye_style”
- [cosmetic] “create_qr_code” reworded the description of “frame”
- [cosmetic] “create_qr_code” reworded the description of “primary_color”
- [cosmetic] “create_qr_code” reworded the description of “text”
- [cosmetic] “create_qr_codes_bulk” reworded the description of “eye_style”
- [cosmetic] “create_qr_codes_bulk” reworded the description of “frame”
- [cosmetic] “create_qr_codes_bulk” reworded the description of “primary_color”
- [cosmetic] “create_qr_codes_bulk” reworded the description of “text”
- [cosmetic] “update_qr_code” reworded the description of “eye_style”
- [cosmetic] “update_qr_code” reworded the description of “frame”
- [cosmetic] “update_qr_code” reworded the description of “primary_color”
- [cosmetic] “update_qr_code” reworded the description of “text”

### 2026-09-16 (score 82, +2)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “create_qr_code” rewrote its description, which is the text the model reads
- [security] Tool “create_short_link” rewrote its description, which is the text the model reads
- [security] Tool “build_page” rewrote its description, which is the text the model reads
- [security] Tool “create_form” rewrote its description, which is the text the model reads
- [security] Tool “create_page” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 155 → 186
- [functional improvement] Tool “create_pdf_qr” now declares an output schema
- [functional improvement] Tool “create_qr_code” now declares an output schema
- [functional improvement] Tool “create_qr_codes_bulk” now declares an output schema
- [functional improvement] Tool “create_short_link” now declares an output schema
- [functional improvement] Tool “delete_folder” now declares an output schema
- [functional improvement] Tool “delete_page” now declares an output schema
- [functional improvement] Tool “delete_qr_code” now declares an output schema
- [functional improvement] Tool “delete_short_link” now declares an output schema
- [functional improvement] Tool “get_analytics” now declares an output schema
- [functional improvement] Tool “get_form” now declares an output schema
- [functional improvement] Tool “get_form_responses” now declares an output schema
- [functional improvement] Tool “get_page” now declares an output schema
- [functional improvement] Tool “get_qr_activity” now declares an output schema
- [functional improvement] Tool “get_qr_code” now declares an output schema
- [functional improvement] Tool “get_short_link” now declares an output schema
- [functional improvement] Tool “get_short_link_activity” now declares an output schema
- [functional improvement] Tool “list_block_types” now declares an output schema
- [functional improvement] Tool “list_folders” now declares an output schema
- [functional improvement] Tool “list_forms” now declares an output schema
- [functional improvement] Tool “list_pages” now declares an output schema
- [functional improvement] Tool “list_qr_codes” now declares an output schema
- [functional improvement] Tool “list_short_links” now declares an output schema
- [functional improvement] Tool “list_tags” now declares an output schema
- [functional improvement] Tool “list_templates” now declares an output schema
- [functional improvement] Tool “list_workspaces” now declares an output schema
- [functional improvement] Tool “set_workspace” now declares an output schema
- [functional improvement] Tool “update_folder” now declares an output schema
- [functional improvement] Tool “update_form” now declares an output schema
- [functional improvement] Tool “update_page” now declares an output schema
- [functional improvement] Tool “update_qr_code” now declares an output schema
- [functional improvement] Tool “update_short_link” now declares an output schema
- [functional improvement] Tool “download_qr” now declares an output schema
- [functional improvement] Tool “build_page” now declares an output schema
- [functional improvement] Tool “create_folder” now declares an output schema
- [functional improvement] Tool “create_form” now declares an output schema
- [functional improvement] Tool “create_page” now declares an output schema
- [functional] The server now declares the “resources” capability
- [functional] First check of Capabilities: pass
- [functional] First check of Schema quality: 100
- [functional] First check of Tool coverage: 100
- [functional] New resource “Hovercode QR card”
- [cosmetic] “update_qr_code” added an optional parameter “logo_base64”
- [cosmetic] “build_page” added an optional parameter “background_color”
- [cosmetic] “build_page” added an optional parameter “error_correction”
- [cosmetic] “build_page” added an optional parameter “eye_style”
- [cosmetic] “build_page” added an optional parameter “frame”
- [cosmetic] “build_page” added an optional parameter “has_border”
- [cosmetic] “build_page” added an optional parameter “logo_url”
- [cosmetic] “build_page” added an optional parameter “pattern”
- [cosmetic] “build_page” added an optional parameter “primary_color”
- [cosmetic] “build_page” added an optional parameter “text”
- [cosmetic] “build_page” added an optional parameter “text_secondary”
- [cosmetic] “create_form” added an optional parameter “background_color”
- [cosmetic] “create_form” added an optional parameter “error_correction”
- [cosmetic] “create_form” added an optional parameter “eye_style”
- [cosmetic] “create_form” added an optional parameter “frame”
- [cosmetic] “create_form” added an optional parameter “has_border”
- [cosmetic] “create_form” added an optional parameter “pattern”
- [cosmetic] “create_form” added an optional parameter “primary_color”
- [cosmetic] “create_form” added an optional parameter “text”
- [cosmetic] “create_form” added an optional parameter “text_secondary”
- [cosmetic] “create_page” added an optional parameter “background_color”
- [cosmetic] “create_page” added an optional parameter “error_correction”
- [cosmetic] “create_page” added an optional parameter “eye_style”
- [cosmetic] “create_page” added an optional parameter “frame”
- [cosmetic] “create_page” added an optional parameter “has_border”
- [cosmetic] “create_page” added an optional parameter “logo_url”
- [cosmetic] “create_page” added an optional parameter “pattern”
- [cosmetic] “create_page” added an optional parameter “primary_color”
- [cosmetic] “create_page” added an optional parameter “text”
- [cosmetic] “create_page” added an optional parameter “text_secondary”

### 2026-09-15 (score 80, +1)

No change was recorded against any check on this day. Stability & Change Management went from 13 to 17. That category is still filling its 30-day observation window: 4 days of observed history at the previous scan, 5 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-13 (score 79, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-11 (score 78, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-09-10 (score 77)

First indexed and scored.

## MCP tools (36)

### `list_workspaces` (~51 tokens)

List the workspaces this account can access, with their ids; the current (default) one is marked. Tools default to the current workspace, so you only need `workspace` to target a different one.

Output parameters:

- `current_workspace` (string): Id of the workspace tools default to.
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `workspaces` (array)

### `create_qr_code` (~733 tokens)

Create a Hovercode QR code and return its details plus a rendered PNG. Set `dynamic: true` for a code whose destination can be changed later and whose scans are tracked (requires a paid plan); static codes are free and encode the data directly. Supports full design control (colors, pattern, eye style, frames with captions, logo). Not for Hovercode forms, pages, or short links: those already have their own QR code (returned as `qr_id` / `id`) — use download_qr or update_qr_code with that id instead.

Input parameters:

- `background_color` (string): Hex background color, or 'transparent'.
- `display_name` (string): Internal name to find this code later.
- `dynamic` (boolean): Editable + tracked destination (paid). Default false.
- `error_correction` (string): QR error correction level: L, M, Q, or H (higher tolerates more damage but is denser).
- `eye_color` (string): Hex color for the corner eyes, if different from `primary_color` (which they follow by default).
- `eye_style` (string): Corner eye shape.
- `folder` (string): Folder id or slug to file the new code into (list_qr_codes shows each code's folder).
- `frame` (string): Frame slug. A caption (`text`) works on any frame — set `text` without a `frame` and one that can show it is chosen automatically. Frames that show a caption: card, card-above, speech-bubble, speech-…
- `frame_color` (string): Hex color for the frame, if different from `primary_color` (which it follows by default).
- `gps_tracking` (boolean): Prompt scanners to share location (dynamic codes).
- `has_border` (boolean): Draw a border around the code.
- `logo_url` (string): URL of a logo image to place in the center.
- `pattern` (string): Module pattern style.
- `primary_color` (string): Hex color for the QR pattern, e.g. #111111. Eyes and frame follow this automatically — one color request styles the whole code; only set `eye_color`/`frame_color` for a code that should use a *differ…
- `qr_data` (string, required): What the code encodes: a URL for qr_type 'Link', or the text for qr_type 'Text'. For 'vCard' send `vcard` instead.
- `qr_type` (string): QR content type. Default 'Link'. 'vCard' encodes a contact card from `vcard`.
- `tags` (array): Labels to attach (created if new) so you can find these later — list_qr_codes and list_short_links search by tag.
- `template` (string): Workspace template id to apply as design defaults (list_templates).
- `text` (string): Caption text. Renders on any frame that supports one; if `frame` isn't also given (or the one given can't show text), a frame that can is chosen automatically.
- `text_secondary` (string): Secondary caption line, where the frame supports it.
- `vcard` (object): Contact details for qr_type 'vCard' (use instead of qr_data). Scanning saves the contact to the phone. `dynamic: true` makes the card editable later.
- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `background_color` (string|null)
- `created` (string)
- `display_name` (string|null)
- `dynamic` (boolean)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `error_correction` (string|null)
- `eye_color` (string|null)
- `eye_style` (string|null)
- `folder`
- `frame` (string|null)
- `frame_color` (string|null)
- `gps_tracking` (boolean)
- `has_border` (boolean)
- `id` (string)
- `logo` (string|null)
- `pattern` (string|null)
- `pdf_file_url` (string|null)
- `png` (string|null): PNG URL once rendered; null until then (use download_qr).
- `primary_color` (string|null)
- `qr_data` (string): Encoded data: the destination URL for URL codes.
- `qr_type` (string): Link, Text, vCard, or PDF.
- `shortlink_url` (string|null): Tracked short URL a dynamic code points at; null for static codes.
- `svg` (string|null): Rendered QR as SVG markup.
- `svg_file` (string|null)
- `tags` (array)
- `text` (string|null)
- `text_secondary` (string|null)
- `total_scans` (integer|null)
- `unique_scans` (integer|null)
- `vcard`

### `build_page` (~730 tokens)

Build a rich, on-brand landing page from an ordered list of typed blocks, publish it, and return its live URL + its own QR code (`qr_id`; style it with the QR design args here, restyle later with update_qr_code — don't create another). This is the 'make me a page for X' tool — e.g. an event, product, restaurant, link-in-bio, or a scan-to-enter sweepstakes. Each block is {type, content}; call list_block_types first to see every type and its content shape. Blocks render in order in a centered column; a 'header' block (name/bio/photo) is the profile.

Input parameters:

- `background_color` (string): For the QR code this mints: Hex background color, or 'transparent'.
- `bg_color` (string): Hex page background color.
- `blocks` (array, required): Ordered page blocks. Each is {type, content}. See list_block_types.
- `description` (string): Optional SEO/description text.
- `domain` (string): Custom domain (else a default is used).
- `error_correction` (string): For the QR code this mints: QR error correction level: L, M, Q, or H (higher tolerates more damage but is denser).
- `eye_color` (string): For the QR code this mints: Hex color for the corner eyes, if different from `primary_color` (which they follow by default).
- `eye_style` (string): For the QR code this mints: Corner eye shape.
- `frame` (string): For the QR code this mints: Frame slug. A caption (`text`) works on any frame — set `text` without a `frame` and one that can show it is chosen automatically. Frames that show a caption: card, card-a…
- `frame_color` (string): For the QR code this mints: Hex color for the frame, if different from `primary_color` (which it follows by default).
- `has_border` (boolean): For the QR code this mints: Draw a border around the code.
- `logo_url` (string): For the QR code this mints: URL of a logo image to place in the center.
- `pattern` (string): For the QR code this mints: Module pattern style.
- `primary_color` (string): For the QR code this mints: Hex color for the QR pattern, e.g. #111111. Eyes and frame follow this automatically — one color request styles the whole code; only set `eye_color`/`frame_color` for a co…
- `publish` (boolean): Publish immediately (default true). false leaves it a draft.
- `slug` (string): Custom URL slug (else auto-generated).
- `text` (string): For the QR code this mints: Caption text. Renders on any frame that supports one; if `frame` isn't also given (or the one given can't show text), a frame that can is chosen automatically.
- `text_color` (string): Hex text color.
- `text_secondary` (string): For the QR code this mints: Secondary caption line, where the frame supports it.
- `title` (string, required): The page title (browser tab + SEO).
- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `blocks` (integer): Number of blocks on the page.
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `id` (string)
- `published` (boolean)
- `qr_id` (string|null)
- `share_url` (string|null)
- `slug` (string|null)
- `workspace` (string)

### `create_form` (~902 tokens)

Create a form, define its fields, brand it, publish it, and return a shareable short link + QR in one step. Use for 'make me a form to collect X, give me a link and QR to share it'. The result's `share_url` is the public link and `qr_id` is the form's own dynamic QR code (image included) — never call create_qr_code or create_short_link for a form's link; pass QR design args (primary_color, eye_style, frame, logo_url, …) here to style that code in the same call. Supports on-brand styling (theme/colors/logo), a `redirect_url` after submit, conditional logic (`show_when` on a field) and branching endings (`outcomes`), and a custom domain/slug. Publishing mints a dynamic short link and QR (requires a paid plan). Notifications are a separate, paid, verified-member setting. To change a form later, use update_form.

Input parameters:

- `background_color` (string): For the QR code this mints: Hex background color, or 'transparent'.
- `bg_color` (string): Hex background color.
- `button_color` (string): Hex submit-button color.
- `button_text_color` (string): Hex button-text color.
- `description` (string): Optional description shown above the fields.
- `domain` (string): Custom domain to publish on (else a default is used).
- `error_correction` (string): For the QR code this mints: QR error correction level: L, M, Q, or H (higher tolerates more damage but is denser).
- `eye_color` (string): For the QR code this mints: Hex color for the corner eyes, if different from `primary_color` (which they follow by default).
- `eye_style` (string): For the QR code this mints: Corner eye shape.
- `fields` (array, required): The fields to collect, in order.
- `frame` (string): For the QR code this mints: Frame slug. A caption (`text`) works on any frame — set `text` without a `frame` and one that can show it is chosen automatically. Frames that show a caption: card, card-a…
- `frame_color` (string): For the QR code this mints: Hex color for the frame, if different from `primary_color` (which it follows by default).
- `has_border` (boolean): For the QR code this mints: Draw a border around the code.
- `logo_url` (string): URL of a logo image (JPEG/PNG/GIF/WebP) to show on the form.
- `outcomes` (array): Pathways / branching endings. After submit the first outcome whose rules match decides the ending: its own thank-you title/message and/or a redirect_url (e.g. send people to a different product page…
- `pattern` (string): For the QR code this mints: Module pattern style.
- `primary_color` (string): For the QR code this mints: Hex color for the QR pattern, e.g. #111111. Eyes and frame follow this automatically — one color request styles the whole code; only set `eye_color`/`frame_color` for a co…
- `redirect_url` (string): URL to send respondents to after they submit.
- `slug` (string): Custom short-link slug (else auto-generated).
- `text` (string): For the QR code this mints: Caption text. Renders on any frame that supports one; if `frame` isn't also given (or the one given can't show text), a frame that can is chosen automatically.
- `text_color` (string): Hex text color.
- `text_secondary` (string): For the QR code this mints: Secondary caption line, where the frame supports it.
- `thank_you_message` (string): Shown after submitting (if no redirect).
- `theme` (string): Named color preset. Explicit colors below override it.
- `title` (string, required): The form's title.
- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `allow_multiple_submissions` (boolean)
- `bg_color` (string|null)
- `button_color` (string|null)
- `button_text_color` (string|null)
- `created` (string)
- `dashboard_url` (string): Where the owner manages the form on hovercode.com.
- `description` (string|null)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `fields` (array)
- `has_unpublished_changes` (boolean)
- `id` (string)
- `logo` (string|null)
- `modified` (string)
- `notification_recipients` (array)
- `outcomes` (array)
- `qr_code_svg` (string|null): QR code for the share URL, as SVG markup.
- `qr_id` (string|null): Id of the form's own QR code (published forms). Use with download_qr.
- `redirect_delay` (integer|null)
- `redirect_url` (string|null)
- `response_count` (integer)
- `share_url` (string|null): Public URL respondents open (null until published).
- `shortlink_domain` (string|null)
- `shortlink_slug` (string|null)
- `shortlink_url` (string|null)
- `show_powered_by` (boolean)
- `show_progress` (boolean)
- `status` (string): Draft, Published, or Closed.
- `text_color` (string|null)
- `thank_you_message` (string|null)
- `thank_you_title` (string|null)
- `title` (string)
- `workspace_id` (string)

### `get_analytics` (~227 tokens)

Scan analytics over a period: totals, unique scanners, scans-by-day, and top countries/cities/OS/browsers. Pass a QR code `id` for one code, or omit it for the whole workspace (which also returns the top codes). Use this to answer 'how did my codes do this month and where were people scanning?'.

Input parameters:

- `days` (integer): Look-back window in days (default 30, max 365).
- `end` (string): Range end, ISO date/datetime. Defaults to now when only `start` is given.
- `id` (string): QR code id for per-code analytics; omit for workspace-wide.
- `start` (string): Range start, ISO date or datetime (e.g. 2026-08-03 or 2026-08-03T14:00:00Z). Use start/end together for a fixed window instead of the rolling `days` look-back.
- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `end` (string)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `period_days` (integer)
- `qr_code_id` (string): Set when the report is for a single code.
- `scans_by_day` (array)
- `start` (string)
- `top_browsers` (array)
- `top_cities` (array)
- `top_codes` (array)
- `top_countries` (array)
- `top_os` (array)
- `total_scans` (integer)
- `unique_scans` (integer)
- `workspace` (string): Set when the report is workspace-wide.

### `list_qr_codes` (~241 tokens)

List QR codes in a workspace, newest first. Optional `query` searches destination, name, and tags. `folder` narrows to one folder, `include_tags` adds each code's tags (its folder is always shown), and `include_scans` adds scan counts — use it instead of calling get_analytics once per code.

Input parameters:

- `folder` (string): Folder id or slug to filter by, or 'none' for codes in no folder.
- `include_scans` (boolean): Add total_scans and unique_scans (lifetime) to each code.
- `include_tags` (boolean): Add each code's tags. (Each code's folder is always included.)
- `page` (integer): 1-based page number.
- `page_size` (integer): Results per page (max 200, default 25).
- `query` (string): Search term (destination, display name, or tag).
- `subfolders` (boolean): With `folder`, also include codes in its subfolders.
- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `count` (integer): Total matching rows across all pages.
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `next` (string|null): URL of the next page, or null on the last page.
- `previous` (string|null)
- `results` (array)

### `create_short_link` (~226 tokens)

Create a tracked short link for a URL. It comes with its own QR code (same id; use download_qr). Supports a custom slug and a custom domain. The destination can be changed later with update_short_link, and clicks are tracked. Never shorten a link that is already a Hovercode short link, form link, or page link — those are already tracked and already have a QR code.

Input parameters:

- `display_name` (string): Internal name to find this link later.
- `domain` (string): Custom short-link domain; else a default is used.
- `gps` (boolean): Prompt visitors to share their location.
- `link` (string, required): The destination URL to shorten.
- `slug` (string): Custom slug (letters/numbers/hyphens) or auto-generated.
- `tags` (array): Labels to attach (created if new) so you can find these later — list_qr_codes and list_short_links search by tag.
- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `created` (string)
- `display_name` (string|null)
- `domain` (string)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `gps` (boolean)
- `id` (string)
- `link` (string): Destination URL.
- `link_type` (string)
- `png` (string|null)
- `short_url` (string)
- `slug` (string)
- `svg` (string|null): QR code for the short URL, as SVG markup.
- `total_clicks` (integer)
- `unique_clicks` (integer)

### `set_workspace` (~57 tokens)

Switch the current (default) workspace by id or name. New codes, forms, and pages are created in the current workspace unless a tool is given an explicit `workspace`.

Input parameters:

- `workspace` (string, required): Workspace id or name to switch to.

Output parameters:

- `current` (boolean)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `id` (string)
- `name` (string)

### `create_qr_codes_bulk` (~581 tokens)

Create many QR codes at once from a list — e.g. 'make codes for these 20 product URLs in our brand colors'. All codes share the design/options you pass (colors, pattern, frame, dynamic, template). Returns the created codes and any per-item errors. Max 100 per call.

Input parameters:

- `background_color` (string): Hex background color, or 'transparent'.
- `dynamic` (boolean): Make all of them editable + tracked (paid).
- `error_correction` (string): QR error correction level: L, M, Q, or H (higher tolerates more damage but is denser).
- `eye_color` (string): Hex color for the corner eyes, if different from `primary_color` (which they follow by default).
- `eye_style` (string): Corner eye shape.
- `frame` (string): Frame slug. A caption (`text`) works on any frame — set `text` without a `frame` and one that can show it is chosen automatically. Frames that show a caption: card, card-above, speech-bubble, speech-…
- `frame_color` (string): Hex color for the frame, if different from `primary_color` (which it follows by default).
- `has_border` (boolean): Draw a border around the code.
- `idempotency_key` (string): Optional client key to make retries safe: if a previous call used the same key (same workspace), the earlier result is replayed instead of creating duplicate codes. Use a fresh key per distinct batch.
- `items` (array, required): URLs to encode. Each item is a URL string, or an object {url, display_name}.
- `logo_url` (string): URL of a logo image to place in the center.
- `pattern` (string): Module pattern style.
- `primary_color` (string): Hex color for the QR pattern, e.g. #111111. Eyes and frame follow this automatically — one color request styles the whole code; only set `eye_color`/`frame_color` for a code that should use a *differ…
- `tags` (array): Labels to attach (created if new) so you can find these later — list_qr_codes and list_short_links search by tag.
- `template` (string): Workspace template id to apply to all.
- `text` (string): Caption text. Renders on any frame that supports one; if `frame` isn't also given (or the one given can't show text), a frame that can is chosen automatically.
- `text_secondary` (string): Secondary caption line, where the frame supports it.
- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `created` (array)
- `created_count` (integer)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `errors` (array)
- `failed_count` (integer)

### `download_qr` (~55 tokens)

Get downloadable, print-ready image links for a QR code — a high-resolution PNG and a vector SVG (best for print/large sizes). Returns URLs you can share or save.

Input parameters:

- `id` (string, required): QR code id.

Output parameters:

- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `id` (string)
- `png_url` (string|null): Print-ready PNG; null if rendering failed.
- `svg_url` (string|null)

### `create_pdf_qr` (~257 tokens)

Create a dynamic QR code and short link for a PDF (menus, flyers, tickets). Host the PDF by passing `pdf_url` (a link Hovercode fetches) or `pdf_base64` (the file's base64 bytes). Returns a shareable short link plus a rendered QR. Because it's dynamic you can later swap the PDF without reprinting the code. Requires a paid plan (dynamic codes).

Input parameters:

- `display_name` (string): Internal name to find this code later.
- `domain` (string): Custom short-link domain (list_workspaces shows the plan).
- `filename` (string): Name for the stored file, e.g. 'menu.pdf'.
- `pdf_base64` (string): Base64-encoded PDF bytes (data-URI prefix allowed), max 20 MB. Or use pdf_url.
- `pdf_url` (string): URL of a PDF to fetch and host. Use this or pdf_base64.
- `tags` (array): Labels to attach (created if new) so you can find these later — list_qr_codes and list_short_links search by tag.
- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `background_color` (string|null)
- `created` (string)
- `display_name` (string|null)
- `dynamic` (boolean)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `error_correction` (string|null)
- `eye_color` (string|null)
- `eye_style` (string|null)
- `folder`
- `frame` (string|null)
- `frame_color` (string|null)
- `gps_tracking` (boolean)
- `has_border` (boolean)
- `id` (string)
- `logo` (string|null)
- `pattern` (string|null)
- `pdf_file_url` (string|null)
- `png` (string|null): PNG URL once rendered; null until then (use download_qr).
- `primary_color` (string|null)
- `qr_data` (string): Encoded data: the destination URL for URL codes.
- `qr_type` (string): Link, Text, vCard, or PDF.
- `shortlink_url` (string|null): Tracked short URL a dynamic code points at; null for static codes.
- `svg` (string|null): Rendered QR as SVG markup.
- `svg_file` (string|null)
- `tags` (array)
- `text` (string|null)
- `text_secondary` (string|null)
- `total_scans` (integer|null)
- `unique_scans` (integer|null)
- `vcard`

### `get_qr_code` (~40 tokens)

Get one QR code's details and scan analytics (total and unique scans), plus a rendered PNG.

Input parameters:

- `id` (string, required): QR code id.

Output parameters:

- `background_color` (string|null)
- `created` (string)
- `display_name` (string|null)
- `dynamic` (boolean)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `error_correction` (string|null)
- `eye_color` (string|null)
- `eye_style` (string|null)
- `folder`
- `frame` (string|null)
- `frame_color` (string|null)
- `gps_tracking` (boolean)
- `has_border` (boolean)
- `id` (string)
- `logo` (string|null)
- `pattern` (string|null)
- `pdf_file_url` (string|null)
- `png` (string|null): PNG URL once rendered; null until then (use download_qr).
- `primary_color` (string|null)
- `qr_data` (string): Encoded data: the destination URL for URL codes.
- `qr_type` (string): Link, Text, vCard, or PDF.
- `shortlink_url` (string|null): Tracked short URL a dynamic code points at; null for static codes.
- `svg` (string|null): Rendered QR as SVG markup.
- `svg_file` (string|null)
- `tags` (array)
- `text` (string|null)
- `text_secondary` (string|null)
- `total_scans` (integer|null)
- `unique_scans` (integer|null)
- `vcard`

### `update_qr_code` (~665 tokens)

Update a QR code in place — the same code keeps working, so it's safe for already-printed codes. Changing `qr_data` retargets a DYNAMIC code's destination. Design fields (colors, pattern, eye style, frame, logo) restyle the code WITHOUT replacing it. Also supports renaming, toggling location tracking, moving it into a folder (`folder`, or 'none' to unfile), and adding/removing tags. Returns the re-rendered QR so you can preview the result. Any combination works in one call.

Input parameters:

- `add_tags` (array): Tag titles to add (created in the workspace if new).
- `background_color` (string): Hex background color, or 'transparent'.
- `display_name` (string): New internal name.
- `error_correction` (string): QR error correction level: L, M, Q, or H (higher tolerates more damage but is denser).
- `eye_color` (string): Hex color for the corner eyes, if different from `primary_color` (which they follow by default).
- `eye_style` (string): Corner eye shape.
- `folder` (string): Move the code into this folder (id or slug from list_folders); 'none' unfiles it.
- `frame` (string): Frame slug. A caption (`text`) works on any frame — set `text` without a `frame` and one that can show it is chosen automatically. Frames that show a caption: card, card-above, speech-bubble, speech-…
- `frame_color` (string): Hex color for the frame, if different from `primary_color` (which it follows by default).
- `gps_tracking` (boolean): Enable/disable location prompt.
- `has_border` (boolean): Draw a border around the code.
- `id` (string, required): QR code id.
- `logo_base64` (string): A logo image as base64 (JPEG/PNG/GIF/WebP, under 2 MB; a data: URI prefix is fine) to place in the center — use when you have the file rather than a URL.
- `logo_round` (boolean): Force the logo into a circle.
- `logo_url` (string): URL of a logo image to place in the center.
- `pattern` (string): Module pattern style.
- `primary_color` (string): Hex color for the QR pattern, e.g. #111111. Eyes and frame follow this automatically — one color request styles the whole code; only set `eye_color`/`frame_color` for a code that should use a *differ…
- `qr_data` (string): New destination URL/text (dynamic codes only).
- `remove_logo` (boolean): Remove the code's logo.
- `remove_tags` (array): Tags to remove from this code, by title, slug, or id.
- `text` (string): Caption text. Renders on any frame that supports one; if `frame` isn't also given (or the one given can't show text), a frame that can is chosen automatically.
- `text_secondary` (string): Secondary caption line, where the frame supports it.

Output parameters:

- `background_color` (string|null)
- `created` (string)
- `display_name` (string|null)
- `dynamic` (boolean)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `error_correction` (string|null)
- `eye_color` (string|null)
- `eye_style` (string|null)
- `folder`
- `frame` (string|null)
- `frame_color` (string|null)
- `gps_tracking` (boolean)
- `has_border` (boolean)
- `id` (string)
- `logo` (string|null)
- `pattern` (string|null)
- `pdf_file_url` (string|null)
- `png` (string|null): PNG URL once rendered; null until then (use download_qr).
- `primary_color` (string|null)
- `qr_data` (string): Encoded data: the destination URL for URL codes.
- `qr_type` (string): Link, Text, vCard, or PDF.
- `shortlink_url` (string|null): Tracked short URL a dynamic code points at; null for static codes.
- `svg` (string|null): Rendered QR as SVG markup.
- `svg_file` (string|null)
- `tags` (array)
- `text` (string|null)
- `text_secondary` (string|null)
- `total_scans` (integer|null)
- `unique_scans` (integer|null)
- `vcard`

### `delete_qr_code` (~33 tokens)

Delete a QR code. Dynamic codes stop redirecting after deletion.

Input parameters:

- `id` (string, required): QR code id.

Output parameters:

- `deleted` (boolean)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `id` (string)

### `get_qr_activity` (~164 tokens)

List recent scan events for a dynamic QR code (time, location, device). Use this to answer questions like where or when a code was scanned.

Input parameters:

- `end` (string): Range end, ISO date/datetime. Defaults to now when only `start` is given.
- `id` (string, required): QR code id.
- `page` (integer): 1-based page number.
- `page_size` (integer): Events per page (max 200, default 25).
- `start` (string): Range start, ISO date or datetime (e.g. 2026-08-03 or 2026-08-03T14:00:00Z). Use start/end together for a fixed window instead of the rolling `days` look-back.

Output parameters:

- `count` (integer): Total matching rows across all pages.
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `next` (string|null): URL of the next page, or null on the last page.
- `previous` (string|null)
- `results` (array)

### `list_templates` (~56 tokens)

List the workspace's saved QR design templates. Pass a template id to create_qr_code to reuse its branding.

Input parameters:

- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `count` (integer): Total matching rows across all pages.
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `next` (string|null): URL of the next page, or null on the last page.
- `previous` (string|null)
- `results` (array)

### `list_folders` (~84 tokens)

List the workspace's folders with their full path, code count, id and slug. Use a folder's id or slug with create_qr_code / update_qr_code (`folder`) to file codes, or with list_qr_codes to filter.

Input parameters:

- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `count` (integer): Total matching rows across all pages.
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `next` (string|null): URL of the next page, or null on the last page.
- `previous` (string|null)
- `results` (array)

### `create_folder` (~98 tokens)

Create a folder to organise QR codes, optionally nested under a parent. Creating a folder that already exists (same name, same parent) returns the existing one, so it's safe to call repeatedly.

Input parameters:

- `name` (string, required): Folder name.
- `parent` (string): Parent folder id or slug to nest under (optional).
- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `code_count` (integer)
- `created` (string)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `id` (string)
- `name` (string)
- `parent` (string|null): Parent folder id, null at the top level.
- `path` (string): Full path, e.g. Campaigns / Spring 2026.
- `slug` (string)

### `update_folder` (~83 tokens)

Rename a folder and/or move it under another folder. `parent` 'none' moves it to the top level. Codes inside keep their filing.

Input parameters:

- `id` (string, required): Folder id (from list_folders).
- `name` (string): New folder name.
- `parent` (string): New parent folder id or slug, or 'none' for top level.

Output parameters:

- `code_count` (integer)
- `created` (string)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `id` (string)
- `name` (string)
- `parent` (string|null): Parent folder id, null at the top level.
- `path` (string): Full path, e.g. Campaigns / Spring 2026.
- `slug` (string)

### `delete_folder` (~57 tokens)

Delete a folder. The codes in it (and in its subfolders) are NOT deleted — they become unfiled — and its subfolders move up to its parent.

Input parameters:

- `id` (string, required): Folder id (from list_folders).

Output parameters:

- `deleted` (boolean)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `id` (string)

### `list_tags` (~78 tokens)

List the workspace's tags (title + id). Tags are attached with create_qr_code (`tags`) or update_qr_code (`add_tags` / `remove_tags`), and list_qr_codes searches by tag.

Input parameters:

- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `count` (integer): Total matching rows across all pages.
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `next` (string|null): URL of the next page, or null on the last page.
- `previous` (string|null)
- `results` (array)

### `update_form` (~361 tokens)

Change an existing form without recreating it: edit its fields, settings (redirect, thank-you, title), or branding (theme/colors/logo), or close/reopen it. If you pass `fields`, provide the COMPLETE desired list — include each existing field's `id` (from get_form) to keep it; omit a field to remove it; leave `id` off a new field. If the form is already published, edits are re-published so they go live.

Input parameters:

- `bg_color` (string): Hex background color.
- `button_color` (string): Hex submit-button color.
- `button_text_color` (string): Hex button-text color.
- `description` (string): New description.
- `fields` (array): Complete desired field list (see note); create_form shape plus an optional `id`.
- `id` (string, required): Form id.
- `logo_url` (string): URL of a logo image (JPEG/PNG/GIF/WebP) to show on the form.
- `outcomes` (array): Pathways / branching endings. After submit the first outcome whose rules match decides the ending: its own thank-you title/message and/or a redirect_url (e.g. send people to a different product page…
- `redirect_url` (string): URL to send respondents to after they submit.
- `status` (string): Close (stop responses) or reopen. When set, other edits are ignored.
- `text_color` (string): Hex text color.
- `thank_you_message` (string): Shown after submitting (if no redirect).
- `theme` (string): Named color preset. Explicit colors below override it.
- `title` (string): New title.

Output parameters:

- `allow_multiple_submissions` (boolean)
- `bg_color` (string|null)
- `button_color` (string|null)
- `button_text_color` (string|null)
- `created` (string)
- `dashboard_url` (string): Where the owner manages the form on hovercode.com.
- `description` (string|null)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `fields` (array)
- `has_unpublished_changes` (boolean)
- `id` (string)
- `logo` (string|null)
- `modified` (string)
- `notification_recipients` (array)
- `outcomes` (array)
- `qr_code_svg` (string|null): QR code for the share URL, as SVG markup.
- `qr_id` (string|null): Id of the form's own QR code (published forms). Use with download_qr.
- `redirect_delay` (integer|null)
- `redirect_url` (string|null)
- `response_count` (integer)
- `share_url` (string|null): Public URL respondents open (null until published).
- `shortlink_domain` (string|null)
- `shortlink_slug` (string|null)
- `shortlink_url` (string|null)
- `show_powered_by` (boolean)
- `show_progress` (boolean)
- `status` (string): Draft, Published, or Closed.
- `text_color` (string|null)
- `thank_you_message` (string|null)
- `thank_you_title` (string|null)
- `title` (string)
- `workspace_id` (string)

### `list_forms` (~96 tokens)

List the forms in a workspace, newest first. Optional `query` searches by title.

Input parameters:

- `page` (integer): 1-based page number.
- `page_size` (integer): Results per page (max 100, default 25).
- `query` (string): Search term (matches the form title).
- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `count` (integer): Total matching rows across all pages.
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `next` (string|null): URL of the next page, or null on the last page.
- `previous` (string|null)
- `results` (array)

### `get_form` (~34 tokens)

Get one form's details: status, response count, share link, and QR.

Input parameters:

- `id` (string, required): Form id.

Output parameters:

- `allow_multiple_submissions` (boolean)
- `bg_color` (string|null)
- `button_color` (string|null)
- `button_text_color` (string|null)
- `created` (string)
- `dashboard_url` (string): Where the owner manages the form on hovercode.com.
- `description` (string|null)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `fields` (array)
- `has_unpublished_changes` (boolean)
- `id` (string)
- `logo` (string|null)
- `modified` (string)
- `notification_recipients` (array)
- `outcomes` (array)
- `qr_code_svg` (string|null): QR code for the share URL, as SVG markup.
- `qr_id` (string|null): Id of the form's own QR code (published forms). Use with download_qr.
- `redirect_delay` (integer|null)
- `redirect_url` (string|null)
- `response_count` (integer)
- `share_url` (string|null): Public URL respondents open (null until published).
- `shortlink_domain` (string|null)
- `shortlink_slug` (string|null)
- `shortlink_url` (string|null)
- `show_powered_by` (boolean)
- `show_progress` (boolean)
- `status` (string): Draft, Published, or Closed.
- `text_color` (string|null)
- `thank_you_message` (string|null)
- `thank_you_title` (string|null)
- `title` (string)
- `workspace_id` (string)

### `get_form_responses` (~88 tokens)

List a form's submissions (newest first) so you can read or summarize them — e.g. 'summarize this week's feedback' or 'any complaints in the responses?'.

Input parameters:

- `id` (string, required): Form id.
- `page` (integer): 1-based page number.
- `page_size` (integer): Responses per page (max 100, default 25).

Output parameters:

- `count` (integer): Total matching rows across all pages.
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `message` (string): Set when there are no responses yet.
- `next` (string|null): URL of the next page, or null on the last page.
- `previous` (string|null)
- `results` (array)

### `create_page` (~656 tokens)

Create a published micro landing page (link-in-bio style) with a title and a list of links, and return its live URL (`share_url`) + its own QR code (`qr_id`; style it with the QR design args here; don't create another). Use this for 'make me a page with these links and a QR to share it'. The page is a dynamic destination you can keep; it counts toward the workspace's page limit.

Input parameters:

- `background_color` (string): For the QR code this mints: Hex background color, or 'transparent'.
- `bg_color` (string): Hex background color.
- `description` (string): Optional text shown under the title.
- `domain` (string): Custom page domain (else a default is used).
- `error_correction` (string): For the QR code this mints: QR error correction level: L, M, Q, or H (higher tolerates more damage but is denser).
- `eye_color` (string): For the QR code this mints: Hex color for the corner eyes, if different from `primary_color` (which they follow by default).
- `eye_style` (string): For the QR code this mints: Corner eye shape.
- `frame` (string): For the QR code this mints: Frame slug. A caption (`text`) works on any frame — set `text` without a `frame` and one that can show it is chosen automatically. Frames that show a caption: card, card-a…
- `frame_color` (string): For the QR code this mints: Hex color for the frame, if different from `primary_color` (which it follows by default).
- `has_border` (boolean): For the QR code this mints: Draw a border around the code.
- `links` (array): The link buttons on the page, in order.
- `logo_url` (string): For the QR code this mints: URL of a logo image to place in the center.
- `pattern` (string): For the QR code this mints: Module pattern style.
- `primary_color` (string): For the QR code this mints: Hex color for the QR pattern, e.g. #111111. Eyes and frame follow this automatically — one color request styles the whole code; only set `eye_color`/`frame_color` for a co…
- `slug` (string): Custom URL slug (else auto-generated).
- `text` (string): For the QR code this mints: Caption text. Renders on any frame that supports one; if `frame` isn't also given (or the one given can't show text), a frame that can is chosen automatically.
- `text_color` (string): Hex text color.
- `text_secondary` (string): For the QR code this mints: Secondary caption line, where the frame supports it.
- `title` (string, required): The page's heading.
- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `blocks` (array): Block list; present for layout_version 2 pages.
- `created` (string)
- `description` (string|null)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `id` (string)
- `layout_version` (integer): 1 = legacy links list, 2 = block builder.
- `links` (array)
- `qr_id` (string|null): The page's QR code id (use with download_qr / update_qr_code).
- `share_url` (string|null): Live URL of the page.
- `slug` (string|null)
- `status` (string)
- `svg` (string|null)
- `title` (string)

### `get_page` (~51 tokens)

Get one landing page's details: status, live URL, QR, and its blocks (each block's id + type) so you can edit it with update_page.

Input parameters:

- `id` (string, required): Page id.

Output parameters:

- `blocks` (array): Block list; present for layout_version 2 pages.
- `created` (string)
- `description` (string|null)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `id` (string)
- `layout_version` (integer): 1 = legacy links list, 2 = block builder.
- `links` (array)
- `qr_id` (string|null): The page's QR code id (use with download_qr / update_qr_code).
- `share_url` (string|null): Live URL of the page.
- `slug` (string|null)
- `status` (string)
- `svg` (string|null)
- `title` (string)

### `update_page` (~238 tokens)

Change an existing landing page without recreating it: edit its blocks, title, description, or colors, and publish/unpublish it. Use for 'fix the typo on my page', 'add a section', or 'take the page down'. If you pass `blocks`, provide the COMPLETE desired list (same {type, content} shape as build_page; include each block's `id` from get_page to keep it, omit to remove) — leaving `blocks` off keeps the existing blocks untouched. If the page is already published, edits are re-published so they go live; pass publish:false to take it offline.

Input parameters:

- `bg_color` (string): Hex page background color.
- `blocks` (array): Complete desired block list (see note); each is {type, content} + optional id.
- `description` (string): New SEO/description text.
- `id` (string, required): Page id.
- `publish` (boolean): true = publish/re-publish so edits go live; false = take offline (draft).
- `text_color` (string): Hex text color.
- `title` (string): New page title.

Output parameters:

- `blocks` (array)
- `design` (object)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `id` (string)
- `layout_version` (integer)
- `publish` (object)

### `delete_page` (~50 tokens)

Delete a landing page. Its live URL stops serving and it leaves the workspace's page list. Use for 'delete that page' / 'remove the landing page'.

Input parameters:

- `id` (string, required): Page id.

Output parameters:

- `deleted` (boolean)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `id` (string)

### `list_pages` (~44 tokens)

List the landing pages in a workspace, newest first.

Input parameters:

- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `count` (integer): Total matching rows across all pages.
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `next` (string|null): URL of the next page, or null on the last page.
- `previous` (string|null)
- `results` (array)

### `list_block_types` (~66 tokens)

List the page BLOCK TYPES available to build_page, each with its content JSON Schema. Call this first when composing a rich page so you know the vocabulary (header, link, text, image, button, video, gallery, faq, countdown, socials, divider, form, …).

Output parameters:

- `block_types` (array)
- `error` (object): Present only when the tool failed (the result is also flagged isError).

### `get_short_link` (~34 tokens)

Get one short link's details, destination, click counts, and QR.

Input parameters:

- `id` (string, required): Short link id.

Output parameters:

- `created` (string)
- `display_name` (string|null)
- `domain` (string)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `gps` (boolean)
- `id` (string)
- `link` (string): Destination URL.
- `link_type` (string)
- `png` (string|null)
- `short_url` (string)
- `slug` (string)
- `svg` (string|null): QR code for the short URL, as SVG markup.
- `total_clicks` (integer)
- `unique_clicks` (integer)

### `list_short_links` (~103 tokens)

List short links in a workspace, newest first. Optional `query` searches URL, name, and slug.

Input parameters:

- `page` (integer): 1-based page number.
- `page_size` (integer): Results per page (max 200, default 25).
- `query` (string): Search term (destination, name, or slug).
- `workspace` (string): Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise.

Output parameters:

- `count` (integer): Total matching rows across all pages.
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `next` (string|null): URL of the next page, or null on the last page.
- `previous` (string|null)
- `results` (array)

### `update_short_link` (~89 tokens)

Update a short link. Changing `link` retargets it — the short URL keeps working, it just points somewhere new. Also supports renaming and toggling location tracking.

Input parameters:

- `display_name` (string): New internal name.
- `gps` (boolean): Enable/disable the location prompt.
- `id` (string, required): Short link id.
- `link` (string): New destination URL.

Output parameters:

- `created` (string)
- `display_name` (string|null)
- `domain` (string)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `gps` (boolean)
- `id` (string)
- `link` (string): Destination URL.
- `link_type` (string)
- `png` (string|null)
- `short_url` (string)
- `slug` (string)
- `svg` (string|null): QR code for the short URL, as SVG markup.
- `total_clicks` (integer)
- `unique_clicks` (integer)

### `delete_short_link` (~31 tokens)

Delete a short link. It stops redirecting after deletion.

Input parameters:

- `id` (string, required): Short link id.

Output parameters:

- `deleted` (boolean)
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `id` (string)

### `get_short_link_activity` (~149 tokens)

List recent click events for a short link (time, location, device).

Input parameters:

- `end` (string): Range end, ISO date/datetime. Defaults to now when only `start` is given.
- `id` (string, required): Short link id.
- `page` (integer): 1-based page number.
- `page_size` (integer): Events per page (max 200, default 25).
- `start` (string): Range start, ISO date or datetime (e.g. 2026-08-03 or 2026-08-03T14:00:00Z). Use start/end together for a fixed window instead of the rolling `days` look-back.

Output parameters:

- `count` (integer): Total matching rows across all pages.
- `error` (object): Present only when the tool failed (the result is also flagged isError).
- `next` (string|null): URL of the next page, or null on the last page.
- `previous` (string|null)
- `results` (array)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-hovercode-mcp/hovercode#diagnostics

## Score history

- 2026-09-21: 84
- 2026-09-20: 83
- 2026-09-19: 83
- 2026-09-18: 83
- 2026-09-17: 82
- 2026-09-16: 82
- 2026-09-15: 80
- 2026-09-14: 79
- 2026-09-13: 79
- 2026-09-12: 78
- 2026-09-11: 78
- 2026-09-10: 77

## Common questions

### What is the Hovercode MCP server?

Hovercode is an MCP server listed in the public MCP registry as com.hovercode/mcp. Create and manage QR codes, short links, landing pages, and forms in your Hovercode workspace. This page covers its hosted endpoint (https://hovercode.com/mcp/).

### Is the Hovercode MCP server safe to use?

Hovercode scores 84 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Hovercode MCP server expose?

Hovercode exposes 36 tools: list_workspaces, create_qr_code, build_page, create_form, get_analytics, and 31 more. Their descriptions and schemas cost roughly 7,508 tokens of context every time the server is loaded.

### Does the Hovercode MCP server require authentication?

Yes. Hovercode asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.

### Is the Hovercode MCP server still maintained?

Hovercode is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://hovercode.com/mcp/
- Repository: https://github.com/Hovercode-Ltd/hovercode-mcp
- Website: https://hovercode.com/integrations/mcp/
- Changelog RSS feed: https://verifymcp.io/servers/com-hovercode-mcp/hovercode.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-hovercode-mcp/hovercode.json
- HTML version of this page: https://verifymcp.io/servers/com-hovercode-mcp/hovercode