Developer Tool

Test Print — Deep Link & Print Bridge

Two apps, three real deep-link combinations. Choose your app and platform below to build and test the right link — parameters, Universal/App Links, and QR codes included.

Quick answer: Deep-link printing works on three of four app/platform combinations today — Simple Bluetooth Printer on both iOS and Android, and Bluetooth Printer+ on Android. Only Bluetooth Printer+ on iOS isn't supported, because that app has no iOS build. Pick below to build a real link for your combination.

1 Choose your app
2 Choose your platform
Simple Bluetooth Printer supports a real deep link on iOS — build one below.
Building this on your own site or backend? Encode every query value with encodeURIComponent(), not URLSearchParams and not raw string concatenation. URLSearchParams turns spaces into +, but neither Android's Uri.getQueryParameter() nor iOS's URLComponents convert + back into a space when reading the link — only %20 decodes correctly. Skip this and column-aligned text (like the receipt sample below) will print with literal plus signs instead of blanks. The links this page generates for you already do this correctly.
Simple Bluetooth Printer · iOS

Build a Deep Link or Universal Link

Supports four content types — text, receipt, invoice, and image — plus device targeting, copies, and dithering for images.

Supports formatting markers like {{BOLD_ON}}, {{ALIGN_CENTER}}, {{DATE}}.
Auto-printOn (default): prints immediately. Off: loads into the editor for review.
Open →
QR code for this link
Scan from an iPhone to test
{{BOLD_ON}} / {{BOLD_OFF}} — bold text
{{ALIGN_CENTER}} — center align from here on
{{LINE}} — divider line
{{DATE}} / {{TIME}} — current date/time
iOS only. A plain link prints immediately by default (autoprint defaults to true) once a printer is connected or reachable — add autoprint=false when you want the user to review the content first, e.g. for a first-time integration or an untrusted source. The Universal Link needs the app's Associated Domain verification to succeed on first use.
Simple Bluetooth Printer · Android

Build a Deep Link or App Link

Plain text with formatting markers, a real Bluetooth MAC address for direct printer targeting, and a configurable text encoding.

Supports formatting markers like {{BOLD_ON}}, {{ALIGN_CENTER}}, {{DATE}}.
Open →
QR code for this deep link
Scan from another Android phone to test
{{BOLD_ON}} / {{BOLD_OFF}} — bold text
{{ALIGN_CENTER}} — center align from here on
{{LINE}} / {{DOUBLE_LINE}} — divider line
{{DATE}} / {{TIME}} — current date/time
{{PAPER_CUT}} / {{OPEN_DRAWER}} — cutter and cash drawer
Android only. Unlike iOS, Android exposes the printer's real Bluetooth MAC address — leave it blank and the app shows a printer picker instead of failing. The App Link uses the same bluetoothprinter.in/print host as iOS's Universal Link, verified via assetlinks.json.
Bluetooth Printer+ · Android

Build a btprinterplus:// Link

A simpler scheme — plain text with markup and optional Strict Mode, printed directly.

Supports **bold**, [center]/[right]/[small], [qr]...[/qr], and an 8+ dash divider.
Strict ModeRenders as a dithered image instead of raw text — pixel-for-pixel accurate, slower.
QR code for this deep link
Scan from another Android phone to test
**bold** — bold text
[center]...[/center] — center align
[right]...[/right] — right align
[qr]data[/qr] — print a QR code
-------- (8+ dashes) — divider line
Android only. Requires Bluetooth Printer+ already installed with a default printer already configured on that exact device — the link is fire-and-forget and won't report back if either is missing.
📵

No iOS app

Bluetooth Printer+ doesn't have an iOS version at all — it's Android only. To print from an iPhone using this app's connected printer, use Print Bridge below to send a job to it remotely instead.

Jump to Print Bridge →
Print Bridge · MCP & API

Connect an AI Agent or Your Backend

No deep link needed — Print Bridge runs a full Model Context Protocol server at printbridge.bluetoothprinter.in/mcp that Claude, ChatGPT, and any MCP-compatible agent can call directly. Works from any OS, since the agent — not your phone — makes the connection.

