MCPサーバー

QRCodeKIT

com.qrcodekit/qrcodekit

このMCPでできること

Creates branded short links, hosted file and HTML pages, dynamic QR codes, app and contact links, and click and scan analytics.

create_file_upload_session
Create File Upload Session
Widget-only helper: mint a one-time upload session so the file upload form can send the selected file to QRCodeKIT without exposing credentials. Not intended for direct use; prefer 'Upload a File → Get a Link & QR'.
外部アクセスあり
入力スキーマ
{'type': 'object', 'title': 'create_file_upload_sessionArguments', 'required': ['filename', 'size_bytes', 'typology'], 'properties': {'filename': {'type': 'string', 'title': 'Filename', 'maxLength': 255, 'minLength': 1, 'description': 'Original filename of the selected file.'}, 'typology': {'enum': ['file', 'pdf'], 'type': 'string', 'title': 'Typology', 'description': "Use 'file' for an arbitrary file or 'pdf' for a PDF."}, 'mime_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Mime Type', 'default': None, 'description': 'MIME type reported by the browser for the selected file.'}, 'size_bytes': {'type': 'integer', 'title': 'Size Bytes', 'maximum': 50000000, 'minimum': 1, 'description': 'Size of the selected file in bytes. Must be at most 50 MB.'}}}
出力スキーマ
{'type': 'object', 'title': 'FileUploadSession', 'required': ['session_id', 'upload_url', 'expires_at', 'max_bytes'], 'properties': {'method': {'type': 'string', 'title': 'Method', 'default': 'POST', 'description': 'HTTP method the widget must use for the upload.'}, 'max_bytes': {'type': 'integer', 'title': 'Max Bytes', 'minimum': 1, 'description': 'Maximum accepted upload size in bytes.'}, 'expires_at': {'type': 'string', 'title': 'Expires At', 'minLength': 1, 'description': 'ISO-8601 timestamp when the session expires.'}, 'field_name': {'type': 'string', 'title': 'Field Name', 'default': 'file', 'description': 'Multipart field name for the uploaded file.'}, 'session_id': {'type': 'string', 'title': 'Session Id', 'minLength': 1, 'description': 'Opaque backend upload-session identifier.'}, 'upload_url': {'type': 'string', 'title': 'Upload Url', 'minLength': 1, 'description': 'Single-use URL the widget posts the file to (multipart form data).'}}, 'description': 'One-time upload session minted by the backend for the Claude upload widget.', 'additionalProperties': False}
delete_link
Delete Link
Move an existing QRCodeKIT link and its QR code to the active account's trash. Use this only when the user asks to delete, remove, or discard a specific link. Reversible from the QRCodeKIT web app. Resolve the exact qr_id before deleting when the target is ambiguous.
破壊的操作あり 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'title': 'delete_linkArguments', 'required': ['qr_id'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'minLength': 1, 'description': 'Stable QRCodeKIT identifier for the link.'}}}
出力スキーマ
{'type': 'object', 'title': 'DeleteQrResult', 'required': ['qr_id', 'deleted'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR moved to trash.'}, 'deleted': {'type': 'boolean', 'title': 'Deleted', 'description': 'Whether the QR was moved to trash.'}}}
get_link_stats
Link & QR Analytics
Retrieve analytics for the whole QRCodeKIT account or for one link. Reports total, unique, and repeat visits, unique-visitor ratio, activity over time, and — when the account plan supports advanced analytics — breakdowns by country, city, device, operating system, and browser. Account-wide results also include the number of links and the top links ranked by lifetime visits. Use this when the user asks about QR scans, short-link clicks, campaign performance, audience location, devices, trends, comparisons, or top-performing links. Every visit to the short URL is counted, so link clicks and QR scans are combined: one campaign can live in a printed QR, an Instagram bio, and an email and report in one place. Select a link by qr_id, slug, or part of its title via `qr`; omit it for the whole account. Defaults to the last 30 days; the interval can be auto, hourly, daily, weekly, or monthly. The structured result contains the full tables for answering questions about the data.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'title': 'get_link_statsArguments', 'properties': {'qr': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Qr', 'default': None, 'description': 'Optional link to deep-dive into: the QRCodeKIT qr_id, the short-link slug, or (part of) the link title. Omit for account-wide stats.'}, 'end_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'End Date', 'default': None, 'description': 'Last day of the stats window (YYYY-MM-DD). Defaults to today.'}, 'interval': {'enum': ['auto', '1h', '1d', '1w', '1M'], 'type': 'string', 'title': 'Interval', 'default': 'auto', 'description': "Time-series bucket size: 1h, 1d, 1w, or 1M. Use 'auto' (default) to pick a sensible bucket from the range length."}, 'start_date': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Start Date', 'default': None, 'description': 'First day of the stats window (YYYY-MM-DD). Defaults to 29 days before end_date.'}}}
出力スキーマ
{'type': 'object', '$defs': {'QrStatsTopQr': {'type': 'object', 'title': 'QrStatsTopQr', 'required': ['qr_id', 'title', 'shortlink_url'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR.'}, 'title': {'type': 'string', 'title': 'Title', 'description': 'Human-readable title of the QR.'}, 'visits_total': {'type': 'integer', 'title': 'Visits Total', 'default': 0, 'minimum': 0, 'description': 'Lifetime visit/scan total for the QR.'}, 'shortlink_url': {'type': 'string', 'title': 'Shortlink Url', 'description': 'Public shortlink URL encoded by the QR.'}}}, 'QrStatsTarget': {'type': 'object', 'title': 'QrStatsTarget', 'required': ['qr_id', 'title', 'shortlink_url', 'short_code'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR.'}, 'title': {'type': 'string', 'title': 'Title', 'description': 'Human-readable title of the QR.'}, 'short_code': {'type': 'string', 'title': 'Short Code', 'description': 'Short code segment used by the QR shortlink.'}, 'visits_total': {'type': 'integer', 'title': 'Visits Total', 'default': 0, 'minimum': 0, 'description': 'Lifetime visit/scan total for the QR.'}, 'shortlink_url': {'type': 'string', 'title': 'Shortlink Url', 'description': 'Public shortlink URL encoded by the QR.'}}}, 'QrStatsSummary': {'type': 'object', 'title': 'QrStatsSummary', 'properties': {'total': {'type': 'integer', 'title': 'Total', 'default': 0, 'minimum': 0, 'description': 'Total visits/scans recorded in the window.'}, 'repeat': {'type': 'integer', 'title': 'Repeat', 'default': 0, 'minimum': 0, 'description': 'Repeat visits: total minus unique.'}, 'unique': {'type': 'integer', 'title': 'Unique', 'default': 0, 'minimum': 0, 'description': 'Unique visitors/scanners in the window.'}, 'unique_ratio': {'type': 'integer', 'title': 'Unique Ratio', 'default': 0, 'maximum': 100, 'minimum': 0, 'description': 'Unique visitors as a rounded percentage of total visits.'}}}, 'QrStatsTimePoint': {'type': 'object', 'title': 'QrStatsTimePoint', 'required': ['time'], 'properties': {'time': {'type': 'string', 'title': 'Time', 'description': 'Bucket start timestamp reported by the analytics backend.'}, 'total': {'type': 'integer', 'title': 'Total', 'default': 0, 'minimum': 0, 'description': 'Total visits in this bucket.'}, 'unique': {'type': 'integer', 'title': 'Unique', 'default': 0, 'minimum': 0, 'description': 'Unique visitors in this bucket.'}}}, 'QrStatsBreakdownItem': {'type': 'object', 'title': 'QrStatsBreakdownItem', 'required': ['name'], 'properties': {'code': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Code', 'default': None, 'description': 'Optional machine code for the bucket, such as an ISO country code.'}, 'name': {'type': 'string', 'title': 'Name', 'description': 'Display name of the bucket, such as a country or browser.'}, 'total': {'type': 'integer', 'title': 'Total', 'default': 0, 'minimum': 0, 'description': 'Total visits attributed to this bucket.'}, 'unique': {'type': 'integer', 'title': 'Unique', 'default': 0, 'minimum': 0, 'description': 'Unique visitors attributed to this bucket.'}}}}, 'title': 'QrStatsResult', 'required': ['scope', 'start_date', 'end_date', 'interval'], 'properties': {'qr': {'anyOf': [{'$ref': '#/$defs/QrStatsTarget'}, {'type': 'null'}], 'default': None, 'description': "The QR the stats belong to when scope is 'qr'."}, 'scope': {'enum': ['account', 'qr'], 'type': 'string', 'title': 'Scope', 'description': "'qr' for a single QR deep-dive, 'account' for all QRs in the account."}, 'cities': {'type': 'array', 'items': {'$ref': '#/$defs/QrStatsBreakdownItem'}, 'title': 'Cities'}, 'notice': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Notice', 'default': None, 'description': 'Human-readable note about limits or missing data, if any.'}, 'devices': {'type': 'array', 'items': {'$ref': '#/$defs/QrStatsBreakdownItem'}, 'title': 'Devices'}, 'summary': {'$ref': '#/$defs/QrStatsSummary'}, 'top_qrs': {'type': 'array', 'items': {'$ref': '#/$defs/QrStatsTopQr'}, 'title': 'Top Qrs', 'description': 'Account scope only: QRs ranked by lifetime visit totals.'}, 'browsers': {'type': 'array', 'items': {'$ref': '#/$defs/QrStatsBreakdownItem'}, 'title': 'Browsers'}, 'end_date': {'type': 'string', 'title': 'End Date', 'description': 'Last day of the stats window (YYYY-MM-DD).'}, 'interval': {'type': 'string', 'title': 'Interval', 'description': 'Time-series bucket size: 1h, 1d, 1w, or 1M.'}, 'qr_count': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}], 'title': 'Qr Count', 'default': None, 'description': 'Account scope only: number of QRs covered by the stats.'}, 'countries': {'type': 'array', 'items': {'$ref': '#/$defs/QrStatsBreakdownItem'}, 'title': 'Countries'}, 'start_date': {'type': 'string', 'title': 'Start Date', 'description': 'First day of the stats window (YYYY-MM-DD).'}, 'time_series': {'type': 'array', 'items': {'$ref': '#/$defs/QrStatsTimePoint'}, 'title': 'Time Series'}, 'operating_systems': {'type': 'array', 'items': {'$ref': '#/$defs/QrStatsBreakdownItem'}, 'title': 'Operating Systems'}, 'advanced_stats_available': {'type': 'boolean', 'title': 'Advanced Stats Available', 'default': True, 'description': 'False when the plan does not include advanced analytics breakdowns.'}}}
host_file
Share a File or PDF by Link
Upload and host a local PDF, image, document, spreadsheet, or other file, and get a permanent public short link plus a downloadable dynamic QR code that opens or downloads it. Use this when the user wants to publish or share an attached PDF or file — a PDF menu, brochure, catalog, CV, ticket, presentation, or any document — without a separate file-hosting account. QRCodeKIT copies the attachment to its own asset storage and validates PDFs as real PDF documents. When `qr_id` is provided, replace the hosted file while preserving the existing public URL and printed QR code.
外部アクセスあり
入力スキーマ
{'type': 'object', '$defs': {'OpenAIFileParam': {'type': 'object', 'title': 'OpenAIFileParam', 'required': ['download_url', 'file_id'], 'properties': {'file_id': {'type': 'string', 'title': 'File Id', 'minLength': 1, 'description': 'Host-specific stable identifier for the attached file.'}, 'file_name': {'anyOf': [{'type': 'string', 'maxLength': 255}, {'type': 'null'}], 'title': 'File Name', 'default': None, 'description': "Optional original filename reported by the host. Defaults to 'file'."}, 'mime_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Mime Type', 'default': None, 'description': 'Optional MIME type reported by the host for the attached file.'}, 'download_url': {'type': 'string', 'title': 'Download Url', 'format': 'uri', 'minLength': 1, 'description': 'Temporary HTTPS URL from which the MCP server can download the attached file.'}}, 'description': 'The file-object shape passed by OpenAI Apps file parameters.', 'additionalProperties': False}}, 'title': 'host_fileArguments', 'required': ['title', 'file'], 'properties': {'file': {'$ref': '#/$defs/OpenAIFileParam', 'description': 'Attached file to host â\x80\x94 PDF or any other type â\x80\x94 stored as a QRCodeKIT asset before creating the link.'}, 'qr_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Qr Id', 'default': None, 'description': 'Optional QRCodeKIT identifier for updating an existing link instead of creating one.'}, 'title': {'type': 'string', 'title': 'Title', 'maxLength': 120, 'minLength': 1, 'description': 'Display title for the link.'}}}
出力スキーマ
{'type': 'object', '$defs': {'QrSummary': {'type': 'object', 'title': 'QrSummary', 'required': ['qr_id', 'title', 'destination_url', 'short_code', 'shortlink_url', 'created_at', 'updated_at'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR.'}, 'title': {'type': 'string', 'title': 'Title', 'description': 'Human-readable title of the dynamic QR.'}, 'created_at': {'type': 'string', 'title': 'Created At', 'format': 'date-time', 'description': 'Creation timestamp in UTC.'}, 'short_code': {'type': 'string', 'title': 'Short Code', 'description': 'Short code segment used by the QR shortlink.'}, 'updated_at': {'type': 'string', 'title': 'Updated At', 'format': 'date-time', 'description': 'Last update timestamp in UTC.'}, 'qr_image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Qr Image Url', 'default': None, 'description': 'Primary public QR image URL, typically the generated SVG asset.'}, 'visits_total': {'type': 'integer', 'title': 'Visits Total', 'default': 0, 'minimum': 0, 'description': 'Total visits/scans recorded for this QR by QRCodeKIT.'}, 'qr_image_urls': {'type': 'object', 'title': 'Qr Image Urls', 'description': 'Public QR image or download URLs keyed by format, such as svg, png, pdf, or eps.', 'additionalProperties': {'type': 'string'}}, 'shortlink_url': {'type': 'string', 'title': 'Shortlink Url', 'description': 'Complete public shortlink URL encoded by the QR.'}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'description': 'Current destination URL for the dynamic QR.'}}}}, 'title': 'ListQrsResult', 'properties': {'items': {'type': 'array', 'items': {'$ref': '#/$defs/QrSummary'}, 'title': 'Items', 'description': 'QR codes visible to the active account.'}}}
list_links
List Links & QR Codes
Return the account's QRCodeKIT links as structured data: title, destination or hosted content, short URL, slug, QR image download URLs, timestamps, and lifetime visits. Lifetime visits combine short-link clicks and QR scans. Use this when the assistant needs to search, filter by link type, compare, inspect, or process existing links programmatically. Use show_links instead when the user asks to see, show, display, preview, or download their links or QR codes.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'title': 'list_linksArguments', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of links to return from the active account.'}, 'typology': {'enum': ['all', 'website', 'file', 'pdf', 'menu', 'social', 'bcard', 'landing', 'whatsapp', 'app_store', 'deep_link', 'digital_link', 'email', 'payment'], 'type': 'string', 'title': 'Typology', 'default': 'all', 'description': "Link typology internal name to filter by. Use 'all' or omit this field to return all typologies."}}}
出力スキーマ
{'type': 'object', '$defs': {'QrSummary': {'type': 'object', 'title': 'QrSummary', 'required': ['qr_id', 'title', 'destination_url', 'short_code', 'shortlink_url', 'created_at', 'updated_at'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR.'}, 'title': {'type': 'string', 'title': 'Title', 'description': 'Human-readable title of the dynamic QR.'}, 'created_at': {'type': 'string', 'title': 'Created At', 'format': 'date-time', 'description': 'Creation timestamp in UTC.'}, 'short_code': {'type': 'string', 'title': 'Short Code', 'description': 'Short code segment used by the QR shortlink.'}, 'updated_at': {'type': 'string', 'title': 'Updated At', 'format': 'date-time', 'description': 'Last update timestamp in UTC.'}, 'qr_image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Qr Image Url', 'default': None, 'description': 'Primary public QR image URL, typically the generated SVG asset.'}, 'visits_total': {'type': 'integer', 'title': 'Visits Total', 'default': 0, 'minimum': 0, 'description': 'Total visits/scans recorded for this QR by QRCodeKIT.'}, 'qr_image_urls': {'type': 'object', 'title': 'Qr Image Urls', 'description': 'Public QR image or download URLs keyed by format, such as svg, png, pdf, or eps.', 'additionalProperties': {'type': 'string'}}, 'shortlink_url': {'type': 'string', 'title': 'Shortlink Url', 'description': 'Complete public shortlink URL encoded by the QR.'}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'description': 'Current destination URL for the dynamic QR.'}}}}, 'title': 'ListQrsResult', 'properties': {'items': {'type': 'array', 'items': {'$ref': '#/$defs/QrSummary'}, 'title': 'Items', 'description': 'QR codes visible to the active account.'}}}
render_file_upload_qr_form
Upload a File → Get a Link & QR
Open an interactive form for the user to upload a file or PDF from their device and get a permanent short link plus a downloadable dynamic QR code. Use this on Claude and other MCP hosts that cannot pass an attached file directly, whenever the user wants to share or host a PDF, menu, brochure, CV, ticket, or other file by link or QR. The form uploads the file to QRCodeKIT and saves the link; when `qr_id` is provided, it replaces the file of an existing link while preserving its short URL and QR code.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'title': 'render_file_upload_qr_formArguments', 'properties': {'qr_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Qr Id', 'default': None, 'description': 'Optional QRCodeKIT identifier when updating an existing QR instead of creating one.'}, 'title': {'anyOf': [{'type': 'string', 'maxLength': 120}, {'type': 'null'}], 'title': 'Title', 'default': None, 'description': "QR title used when the upload is saved; the form has no title input. Always pass a sensible title from the conversation; when updating an existing QR, pass that QR's current title. Defaults to the uploaded filename."}, 'typology': {'enum': ['file', 'pdf'], 'type': 'string', 'title': 'Typology', 'default': 'file', 'description': "Initial file typology hint for the form heading. The final typology is inferred from the uploaded file's extension, so this is only a default."}}}
出力スキーマ
{'type': 'object', 'title': 'FileUploadFormConfig', 'properties': {'qr_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Qr Id', 'default': None, 'description': 'Stable QRCodeKIT identifier when the widget updates an existing QR.'}, 'title': {'anyOf': [{'type': 'string', 'maxLength': 120}, {'type': 'null'}], 'title': 'Title', 'default': None, 'description': 'QR title used when the upload is saved. Falls back to the uploaded filename.'}, 'typology': {'enum': ['file', 'pdf'], 'type': 'string', 'title': 'Typology', 'default': 'file', 'description': 'Initial file typology for the form.'}, 'max_bytes': {'type': 'integer', 'title': 'Max Bytes', 'default': 50000000, 'minimum': 1, 'description': 'Maximum accepted upload size in bytes, enforced client-side for UX.'}}, 'description': 'Seed data the upload widget reads from the tool output to render the form.', 'additionalProperties': False}
save_app_store_link
App Download Smart Link
Create a device-routing smart link and dynamic QR code for a mobile app: the same short link sends iPhone users to the Apple App Store and Android users to Google Play. Use this for 'download our app' campaigns in print, ads, websites, or link-in-bio pages. An app name and at least one store URL (iOS or Android) are required; an icon URL is optional. When `qr_id` is provided, update the app destinations while preserving the existing short link and QR code.
外部アクセスあり
入力スキーマ
{'type': 'object', 'title': 'save_app_store_linkArguments', 'required': ['app_name'], 'properties': {'qr_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Qr Id', 'default': None, 'description': 'Optional QRCodeKIT identifier for updating an existing QR instead of creating one.'}, 'ios_url': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Ios Url', 'format': 'uri', 'default': None, 'description': 'Optional Apple App Store URL, such as https://apps.apple.com/app/example/id123.'}, 'app_name': {'type': 'string', 'title': 'App Name', 'maxLength': 120, 'minLength': 1, 'description': 'App name shown on the App Store QR landing page.'}, 'image_url': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Image Url', 'format': 'uri', 'default': None, 'description': 'Optional app icon image URL.'}, 'android_url': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Android Url', 'format': 'uri', 'default': None, 'description': 'Optional Google Play URL, such as https://play.google.com/store/apps/details?id=com.example.'}}}
出力スキーマ
{'type': 'object', '$defs': {'QrSummary': {'type': 'object', 'title': 'QrSummary', 'required': ['qr_id', 'title', 'destination_url', 'short_code', 'shortlink_url', 'created_at', 'updated_at'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR.'}, 'title': {'type': 'string', 'title': 'Title', 'description': 'Human-readable title of the dynamic QR.'}, 'created_at': {'type': 'string', 'title': 'Created At', 'format': 'date-time', 'description': 'Creation timestamp in UTC.'}, 'short_code': {'type': 'string', 'title': 'Short Code', 'description': 'Short code segment used by the QR shortlink.'}, 'updated_at': {'type': 'string', 'title': 'Updated At', 'format': 'date-time', 'description': 'Last update timestamp in UTC.'}, 'qr_image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Qr Image Url', 'default': None, 'description': 'Primary public QR image URL, typically the generated SVG asset.'}, 'visits_total': {'type': 'integer', 'title': 'Visits Total', 'default': 0, 'minimum': 0, 'description': 'Total visits/scans recorded for this QR by QRCodeKIT.'}, 'qr_image_urls': {'type': 'object', 'title': 'Qr Image Urls', 'description': 'Public QR image or download URLs keyed by format, such as svg, png, pdf, or eps.', 'additionalProperties': {'type': 'string'}}, 'shortlink_url': {'type': 'string', 'title': 'Shortlink Url', 'description': 'Complete public shortlink URL encoded by the QR.'}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'description': 'Current destination URL for the dynamic QR.'}}}}, 'title': 'ListQrsResult', 'properties': {'items': {'type': 'array', 'items': {'$ref': '#/$defs/QrSummary'}, 'title': 'Items', 'description': 'QR codes visible to the active account.'}}}
save_email_link
Email Action Link
Create a short link and dynamic QR code that opens a pre-filled email with a recipient, required subject, optional body, and optional CC recipients. Use this for 'contact us' flows, support or quote requests, RSVPs, feedback, reservations, or other email calls to action. When `qr_id` is provided, update the email details while preserving the existing short link and QR code.
外部アクセスあり
入力スキーマ
{'type': 'object', 'title': 'save_email_linkArguments', 'required': ['title', 'email_address', 'subject'], 'properties': {'cc': {'anyOf': [{'type': 'array', 'items': {'type': 'string'}}, {'type': 'null'}], 'title': 'Cc', 'default': None, 'description': 'Optional CC email addresses.'}, 'body': {'type': 'string', 'title': 'Body', 'default': '', 'maxLength': 2000, 'description': 'Optional pre-filled email body.'}, 'qr_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Qr Id', 'default': None, 'description': 'Optional QRCodeKIT identifier for updating an existing QR instead of creating one.'}, 'title': {'type': 'string', 'title': 'Title', 'maxLength': 120, 'minLength': 1, 'description': 'Display title for the link.'}, 'subject': {'type': 'string', 'title': 'Subject', 'maxLength': 200, 'minLength': 1, 'description': 'Pre-filled email subject.'}, 'email_address': {'type': 'string', 'title': 'Email Address', 'minLength': 1, 'description': 'Recipient email address for the email QR.'}}}
出力スキーマ
{'type': 'object', '$defs': {'QrSummary': {'type': 'object', 'title': 'QrSummary', 'required': ['qr_id', 'title', 'destination_url', 'short_code', 'shortlink_url', 'created_at', 'updated_at'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR.'}, 'title': {'type': 'string', 'title': 'Title', 'description': 'Human-readable title of the dynamic QR.'}, 'created_at': {'type': 'string', 'title': 'Created At', 'format': 'date-time', 'description': 'Creation timestamp in UTC.'}, 'short_code': {'type': 'string', 'title': 'Short Code', 'description': 'Short code segment used by the QR shortlink.'}, 'updated_at': {'type': 'string', 'title': 'Updated At', 'format': 'date-time', 'description': 'Last update timestamp in UTC.'}, 'qr_image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Qr Image Url', 'default': None, 'description': 'Primary public QR image URL, typically the generated SVG asset.'}, 'visits_total': {'type': 'integer', 'title': 'Visits Total', 'default': 0, 'minimum': 0, 'description': 'Total visits/scans recorded for this QR by QRCodeKIT.'}, 'qr_image_urls': {'type': 'object', 'title': 'Qr Image Urls', 'description': 'Public QR image or download URLs keyed by format, such as svg, png, pdf, or eps.', 'additionalProperties': {'type': 'string'}}, 'shortlink_url': {'type': 'string', 'title': 'Shortlink Url', 'description': 'Complete public shortlink URL encoded by the QR.'}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'description': 'Current destination URL for the dynamic QR.'}}}}, 'title': 'ListQrsResult', 'properties': {'items': {'type': 'array', 'items': {'$ref': '#/$defs/QrSummary'}, 'title': 'Items', 'description': 'QR codes visible to the active account.'}}}
save_file_url_qr
Link a Hosted File
Create or update a permanent short link and dynamic QR code for a file or PDF that is already hosted at a public URL. Use this as a fallback when the host cannot pass an attached file; prefer host_file for local or host-native attachments. When `qr_id` is provided, update the file destination while preserving the existing short link and QR code. Also used as the finalizer step by the in-chat upload form.
外部アクセスあり
入力スキーマ
{'type': 'object', 'title': 'save_file_url_qrArguments', 'required': ['title', 'file_url', 'typology'], 'properties': {'qr_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Qr Id', 'default': None, 'description': 'Optional QRCodeKIT identifier for updating an existing QR instead of creating one.'}, 'title': {'type': 'string', 'title': 'Title', 'maxLength': 120, 'minLength': 1, 'description': 'Display title for the QR.'}, 'file_url': {'type': 'string', 'title': 'File Url', 'format': 'uri', 'minLength': 1, 'description': 'Already-hosted public file URL, preferably a QRCodeKIT asset URL.'}, 'typology': {'enum': ['file', 'pdf'], 'type': 'string', 'title': 'Typology', 'description': "Use 'file' for an arbitrary file or 'pdf' for a PDF."}, 'asset_iri': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Asset Iri', 'default': None, 'description': 'Optional QRCodeKIT asset IRI returned by an earlier upload.'}, 'original_filename': {'anyOf': [{'type': 'string', 'maxLength': 255}, {'type': 'null'}], 'title': 'Original Filename', 'default': None, 'description': "Original filename to show for the download. Defaults to 'file'."}}}
出力スキーマ
{'type': 'object', '$defs': {'QrSummary': {'type': 'object', 'title': 'QrSummary', 'required': ['qr_id', 'title', 'destination_url', 'short_code', 'shortlink_url', 'created_at', 'updated_at'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR.'}, 'title': {'type': 'string', 'title': 'Title', 'description': 'Human-readable title of the dynamic QR.'}, 'created_at': {'type': 'string', 'title': 'Created At', 'format': 'date-time', 'description': 'Creation timestamp in UTC.'}, 'short_code': {'type': 'string', 'title': 'Short Code', 'description': 'Short code segment used by the QR shortlink.'}, 'updated_at': {'type': 'string', 'title': 'Updated At', 'format': 'date-time', 'description': 'Last update timestamp in UTC.'}, 'qr_image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Qr Image Url', 'default': None, 'description': 'Primary public QR image URL, typically the generated SVG asset.'}, 'visits_total': {'type': 'integer', 'title': 'Visits Total', 'default': 0, 'minimum': 0, 'description': 'Total visits/scans recorded for this QR by QRCodeKIT.'}, 'qr_image_urls': {'type': 'object', 'title': 'Qr Image Urls', 'description': 'Public QR image or download URLs keyed by format, such as svg, png, pdf, or eps.', 'additionalProperties': {'type': 'string'}}, 'shortlink_url': {'type': 'string', 'title': 'Shortlink Url', 'description': 'Complete public shortlink URL encoded by the QR.'}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'description': 'Current destination URL for the dynamic QR.'}}}}, 'title': 'ListQrsResult', 'properties': {'items': {'type': 'array', 'items': {'$ref': '#/$defs/QrSummary'}, 'title': 'Items', 'description': 'QR codes visible to the active account.'}}}
save_html_file_qr
Host Static HTML Page
Publish a single-page static HTML site live on the web and get a permanent public URL and shareable link, plus a downloadable dynamic QR code that opens it. Use this when the user asks to create, publish, deploy, host, share, or put online a landing page, one-pager, business page, digital menu, event page, portfolio, product page, campaign page, or microsite — especially when they do not have a website or hosting provider. No separate hosting account, build step, or deployment token is required. Accepts one complete HTML document up to 6 MB: a single file, not a multi-page site. When `qr_id` is provided, update the hosted page in place while preserving its public URL and printed QR code.
外部アクセスあり
入力スキーマ
{'type': 'object', 'title': 'save_html_file_qrArguments', 'required': ['title', 'html'], 'properties': {'html': {'type': 'string', 'title': 'Html', 'maxLength': 6000000, 'minLength': 1, 'description': 'Complete HTML document for a static page, such as an AI-generated landing page or microsite, to publish at a public QRCodeKIT-hosted URL and share through the returned shortlink. Maximum size is 6 MB when encoded as UTF-8.'}, 'qr_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Qr Id', 'default': None, 'description': 'Optional QRCodeKIT identifier for updating an existing hosted HTML page in place while preserving the same public URL and QR code.'}, 'title': {'type': 'string', 'title': 'Title', 'maxLength': 120, 'minLength': 1, 'description': 'Human-readable title for the hosted page.'}}}
出力スキーマ
{'type': 'object', '$defs': {'QrSummary': {'type': 'object', 'title': 'QrSummary', 'required': ['qr_id', 'title', 'destination_url', 'short_code', 'shortlink_url', 'created_at', 'updated_at'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR.'}, 'title': {'type': 'string', 'title': 'Title', 'description': 'Human-readable title of the dynamic QR.'}, 'created_at': {'type': 'string', 'title': 'Created At', 'format': 'date-time', 'description': 'Creation timestamp in UTC.'}, 'short_code': {'type': 'string', 'title': 'Short Code', 'description': 'Short code segment used by the QR shortlink.'}, 'updated_at': {'type': 'string', 'title': 'Updated At', 'format': 'date-time', 'description': 'Last update timestamp in UTC.'}, 'qr_image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Qr Image Url', 'default': None, 'description': 'Primary public QR image URL, typically the generated SVG asset.'}, 'visits_total': {'type': 'integer', 'title': 'Visits Total', 'default': 0, 'minimum': 0, 'description': 'Total visits/scans recorded for this QR by QRCodeKIT.'}, 'qr_image_urls': {'type': 'object', 'title': 'Qr Image Urls', 'description': 'Public QR image or download URLs keyed by format, such as svg, png, pdf, or eps.', 'additionalProperties': {'type': 'string'}}, 'shortlink_url': {'type': 'string', 'title': 'Shortlink Url', 'description': 'Complete public shortlink URL encoded by the QR.'}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'description': 'Current destination URL for the dynamic QR.'}}}}, 'title': 'ListQrsResult', 'properties': {'items': {'type': 'array', 'items': {'$ref': '#/$defs/QrSummary'}, 'title': 'Items', 'description': 'QR codes visible to the active account.'}}}
save_short_link
Save Short Link
Create a branded short link and dynamic QR code for an existing website URL, with an optional custom slug (e.g. qrkit.co/summer-sale). Use this when the user already has a destination URL and wants to shorten or brand it, track visits, or get a QR code for it: every link includes a scannable QR code that opens the same destination, and clicks and scans are tracked together in one analytics dashboard. When `qr_id` is provided, change the destination while preserving the existing short URL and printed QR code. Use set_link_slug instead when the user wants to rename the slug of an existing link.
外部アクセスあり
入力スキーマ
{'type': 'object', 'title': 'save_short_linkArguments', 'required': ['title', 'destination_url'], 'properties': {'qr_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Qr Id', 'default': None, 'description': 'Optional QRCodeKIT identifier for updating an existing link instead of creating one.'}, 'title': {'type': 'string', 'title': 'Title', 'maxLength': 120, 'minLength': 1, 'description': 'Display title for the link.'}, 'short_code': {'anyOf': [{'type': 'string', 'pattern': '^[A-Za-z0-9._-]+$', 'maxLength': 128, 'minLength': 1}, {'type': 'null'}], 'title': 'Short Code', 'default': None, 'description': "Optional custom slug for the new short link, such as 'summer-sale' â\x80\x94 the branded part of the short URL (qrkit.co/summer-sale). Letters, digits, dots, hyphens, and underscores only; must be unique within the domain. Only valid when creating; use set_link_slug to rename an existing link."}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'format': 'uri', 'minLength': 1, 'description': 'Destination URL the short link and QR code redirect to.'}}}
出力スキーマ
{'type': 'object', '$defs': {'QrSummary': {'type': 'object', 'title': 'QrSummary', 'required': ['qr_id', 'title', 'destination_url', 'short_code', 'shortlink_url', 'created_at', 'updated_at'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR.'}, 'title': {'type': 'string', 'title': 'Title', 'description': 'Human-readable title of the dynamic QR.'}, 'created_at': {'type': 'string', 'title': 'Created At', 'format': 'date-time', 'description': 'Creation timestamp in UTC.'}, 'short_code': {'type': 'string', 'title': 'Short Code', 'description': 'Short code segment used by the QR shortlink.'}, 'updated_at': {'type': 'string', 'title': 'Updated At', 'format': 'date-time', 'description': 'Last update timestamp in UTC.'}, 'qr_image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Qr Image Url', 'default': None, 'description': 'Primary public QR image URL, typically the generated SVG asset.'}, 'visits_total': {'type': 'integer', 'title': 'Visits Total', 'default': 0, 'minimum': 0, 'description': 'Total visits/scans recorded for this QR by QRCodeKIT.'}, 'qr_image_urls': {'type': 'object', 'title': 'Qr Image Urls', 'description': 'Public QR image or download URLs keyed by format, such as svg, png, pdf, or eps.', 'additionalProperties': {'type': 'string'}}, 'shortlink_url': {'type': 'string', 'title': 'Shortlink Url', 'description': 'Complete public shortlink URL encoded by the QR.'}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'description': 'Current destination URL for the dynamic QR.'}}}}, 'title': 'ListQrsResult', 'properties': {'items': {'type': 'array', 'items': {'$ref': '#/$defs/QrSummary'}, 'title': 'Items', 'description': 'QR codes visible to the active account.'}}}
save_whatsapp_link
WhatsApp Chat Link
Create a short link and dynamic QR code that opens a WhatsApp conversation with a phone number in international format and an optional pre-filled message. Use this for 'chat with us' or contact buttons, customer support, reservations, sales enquiries, printed signage, business cards, or link-in-bio pages. When `qr_id` is provided, update the phone number or message while preserving the existing short link and QR code.
外部アクセスあり
入力スキーマ
{'type': 'object', 'title': 'save_whatsapp_linkArguments', 'required': ['title', 'phone_number'], 'properties': {'qr_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Qr Id', 'default': None, 'description': 'Optional QRCodeKIT identifier for updating an existing QR instead of creating one.'}, 'title': {'type': 'string', 'title': 'Title', 'maxLength': 120, 'minLength': 1, 'description': 'Display title for the link.'}, 'message': {'type': 'string', 'title': 'Message', 'default': '', 'maxLength': 1000, 'description': 'Optional pre-filled WhatsApp message.'}, 'phone_number': {'type': 'string', 'title': 'Phone Number', 'minLength': 1, 'description': 'WhatsApp phone number with international country code, such as +12025550123.'}}}
出力スキーマ
{'type': 'object', '$defs': {'QrSummary': {'type': 'object', 'title': 'QrSummary', 'required': ['qr_id', 'title', 'destination_url', 'short_code', 'shortlink_url', 'created_at', 'updated_at'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR.'}, 'title': {'type': 'string', 'title': 'Title', 'description': 'Human-readable title of the dynamic QR.'}, 'created_at': {'type': 'string', 'title': 'Created At', 'format': 'date-time', 'description': 'Creation timestamp in UTC.'}, 'short_code': {'type': 'string', 'title': 'Short Code', 'description': 'Short code segment used by the QR shortlink.'}, 'updated_at': {'type': 'string', 'title': 'Updated At', 'format': 'date-time', 'description': 'Last update timestamp in UTC.'}, 'qr_image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Qr Image Url', 'default': None, 'description': 'Primary public QR image URL, typically the generated SVG asset.'}, 'visits_total': {'type': 'integer', 'title': 'Visits Total', 'default': 0, 'minimum': 0, 'description': 'Total visits/scans recorded for this QR by QRCodeKIT.'}, 'qr_image_urls': {'type': 'object', 'title': 'Qr Image Urls', 'description': 'Public QR image or download URLs keyed by format, such as svg, png, pdf, or eps.', 'additionalProperties': {'type': 'string'}}, 'shortlink_url': {'type': 'string', 'title': 'Shortlink Url', 'description': 'Complete public shortlink URL encoded by the QR.'}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'description': 'Current destination URL for the dynamic QR.'}}}}, 'title': 'ListQrsResult', 'properties': {'items': {'type': 'array', 'items': {'$ref': '#/$defs/QrSummary'}, 'title': 'Items', 'description': 'QR codes visible to the active account.'}}}
set_link_slug
Change Link Slug
Change the custom slug (short code) of an existing QRCodeKIT short link, for any link type — e.g. turn qrkit.co/x7Ab9c into qrkit.co/summer-sale. The link keeps its identity and analytics. Use this only when the user explicitly wants to rename the short URL; to change a destination, use the corresponding save tool instead. WARNING: warn the user that the previous short URL stops redirecting and the QR image is regenerated, so any printed or shared copies of the old QR must be replaced.
破壊的操作あり 外部アクセスあり 冪等
入力スキーマ
{'type': 'object', 'title': 'set_link_slugArguments', 'required': ['qr_id', 'short_code'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'minLength': 1, 'description': 'Stable QRCodeKIT identifier for the link.'}, 'short_code': {'type': 'string', 'title': 'Short Code', 'pattern': '^[A-Za-z0-9._-]+$', 'maxLength': 128, 'minLength': 1, 'description': "New slug for the short link, such as 'my-campaign-2026'. Letters, digits, dots, hyphens, and underscores only. Must be unique within the short-link domain."}}}
出力スキーマ
{'type': 'object', '$defs': {'QrSummary': {'type': 'object', 'title': 'QrSummary', 'required': ['qr_id', 'title', 'destination_url', 'short_code', 'shortlink_url', 'created_at', 'updated_at'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR.'}, 'title': {'type': 'string', 'title': 'Title', 'description': 'Human-readable title of the dynamic QR.'}, 'created_at': {'type': 'string', 'title': 'Created At', 'format': 'date-time', 'description': 'Creation timestamp in UTC.'}, 'short_code': {'type': 'string', 'title': 'Short Code', 'description': 'Short code segment used by the QR shortlink.'}, 'updated_at': {'type': 'string', 'title': 'Updated At', 'format': 'date-time', 'description': 'Last update timestamp in UTC.'}, 'qr_image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Qr Image Url', 'default': None, 'description': 'Primary public QR image URL, typically the generated SVG asset.'}, 'visits_total': {'type': 'integer', 'title': 'Visits Total', 'default': 0, 'minimum': 0, 'description': 'Total visits/scans recorded for this QR by QRCodeKIT.'}, 'qr_image_urls': {'type': 'object', 'title': 'Qr Image Urls', 'description': 'Public QR image or download URLs keyed by format, such as svg, png, pdf, or eps.', 'additionalProperties': {'type': 'string'}}, 'shortlink_url': {'type': 'string', 'title': 'Shortlink Url', 'description': 'Complete public shortlink URL encoded by the QR.'}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'description': 'Current destination URL for the dynamic QR.'}}}}, 'title': 'ListQrsResult', 'properties': {'items': {'type': 'array', 'items': {'$ref': '#/$defs/QrSummary'}, 'title': 'Items', 'description': 'QR codes visible to the active account.'}}}
show_links
Show Links & QR Codes
Display the account's QRCodeKIT links in an interactive gallery: short URL, QR image, combined click-and-scan totals, and download actions. Available QR assets may include SVG, PNG, PDF, and EPS. Use this when the user asks to see, show, preview, display, or download their links or QR codes. When qr_id is provided, show only that link; otherwise show links from the active account.
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'title': 'show_linksArguments', 'properties': {'limit': {'type': 'integer', 'title': 'Limit', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Maximum number of links to render when qr_id is absent.'}, 'qr_id': {'anyOf': [{'type': 'string', 'minLength': 1}, {'type': 'null'}], 'title': 'Qr Id', 'default': None, 'description': 'Optional QRCodeKIT identifier for showing a single link instead of the gallery list.'}}}
出力スキーマ
{'type': 'object', '$defs': {'QrSummary': {'type': 'object', 'title': 'QrSummary', 'required': ['qr_id', 'title', 'destination_url', 'short_code', 'shortlink_url', 'created_at', 'updated_at'], 'properties': {'qr_id': {'type': 'string', 'title': 'Qr Id', 'description': 'Stable QRCodeKIT identifier for the QR.'}, 'title': {'type': 'string', 'title': 'Title', 'description': 'Human-readable title of the dynamic QR.'}, 'created_at': {'type': 'string', 'title': 'Created At', 'format': 'date-time', 'description': 'Creation timestamp in UTC.'}, 'short_code': {'type': 'string', 'title': 'Short Code', 'description': 'Short code segment used by the QR shortlink.'}, 'updated_at': {'type': 'string', 'title': 'Updated At', 'format': 'date-time', 'description': 'Last update timestamp in UTC.'}, 'qr_image_url': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'title': 'Qr Image Url', 'default': None, 'description': 'Primary public QR image URL, typically the generated SVG asset.'}, 'visits_total': {'type': 'integer', 'title': 'Visits Total', 'default': 0, 'minimum': 0, 'description': 'Total visits/scans recorded for this QR by QRCodeKIT.'}, 'qr_image_urls': {'type': 'object', 'title': 'Qr Image Urls', 'description': 'Public QR image or download URLs keyed by format, such as svg, png, pdf, or eps.', 'additionalProperties': {'type': 'string'}}, 'shortlink_url': {'type': 'string', 'title': 'Shortlink Url', 'description': 'Complete public shortlink URL encoded by the QR.'}, 'destination_url': {'type': 'string', 'title': 'Destination Url', 'description': 'Current destination URL for the dynamic QR.'}}}}, 'title': 'ListQrsResult', 'properties': {'items': {'type': 'array', 'items': {'$ref': '#/$defs/QrSummary'}, 'title': 'Items', 'description': 'QR codes visible to the active account.'}}}
追加
delete_link
2026年9月25日2:40
追加
set_link_slug
2026年9月25日2:40
追加
save_app_store_link
2026年9月25日2:40
追加
save_email_link
2026年9月25日2:40
追加
save_whatsapp_link
2026年9月25日2:40
追加
create_file_upload_session
2026年9月25日2:40
追加
render_file_upload_qr_form
2026年9月25日2:40
追加
save_file_url_qr
2026年9月25日2:40
追加
host_file
2026年9月25日2:40
追加
save_html_file_qr
2026年9月25日2:40
追加
save_short_link
2026年9月25日2:40
追加
get_link_stats
2026年9月25日2:40
追加
show_links
2026年9月25日2:40
追加
list_links
2026年9月25日2:40