MCP Integration - Getting Started

Last updated Oct 12, 2026

Beta Notice: The MCP integration is currently in beta testing. Features and availability may change.

What is MCP?

MCP (Model Context Protocol) is an open protocol that allows AI assistants to interact with external tools and services. Twilee's MCP server enables AI assistants to manage QR codes, access analytics, and perform administrative tasks on your behalf.

Requirements

  • An active Twilee account. MCP access is included in every plan, the Free plan included, with the same limits as in the app (for example, one QR code on the Free plan).
  • An MCP-compatible AI client (such as Mistral, Claude, or ChatGPT).

Connection

In your AI assistant's MCP configuration, add the following URL as the MCP server:

https://twilee.com/_mcp

Authentication is handled via OAuth 2.0. You will be redirected to Twilee to authorize the connection.

Read and write access

The AI client asks for read access, or for read and write access. With read access only, the assistant can look at your QR codes, analytics and account, but it cannot create, update, duplicate or delete a QR code, upload a file, change your reporting settings or start an export. If you ask for one of these, the assistant tells you that write access is missing, and you can reconnect Twilee and allow it.

Capabilities

Through the MCP integration, AI assistants can:

  • Create & Manage QR Codes - Create, update, duplicate, and delete QR codes
  • Upload Files - Upload images, audio files, and PDFs for use in QR codes
  • Access Analytics - View scan statistics, timelines, and geographic data
  • Export Data - Export QR code data and scan history
  • Manage Settings - Configure reporting preferences and view account information

Supported QR Code Types

The MCP supports all Twilee QR code types:

  • URL, Text, Email, Call, SMS, vCard (Contact)
  • Event (Calendar), Links, Audio, File (PDF), Business, Lost & Found

Next Steps

See the Tools documentation for a complete reference of available operations.