Model Context Protocol

Manage your QR codes from Claude, ChatGPT, and Cursor

The Hovercode MCP server connects your AI assistant to your real Hovercode workspace. Create and restyle QR codes, retarget printed codes, shorten links, build landing pages and forms, and ask how your campaigns are doing, all by chatting.

Connect it now Developer docs

Endpoint: https://hovercode.com/mcp/

What your assistant can do

QR codes

Create codes with your colors, pattern, eye style, frame, and logo. Make them dynamic so they can be edited and tracked. Create them one at a time or in bulk, and get print-ready PNG and SVG files.

Edit codes that are already printed

Point a dynamic code at a new destination, swap the PDF behind it, or restyle it in place. The code on your flyers, menus, and packaging keeps working.

Scan analytics

Ask how a code or a whole workspace performed over a period and get totals, trends, and a breakdown of where and how people scanned.

Short links

Shorten URLs with a custom slug or your own domain, retarget them later, and read click stats.

Landing pages

Describe a page and get it built from blocks: headers, links, text, images, video, galleries, FAQs, countdowns, social links, and embedded forms. Published with a live URL and a QR code.

Forms

Build a form from a list of fields, brand it, publish it with a share link and QR, then ask the assistant to summarize the responses.

Things you can ask for

  • “Create a dynamic QR code for our summer sale page in our brand colors with the caption SCAN ME.”
  • “Point my printed menu QR code at the new PDF at this link.”
  • “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.”
  • “How did my QR codes do this month, and where were people scanning them?”
  • “Summarize this week's responses to my feedback form.”

Connect it

Claude, ChatGPT, and other connector clients

Add a custom connector with this URL and approve access. You log in to Hovercode as normal. Nothing to copy.

https://hovercode.com/mcp/

Claude Code

Uses your Hovercode API token, which you can find on the API page.

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

Cursor, Claude Desktop, and config-file clients

Add this to your client's MCP configuration.

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

Clients that only support local (stdio) servers

Use the hovercode-mcp npm package. It bridges to the hosted server, and opens a browser for the Hovercode login the first time. Set HOVERCODE_API_TOKEN to skip the browser.

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

Building your own agent? The machine-readable connect guide is at https://hovercode.com/mcp/docs and discovery metadata at /.well-known/mcp/server-card.json.

Frequently asked questions

What is the Hovercode MCP server?

It is a Model Context Protocol (MCP) server hosted at https://hovercode.com/mcp/. Once connected, an AI assistant such as Claude, ChatGPT, or Cursor can create and edit QR codes, short links, landing pages, and forms in your Hovercode workspace, and read scan analytics, by chatting with you.

How do I connect Hovercode to Claude or ChatGPT?

Add https://hovercode.com/mcp/ as a custom connector in your client, then approve access. You log in to Hovercode as normal and the client registers itself. There is no token to copy. For CLI and config-file clients you can pass your Hovercode API token as a bearer token instead.

Does the MCP server work with the free plan?

Yes. The server is available on every Hovercode plan, and it respects the same limits as your dashboard and the REST API. Anything a paid plan unlocks in the app is also unlocked for the assistant.

Is it safe to give an AI assistant access to my QR codes?

Access uses OAuth with PKCE and can be revoked at any time. The assistant can only act inside the workspaces you belong to, and every change lands in your dashboard where you can review or undo it.

Can an assistant change a QR code that has already been printed?

Yes, if the code is dynamic. The assistant can point it at a new destination, swap the PDF behind it, or restyle it in place, and the printed code keeps working.

Ready to run your QR codes from chat?

Free to start. Dynamic QR codes included.

Sign up free All integrations