Option A — your API key, for your own paired devices

Add this to your MCP client's config — for Claude Desktop, that's claude_desktop_config.json:

{
  "mcpServers": {
    "print-bridge": {
      "url": "https://printbridge.bluetoothprinter.in/mcp",
      "headers": { "X-API-Key": "prk_xxxxxxxxxxxxxxxxxxxx" }
    }
  }
}

Get your key from the "API key" card on the printbridge.bluetoothprinter.in dashboard, then just ask your agent: "Print 'Hello from Claude!' to my printer." It calls print_text automatically.

Option B — no API key, just a 12-digit code

Open the Print Bridge screen on the receiving phone for its live code, then ask your agent: "Print 'Table 4 ready' using code 384729104756." It calls print_now, which needs nothing but the code.

What the MCP tools can do

ToolNeeds API key?Does
print_textYesPrint plain text to a paired device
print_orderYesPrint a structured order receipt
print_formattedYesPrint lines with bold/underline/divider/align/QR
list_devicesYesList your paired phones and their status
get_job_status / list_recent_jobsYesCheck what happened to a print job
print_nowNoPrint using a phone's temporary 12-digit code
generate_print_linkNoBuild a btprinterplus:// link for a human to tap on their own phone
get_setup_helpNoExplains any of the 7 Print Bridge integrations, with correct code
Open printbridge.bluetoothprinter.in →
Account-scoped tools (print_text, print_order, print_formatted, etc.) share the same free-tier limit as Print From Anywhere and Order Print: 10 total prints per device. print_now and generate_print_link need no account at all. See the full MCP setup guide for REST API and webhook details.
Cross-Platform — Print Bridge

Send From Android, iPhone, or Desktop

A Bluetooth Printer+ feature — no deep link, no app install on the sending device, just a live 12-digit code shown on the receiving Android phone.

1

On the Android phone with the printer connected

Open Bluetooth Printer+ → Developer Space → Print From Anywhere. A live 12-digit code appears — it's only valid while this screen stays open.

2

On the sending device — iPhone, another Android, or a laptop

Open printbridge.bluetoothprinter.in in any browser, enter the 12-digit code, and type or paste a message in the Plain Text or Formatted Lines tab.

3

Tap Print

The job pushes to the Android phone and prints on its connected printer — no login, no API key, on either side.

Open Print Bridge →
Free plan: 10 total prints per device, shared with Order Print. Code goes dead the moment the Print From Anywhere screen closes. No [[placeholder]] resolution on this path — type the final text you want printed.
FAQ

Common Questions

Three: Simple Bluetooth Printer on iOS (thermalprint:// or btprinter://, plus a Universal Link), Simple Bluetooth Printer on Android (btprinter://, plus an App Link), and Bluetooth Printer+ on Android (btprinterplus://). Only Bluetooth Printer+ on iOS is unsupported, because that app has no iOS build.
Yes, for Simple Bluetooth Printer — it has a real, working deep link and Universal Link on iOS. Bluetooth Printer+ has no iOS app at all, so its btprinterplus:// link only works on Android.
Android can target a printer by its real Bluetooth MAC address (device_address), since Android exposes real MAC addresses to apps. iOS uses a CoreBluetooth UUID instead, since Apple hides real MAC addresses for privacy. Android also supports a text encoding parameter (encode_format) that iOS doesn't have.
The matching app must already be installed on that exact device. For Bluetooth Printer+, a printer must already be configured too. The link is fire-and-forget — it does not report back or show an error if the app or printer is missing.
No. A phone running the matching app and connected to a physical printer is always part of the loop. Print Bridge only changes how you trigger a print remotely — it does not remove the need for that phone and printer to exist.
Yes. Print Bridge runs a Model Context Protocol (MCP) server at printbridge.bluetoothprinter.in/mcp. Connect with an API key for your own paired devices, or with no key at all using a phone's temporary 12-digit code — the agent then calls tools like print_text, print_order, or print_now.

See all 7 ways to print with Print Bridge → · Bluetooth Printer+ overview → · Simple Bluetooth Printer overview →