Skip to main content
Glama
Hovercode-Ltd

Hovercode MCP server

Official

Hovercode MCP server

Manage your Hovercode QR codes, short links, landing pages, and forms from Claude, ChatGPT, Cursor, or any Model Context Protocol client — by chatting.

  • Endpoint: https://hovercode.com/mcp/ (Streamable HTTP, hosted — nothing to run)

  • Auth: OAuth 2.1 (dynamic client registration + PKCE), or a Hovercode API token as a bearer token

  • Docs: https://hovercode.com/integrations/mcp/ · https://hovercode.com/api/#mcp-server

  • This package: a tiny stdio bridge (npx hovercode-mcp) for clients that can't connect to remote servers directly. It wraps mcp-remote and points it at the hosted endpoint, so tools and behaviour are identical.

Anything the assistant creates lands in your Hovercode dashboard like any other code, and every create tool returns both a shareable link and the rendered QR image.

Connect

Add a custom connector with the URL https://hovercode.com/mcp/ and approve access. You log in to Hovercode as normal; there is no token to copy.

Claude Code

claude mcp add --transport http hovercode https://hovercode.com/mcp/ \
  --header "Authorization: Bearer YOUR_API_TOKEN"

Your API token is on https://hovercode.com/api/.

Cursor, Claude Desktop, VS Code, and other config-file clients

Remote (preferred):

{
  "mcpServers": {
    "hovercode": {
      "type": "http",
      "url": "https://hovercode.com/mcp/",
      "headers": { "Authorization": "Bearer YOUR_API_TOKEN" }
    }
  }
}

Via this package (for clients that only support stdio servers):

{
  "mcpServers": {
    "hovercode": {
      "command": "npx",
      "args": ["-y", "hovercode-mcp"]
    }
  }
}

With no token set, the bridge opens a browser for the Hovercode OAuth login the first time. To skip the browser, set HOVERCODE_API_TOKEN:

{
  "mcpServers": {
    "hovercode": {
      "command": "npx",
      "args": ["-y", "hovercode-mcp"],
      "env": { "HOVERCODE_API_TOKEN": "YOUR_API_TOKEN" }
    }
  }
}

Related MCP server: agentic-ops-builder

What the assistant can do

Area

Tools

Workspaces

list_workspaces, set_workspace

QR codes

create_qr_code (URL, text, or vCard contact), create_qr_codes_bulk, get_qr_code, list_qr_codes (filter by folder, include tags + scan counts), update_qr_code (retarget, restyle in place, rename, move to folder, add/remove tags), delete_qr_code, download_qr (print-ready PNG + SVG), get_qr_activity, list_templates (with design details)

Organisation

list_folders, create_folder, update_folder (rename / move), delete_folder (codes become unfiled), list_tags

PDF codes

create_pdf_qr — host a PDF (URL or base64) behind a dynamic QR + short link; swap it later without reprinting

Analytics

get_analytics — totals, by-day trend, top countries/cities/OS/browsers for one code or a whole workspace

Short links

create_short_link, get_short_link, list_short_links, update_short_link, delete_short_link, get_short_link_activity

Landing pages

build_page (rich block-based page: header, links, text, image, button, video, gallery, FAQ, countdown, socials, form, …), list_block_types, create_page (simple link-in-bio), get_page, list_pages, update_page, delete_page

Forms

create_form, update_form, list_forms, get_form, get_form_responses

Things you can ask for

  • "Create a dynamic QR code for https://example.com/summer in our brand colors with the caption SCAN ME."

  • "Point my printed menu QR code at the new PDF at this link."

  • "Restyle my event QR to rounded eyes and our navy — same code, don't replace it."

  • "Make a landing page for our launch event with the schedule, a map link, and a sign-up form, and give me a QR for the posters."

  • "Make QR codes for all 20 of these product URLs, all in the same style."

  • "Make a form to collect name, email, and t-shirt size, and give me a link and QR to share it."

  • "Make a Spring 2026 folder under Campaigns and move these five codes into it."

  • "Tag every code in the Menus folder with 'print'."

  • "Summarize this week's responses to my feedback form."

  • "How did my QR codes do this month, and where were people scanning them?"

Plans and limits

The server is available on every Hovercode plan and respects the same limits as the dashboard and REST API. Static codes are unlimited; the free plan includes a small number of active dynamic (editable, tracked) codes and paid plans raise that limit.

Discovery metadata

  • Server card: https://hovercode.com/.well-known/mcp/server-card.json

  • OAuth protected resource: https://hovercode.com/.well-known/oauth-protected-resource/mcp

  • Connect guide as markdown: https://hovercode.com/mcp/docs

  • llms.txt: https://hovercode.com/llms.txt

Environment variables (bridge only)

Variable

Purpose

HOVERCODE_API_TOKEN

Optional. Use your API token instead of the OAuth browser flow.

HOVERCODE_MCP_URL

Optional. Override the endpoint (default https://hovercode.com/mcp/).

Extra CLI arguments are passed through to mcp-remote.

Support

Questions or bugs: https://hovercode.com/contact/ or open an issue on this repo.

License

MIT © Hovercode Ltd

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Enables creation of short links, dynamic QR codes, UTM templates, and hosted vCards with click/scan analytics through natural language conversations.
    42 npm
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    Cloud-hosted MCP server that enables AI assistants to create, update, and manage QR codes on me-qr.com via OAuth, supporting types like URLs, Wi-Fi, vCards, PDFs, and images.
    MIT