Menu

Mattering QR MCP tools

11 tools on the Mattering MCP gateway at https://mcp.mattering.io/mcp. Each call forwards your token to the QR User API, so a tool can do exactly what your key can do.

Connect any MCP client to https://mcp.mattering.io/mcp; it discovers the Mattering sign-in and asks you to approve the tools it may use. Tool names, parameters and descriptions below are read from the gateway source. See the MCP gateway concept page for connection details.

Diagnostics

qr_list_capabilities

List the QR service's registered capabilities (debug helper).

Full description

List the QR service's registered capabilities (debug helper).

Returns the available capability names, HTTP methods, paths, categories, and required / optional parameter lists. Useful for discovering what the service exposes without paging through the docs.

Takes no parameters.

QR Codes

qr_create_code

Create a QR code or short link in a workspace.

Full description

Create a QR code or short link in a workspace.

Required: workspace_id, title, destination_url (the URL it forwards to; may point to any external platform). The server mints a stable short code; the QR image encodes /r/<short_code>.

Optional:
  - slug: custom vanity back-half (/r/<slug>). Lowercase letters,
    numbers, hyphen, underscore; 2-64 chars; must be unique.
  - kind: "qr" (default), "link", or "both".
  - file_format: "png" (default) or "pdf".
  - color_mode: "rgb" (default) or "cmyk" (PDF only).
  - utm_source / utm_medium / utm_campaign: merged into the
    destination at redirect time; stored so they stay editable.
  - starts_at / expires_at: ISO-8601; outside the window the
    link returns 410 Gone.
  - password: gate the link behind a password (visitors see an
    interstitial before forwarding; scans count only after unlock).
The response includes primary_url and public_asset_urls.

Parameters

NameTypeRequiredDefault
workspace_idstrrequirednone
titlestrrequirednone
destination_urlstrrequirednone
slugOptional[str]optionalnone
kindOptional[str]optionalnone
file_formatOptional[str]optionalnone
color_modeOptional[str]optionalnone
utm_sourceOptional[str]optionalnone
utm_mediumOptional[str]optionalnone
utm_campaignOptional[str]optionalnone
starts_atOptional[str]optionalnone
expires_atOptional[str]optionalnone
passwordOptional[str]optionalnone

Calls

qr_delete_code

Delete a QR code / short link by its short code (cascades scans + aliases).

Parameters

NameTypeRequiredDefault
short_codestrrequirednone

Calls

qr_get_code

Get a single QR code by its public short code (the /r/<short_code> token).

Parameters

NameTypeRequiredDefault
short_codestrrequirednone

Calls

qr_list_codes

List QR codes. Optional ``workspace_id`` scopes to one workspace.

Parameters

NameTypeRequiredDefault
workspace_idOptional[str]optionalnone

Calls

qr_manage_alias

Manage a code's vanity aliases.

Full description

Manage a code's vanity aliases.

action="add" (default) adds/promotes slug as the primary vanity path; action="remove" deactivates it (never hard-deleted once it has scans, so already-shared links keep resolving until deactivated). The canonical short_code always keeps working.

Parameters

NameTypeRequiredDefault
short_codestrrequirednone
slugstrrequirednone
actionstroptional'add'

qr_manage_rule

Manage a link's device/country routing rules.

Full description

Manage a link's device/country routing rules.

action="list" (default) returns the ordered rules. action="add" creates a rule: match_type is "device" (match_value one of mobile/tablet/desktop) or "country" (match_value a 2-letter ISO code), routing a matching visitor to destination_url. ``action= "remove" deletes the rule identified by rule_id``. Rules are checked in order; the first match wins, otherwise the default destination is used.

Parameters

NameTypeRequiredDefault
short_codestrrequirednone
actionstroptional'list'
match_typeOptional[str]optionalnone
match_valueOptional[str]optionalnone
destination_urlOptional[str]optionalnone
rule_idOptional[int]optionalnone

Calls

qr_update_code

Re-point, retitle, reschedule, or re-slug an existing code.

Full description

Re-point, retitle, reschedule, or re-slug an existing code.

Required: short_code (the immutable canonical code: never changes). Optional: destination_url (re-points every already-printed code), title, is_active (deactivate returns 410), slug (set/rename the vanity path; the old path keeps resolving), kind, file_format, color_mode, utm_source/utm_medium/utm_campaign, starts_at/expires_at (ISO-8601; '' clears), password (a non-empty value sets a password gate; '' removes it).

Parameters

NameTypeRequiredDefault
short_codestrrequirednone
destination_urlOptional[str]optionalnone
titleOptional[str]optionalnone
is_activeOptional[bool]optionalnone
slugOptional[str]optionalnone
kindOptional[str]optionalnone
file_formatOptional[str]optionalnone
color_modeOptional[str]optionalnone
utm_sourceOptional[str]optionalnone
utm_mediumOptional[str]optionalnone
utm_campaignOptional[str]optionalnone
starts_atOptional[str]optionalnone
expires_atOptional[str]optionalnone
passwordOptional[str]optionalnone

Calls

QR workspaces

qr_create_workspace

Create a workspace in a space.

Full description

Create a workspace in a space.

Required: space_id, name. Optional: description, color (hex, e.g. #00BFFF).

Parameters

NameTypeRequiredDefault
space_idstrrequirednone
namestrrequirednone
descriptionOptional[str]optionalnone
colorOptional[str]optionalnone

Calls

qr_list_workspaces

List workspaces (QR groupings). Optional ``space_id`` scopes to one space.

Parameters

NameTypeRequiredDefault
space_idOptional[str]optionalnone

Calls

Spaces

qr_list_my_spaces

List QR spaces accessible to the current user.

Full description

List QR spaces accessible to the current user.

Empty results are annotated with the resolved identity so an empty list can be told apart from an identity mismatch.

Takes no parameters.

Calls

Identity tools (every app)

The gateway registers these once, outside any app family. Call whoami first when a result looks empty.

auth_statusReport token health, expiry, bound principal, and catalog version.
get_accountReturn the current user's account profile (email, name, id).
get_organizationReturn the organization this session is currently acting as.
list_organizationsList every organization the authenticated identity belongs to.
reauthenticateExplain how to refresh this connection's authentication.
switch_accountExplain how to re-authenticate as a different account / org.
whoamiShow who this MCP session is authenticated as.
Start Free Explore our Products