Qrcode

Learn how to generate versatile QR codes using the MCP QR Code Server. This server connects large language models to QR code generation across client interfaces, supporting many content types and output formats with practical customization.

How to use

You connect an MCP client to the qrcode server and request the tool named generate-qrcode. You specify the content you want encoded, such as a URL, Wi‑Fi credentials, contact information, plain text, or calendar data, and choose the desired output format and options. The server handles creating a QR code that fits your needs and returns the result in your preferred format.

How to install

Prerequisites: you need Node.js and npm installed on your machine.

Install the MCP QR Code Server globally using npm.

npm install -g @jwalsh/mcp-server-qrcode

Configuration and quick start

Use a stdio MCP configuration to run the server locally. The server uses the npx command to start the MCP service with the package @jwalsh/mcp-server-qrcode.

{
  "mcpServers": {
    "qrcode": {
      "command": "npx",
      "args": [
        "-y",
        "@jwalsh/mcp-server-qrcode"
      ]
    }
  }
}

How to call the generate-qrcode tool in practice

Once the server is running, you can ask your MCP client to invoke the generate-qrcode tool with the content you want to encode and the preferred format. For example, you can request a QR code for a website, a Wi‑Fi network, a contact, plain text, or an iCal event. The tool accepts options for size, error correction level, and output format, and returns the resulting QR code in the chosen format.

Examples of supported content and outputs

Content types you can encode: URLs, WiFi credentials, vCard/contact information, plain text, and iCal calendar events.

Output formats include PNG images (base64-encoded), ASCII/text representation, and Data URL format.

Customization options cover size adjustments from 100 to 1000 pixels and error correction levels L, M, Q, and H.

Notes on usage with MCP clients

Your MCP client will expose the available tools for the qrcode server. Look for generate-qrcode in the tool list, then provide the content and desired format when you call it.

Additional configuration details

If you need to run multiple MCP servers or customize environment, you can extend the mcpServers configuration with additional entries as needed. Keep in mind that a separate stdio entry should be used for each unique server you intend to run.

Troubleshooting tips

If the server does not respond, verify Node.js and npm are installed, ensure the global MCP server package is installed, and confirm the command and arguments in your MCP client configuration match those shown in the start block. Check that there are no port or path conflicts with other MCP servers on your machine.

Developer notes

Tools exposed by this server include the generate-qrcode function, which creates QR codes from a given content payload and returns an encoded representation based on your requested format. This server is designed to be used with MCP clients across various interfaces, providing a consistent QR code generation experience.

Available tools

generate-qrcode

Generates a QR code from provided content with configurable output format, size, and error correction level across multiple content types.