The Stripe for Printing

Full REST API Guide → OpenAPI Reference

{
  "mcpServers": {
    "labelinn": {
      "command": "npx",
      "args": ["-y", "@labelinn/mcp-server"],
      "env": { "LABELINN_API_KEY": "sk_live_..." }
    }
  }
}

Full MCP Guide →

// 1. Discover the Edge Server on your LAN
const health = await fetch('http://192.168.1.100:6631/local/v1/health');
//  { status: "ok", server: "LabelInn Edge Server", mode: "hybrid", ... }

// 2. List connected printers
const printers = await fetch('http://192.168.1.100:6631/local/v1/fleet/printers', {
  headers: { 'Authorization': 'Bearer YOUR_EDGE_TOKEN' }
});
//  { printers: [{ id: "usb_zebra_01", name: "ZD420", ... }], count: 1 }

// 3. Print a label — returns instantly (HTTP 202)
const job = await fetch('http://192.168.1.100:6631/local/v1/print/jobs', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_EDGE_TOKEN',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    printerId: 'usb_zebra_01',
    payloadType: 'zpl',
    payloadData: '^XA^FO50,50^ADN,36,20^FDHello Edge^FS^XZ',
    copies: 1
  })
});
//  { jobId: "abc-123", status: "accepted" }

// 4. Poll for result
const result = await fetch('http://192.168.1.100:6631/local/v1/jobs/abc-123', {
  headers: { 'Authorization': 'Bearer YOUR_EDGE_TOKEN' }
});
//  { jobId: "abc-123", success: true, printedLabels: 1 }

// ── Cloud API: Discover printers on a remote device ──

// 1. Start a discovery session (target a specific device or any online device)
const session = await fetch('https://labelinn.com/v1/fleet/discover', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_xxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ device_id: 'dev_warehouse_pc' })
});
//  { data: { session_id: "abc123", status: "pending" } }

// 2. Poll until discovery is complete
const results = await fetch('https://labelinn.com/v1/fleet/discover/abc123', {
  headers: { 'Authorization': 'Bearer sk_live_xxx' }
});
//  { data: { status: "complete", printers: [
//      { name: "ZD420", address: "192.168.1.50", brand: "ZEBRA", is_thermal: true },
//      { name: "Brother QL-820", address: "USB001", connection_type: "usb" }
//    ], count: 2 } }

// 3. Add a discovered printer to your fleet
const printer = await fetch('https://labelinn.com/v1/fleet/discover/abc123/add', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer sk_live_xxx',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({ address: '192.168.1.50', name: 'Warehouse Zebra #3' })
});
//  { data: { id: "prt_a1b2c3d4e5f6", name: "Warehouse Zebra #3", status: "registered" } }

// 4. Now print to it!
await fetch('https://labelinn.com/v1/print/jobs', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer sk_live_xxx', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    printer_id: 'prt_a1b2c3d4e5f6',
    payload_type: 'template',
    design_id: 'tmpl_shipping',
    data: { name: 'Jane Doe', order: 'ORD-4521' }
  })
});

// 1. Test-parse your data first (no storage, no cost)
const preview = await fetch('https://labelinn.com/v1/connect/test-parse', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer sk_test_YOUR_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({
    payload: 'name,sku,qty,price\nWidget,SKU-001,50,9.99\nGadget,SKU-002,30,14.50',
    format: 'csv'
  })
});
//  { schema: [{path:"name",type:"string"}, {path:"qty",type:"number"}, ...], records_preview: [...] }

// 2. Push real data & print labels — 2 API calls
const result = await client.connect.ingest({
  source_id: "conn_sap_orders",
  payload: xmlFromSAP,
  format: "xml",
  config: { repeatPath: "IDOC.E1EDP01" }
});

await client.connect.sources.print("conn_sap_orders", {
  printer_id: "prt_warehouse_01",
  design_id: "dsg_shipping_label",
  ingest_id: result.data.ingest_id
});

View OpenAPI 3.0.3 Spec AI Plugin Manifest npm: labelinn PyPI: labelinn NuGet: LabelInn