Hovercode
REMOTE · HOVERCODE.COM · 2 COMPONENTS · SCANNED SEP 21
Create and manage QR codes, short links, landing pages, and forms in your Hovercode workspace.
Available components
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. How we score → Why this is hard to score →
Endpoint Security94
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- 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. View diagnostics → Pass
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
- The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents. View diagnostics → Partial
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability79
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (excellent).Pass
- 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. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management37
- Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 4 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 38 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities73
- Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28. See how to fix → Fail
- Supports UI / widget rendering.Pass
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.
remote · hovercode.com
claude mcp add --transport http com-hovercode-mcp 'https://hovercode.com/mcp/'
{
"mcpServers": {
"com-hovercode-mcp": {
"url": "https://hovercode.com/mcp/"
}
}
} {
"servers": {
"com-hovercode-mcp": {
"type": "http",
"url": "https://hovercode.com/mcp/"
}
}
} [mcp_servers.com-hovercode-mcp] url = "https://hovercode.com/mcp/"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"com-hovercode-mcp": {
"type": "remote",
"url": "https://hovercode.com/mcp/",
"enabled": true
}
}
} openclaw mcp add com-hovercode-mcp --url 'https://hovercode.com/mcp/' --transport streamable-http
mcp_servers:
com-hovercode-mcp:
url: "https://hovercode.com/mcp/" {
"McpServers": {
"com-hovercode-mcp": {
"Transport": "http",
"Url": "https://hovercode.com/mcp/"
}
}
} assistant mcp add com-hovercode-mcp -t streamable-http -u 'https://hovercode.com/mcp/'
{
"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.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 21 Sept 26 +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.
- 18 Sept 26 +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.
- 17 Sept 26 0
- 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 security
- Schema quality: 186 → 210 ▼ functional
- “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” cosmetic
- 16 Sept 26 +2
- 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 security
- Schema quality: 155 → 186 ▼ functional
- Tool “create_pdf_qr” now declares an output schema ▲ functional
- Tool “create_qr_code” now declares an output schema ▲ functional
- Tool “create_qr_codes_bulk” now declares an output schema ▲ functional
- Tool “create_short_link” now declares an output schema ▲ functional
- Tool “delete_folder” now declares an output schema ▲ functional
- Tool “delete_page” now declares an output schema ▲ functional
- Tool “delete_qr_code” now declares an output schema ▲ functional
- Tool “delete_short_link” now declares an output schema ▲ functional
- Tool “get_analytics” now declares an output schema ▲ functional
- Tool “get_form” now declares an output schema ▲ functional
- Tool “get_form_responses” now declares an output schema ▲ functional
- Tool “get_page” now declares an output schema ▲ functional
- Tool “get_qr_activity” now declares an output schema ▲ functional
- Tool “get_qr_code” now declares an output schema ▲ functional
- Tool “get_short_link” now declares an output schema ▲ functional
- Tool “get_short_link_activity” now declares an output schema ▲ functional
- Tool “list_block_types” now declares an output schema ▲ functional
- Tool “list_folders” now declares an output schema ▲ functional
- Tool “list_forms” now declares an output schema ▲ functional
- Tool “list_pages” now declares an output schema ▲ functional
- Tool “list_qr_codes” now declares an output schema ▲ functional
- Tool “list_short_links” now declares an output schema ▲ functional
- Tool “list_tags” now declares an output schema ▲ functional
- Tool “list_templates” now declares an output schema ▲ functional
- Tool “list_workspaces” now declares an output schema ▲ functional
- Tool “set_workspace” now declares an output schema ▲ functional
- Tool “update_folder” now declares an output schema ▲ functional
- Tool “update_form” now declares an output schema ▲ functional
- Tool “update_page” now declares an output schema ▲ functional
- Tool “update_qr_code” now declares an output schema ▲ functional
- Tool “update_short_link” now declares an output schema ▲ functional
- Tool “download_qr” now declares an output schema ▲ functional
- Tool “build_page” now declares an output schema ▲ functional
- Tool “create_folder” now declares an output schema ▲ functional
- Tool “create_form” now declares an output schema ▲ functional
- 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” functional
- “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” cosmetic
- 15 Sept 26 +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.
- 13 Sept 26 +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.
- 11 Sept 26 +1
- Stability: unverified → 0.03 ▲ functional
- 10 Sept 26 77
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Sept 2026 · Probed https://hovercode.com/mcp/
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=hovercode.com | CN=WE1,O=Google Trust Services,C=US | 11 Aug 2026 | 9 Nov 2026 | ECDSA 256 | ECDSA-SHA256 | 7f62f8a560817a420e981a0bbb5a6df8 |
| SANs: hovercode.com, *.hovercode.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of hovercode.com. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| hovercode.com. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Enforced and verified
The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.
| Result | Enforced and verified |
|---|---|
| Enforced | On tool calls |
| HTTP status | 200 |
WWW-Authenticate challenge Bearer resource_metadata="https://hovercode.com/.well-known/oauth-protected-resource/mcp"
Bearer resource_metadata="https://hovercode.com/.well-known/oauth-protected-resource/mcp"| Header | Value |
|---|---|
| strict-transport-security | max-age=2592000; preload |
| x-content-type-options | nosniff |
| x-frame-options | DENY |
| referrer-policy | same-origin |
Protected resource metadata
| Document | https://hovercode.com/.well-known/oauth-protected-resource/mcp |
|---|---|
| Retrieved | Yes |
| Resource | https://hovercode.com/mcp/ |
| Authorisation server | https://hovercode.com |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://hovercode.com/mcp/ | Verified | 200 | |
| http (plaintext) | http://hovercode.com/mcp/ | HTTPS enforced | 301 | https://hovercode.com/mcp/ |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
build_page ~730
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.
| Name | Type | Req | Description |
|---|---|---|---|
| background_color | string | – | For the QR code this mints: Hex background color, or 'transparent'. |
| bg_color | string | – | Hex page background color. |
| blocks | array | yes | 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 | yes | The page title (browser tab + SEO). |
| workspace | string | – | Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
create_folder ~98
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.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
create_form ~902
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 | yes | The form's title. |
| workspace | string | – | Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
create_page ~656
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | The page's heading. |
| workspace | string | – | Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
create_pdf_qr ~257
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).
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – | – |
No examples provided.
create_qr_code ~733
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – | – |
No examples provided.
create_qr_codes_bulk ~581
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| created | array | – | – |
| created_count | integer | – | – |
| error | object | – | Present only when the tool failed (the result is also flagged isError). |
| errors | array | – | – |
| failed_count | integer | – | – |
No examples provided.
create_short_link ~226
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
delete_folder ~57
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.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Folder id (from list_folders). |
| Name | Type | Req | Description |
|---|---|---|---|
| deleted | boolean | – | – |
| error | object | – | Present only when the tool failed (the result is also flagged isError). |
| id | string | – | – |
No examples provided.
delete_page ~50
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'.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Page id. |
| Name | Type | Req | Description |
|---|---|---|---|
| deleted | boolean | – | – |
| error | object | – | Present only when the tool failed (the result is also flagged isError). |
| id | string | – | – |
No examples provided.
delete_qr_code ~33
Delete a QR code. Dynamic codes stop redirecting after deletion.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | QR code id. |
| Name | Type | Req | Description |
|---|---|---|---|
| deleted | boolean | – | – |
| error | object | – | Present only when the tool failed (the result is also flagged isError). |
| id | string | – | – |
No examples provided.
delete_short_link ~31
Delete a short link. It stops redirecting after deletion.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Short link id. |
| Name | Type | Req | Description |
|---|---|---|---|
| deleted | boolean | – | – |
| error | object | – | Present only when the tool failed (the result is also flagged isError). |
| id | string | – | – |
No examples provided.
download_qr ~55
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.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | QR code id. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
get_analytics ~227
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?'.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
No examples provided.
get_form ~34
Get one form's details: status, response count, share link, and QR.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Form id. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
get_form_responses ~88
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?'.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Form id. |
| page | integer | – | 1-based page number. |
| page_size | integer | – | Responses per page (max 100, default 25). |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
get_page ~51
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.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Page id. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
get_qr_activity ~164
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.
| Name | Type | Req | Description |
|---|---|---|---|
| end | string | – | Range end, ISO date/datetime. Defaults to now when only `start` is given. |
| id | string | yes | 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
get_qr_code ~40
Get one QR code's details and scan analytics (total and unique scans), plus a rendered PNG.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | QR code id. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – | – |
No examples provided.
get_short_link ~34
Get one short link's details, destination, click counts, and QR.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Short link id. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
get_short_link_activity ~149
List recent click events for a short link (time, location, device).
| Name | Type | Req | Description |
|---|---|---|---|
| end | string | – | Range end, ISO date/datetime. Defaults to now when only `start` is given. |
| id | string | yes | 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
list_block_types ~66
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, …).
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| block_types | array | – | – |
| error | object | – | Present only when the tool failed (the result is also flagged isError). |
No examples provided.
list_folders ~84
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.
| Name | Type | Req | Description |
|---|---|---|---|
| workspace | string | – | Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
list_forms ~96
List the forms in a workspace, newest first. Optional `query` searches by title.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
list_pages ~44
List the landing pages in a workspace, newest first.
| Name | Type | Req | Description |
|---|---|---|---|
| workspace | string | – | Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
list_qr_codes ~241
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
list_short_links ~103
List short links in a workspace, newest first. Optional `query` searches URL, name, and slug.
| Name | Type | Req | Description |
|---|---|---|---|
| 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. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
list_tags ~78
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.
| Name | Type | Req | Description |
|---|---|---|---|
| workspace | string | – | Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
list_templates ~56
List the workspace's saved QR design templates. Pass a template id to create_qr_code to reuse its branding.
| Name | Type | Req | Description |
|---|---|---|---|
| workspace | string | – | Workspace id. Optional when the account has one workspace; use list_workspaces to resolve otherwise. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
list_workspaces ~51
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
set_workspace ~57
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`.
| Name | Type | Req | Description |
|---|---|---|---|
| workspace | string | yes | Workspace id or name to switch to. |
| Name | Type | Req | Description |
|---|---|---|---|
| current | boolean | – | – |
| error | object | – | Present only when the tool failed (the result is also flagged isError). |
| id | string | – | – |
| name | string | – | – |
No examples provided.
update_folder ~83
Rename a folder and/or move it under another folder. `parent` 'none' moves it to the top level. Codes inside keep their filing.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | Folder id (from list_folders). |
| name | string | – | New folder name. |
| parent | string | – | New parent folder id or slug, or 'none' for top level. |
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | – | – |
No examples provided.
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.