Manage QR Codes via Scanova API
Create, manage, and download dynamic QR codes via Scanova's hosted API - activate, deactivate, and update them conversationally.
Why it matters
Integrate with the Scanova API to programmatically create, manage, and download QR codes. This asset provides tools for developers to automate QR code generation and management within their IDEs.
Outcomes
What it gets done
Create new QR codes with custom URLs.
List, update, and retrieve existing QR codes.
Download QR code images in various formats.
Activate and deactivate QR codes.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-scanova-mcp-server | bash Capabilities
Tools your agent gets
Create a new QR code
Show existing QR codes
Update an existing QR code
Get QR code details
Download QR code image
Activate a QR code
Deactivate a QR code
Overview
Scanova MCP Server
Scanova MCP Server lets an AI assistant create, list, update, retrieve, download, and activate/deactivate dynamic QR codes through the hosted Scanova API, authenticated via an API key. Use it for conversational QR code creation and management. Requires a Scanova API key from app.scanova.io.
What it does
Scanova MCP Server connects an AI assistant to the Scanova QR code platform, letting it create, list, update, retrieve, download, activate, and deactivate dynamic QR codes.
When to use - and when NOT to
Use it when you want to generate a QR code with a custom URL, list your existing QR codes, update a code's destination URL or name, download the QR code image, or toggle its active status. Simple prompts like "create qr," "make qr code," or "list qr codes" trigger the corresponding tools. Do not use it without a Scanova API key, obtained from app.scanova.io - it's required in the Authorization header for the hosted MCP endpoint.
Capabilities
create_qr_code: create a new dynamic QR code.list_qr_codes: list existing QR codes with pagination.update_qr_code: update an existing QR code's URL or name.retrieve_qr_code: get detailed information about a specific QR code.download_qr_code: download the QR code image in various formats.activate_qr_code/deactivate_qr_code: manage a QR code's active status.
How to install
Connect to the hosted server (no local deployment required):
{
"mcpServers": {
"scanova-mcp": {
"transport": "http",
"url": "https://mcp.scanova.io/mcp",
"headers": { "Authorization": "YOUR_SCANOVA_API_KEY_HERE" }
}
}
}
This same config works for Cursor, VS Code, and Claude Desktop. For local development or self-hosting:
git clone <repository-url>
cd qcg-mcp
uv sync
uv run cloud_server.py
Or via Docker: docker build -t mcpserver:local . && docker run -d --name mcpserver -p 8000:8000 mcpserver:local, or docker compose up -d.
Who it's for
Marketers and developers who want an AI assistant to generate and manage dynamic QR codes - updating destination URLs without reprinting the code - conversationally instead of using the Scanova dashboard.
Source README
MCP server for creating and managing QR codes through Scanova API, providing tools for creating, managing, and downloading QR codes in MCP-compatible IDEs.
Installation
Local Development
git clone <repository-url>
cd qcg-mcp
uv sync
uv run cloud_server.py
Docker
docker build -t mcpserver:local .
docker run -d --name mcpserver -p 8000:8000 mcpserver:local
Docker Compose
docker compose up -d
Configuration
Cursor
{
"mcpServers": {
"scanova-mcp": {
"transport": "http",
"url": "https://mcp.scanova.io/mcp",
"headers": {
"Authorization": "YOUR_SCANOVA_API_KEY_HERE"
}
}
}
}
VS Code
{
"mcpServers": {
"scanova-mcp": {
"transport": "http",
"url": "https://mcp.scanova.io/mcp",
"headers": {
"Authorization": "YOUR_SCANOVA_API_KEY_HERE"
}
}
}
}
Claude Desktop
{
"mcpServers": {
"scanova-mcp": {
"transport": "http",
"url": "https://mcp.scanova.io/mcp",
"headers": {
"Authorization": "YOUR_SCANOVA_API_KEY_HERE"
}
}
}
}
Available Tools
| Tool | Description |
|---|---|
create_qr_code |
Create a new QR code |
list_qr_codes |
Show existing QR codes |
update_qr_code |
Update an existing QR code |
retrieve_qr_code |
Get QR code details |
download_qr_code |
Download QR code image |
activate_qr_code |
Activate a QR code |
deactivate_qr_code |
Deactivate a QR code |
Features
- QR Code Creation: Generate dynamic QR codes with custom URLs
- QR Code Listing: View all existing QR codes with pagination
- QR Code Updates: Modify existing QR codes with new URLs or names
- QR Code Details: Get detailed information about specific QR codes
- QR Code Downloads: Download QR code images in various formats
- QR Code Activation/Deactivation: Manage QR code status
Usage Examples
create qr
make qr code
generate qr
list qr codes
show qr codes
Notes
Requires a Scanova API key from https://app.scanova.io/. The server is hosted at https://mcp.scanova.io/mcp and provides health check and service info endpoints. MIT License.
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.