---
title: "Mathpix integration for LuumenAI"
url: "https://www.luumen.ai/integrations/mathpix/"
entity: SoftwareIntegration
category: "AI & automation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Mathpix integration for LuumenAI

Turn scanned runbooks, diagrams, and vendor PDFs into text your team can search

## What LuumenAI can do with Mathpix

LuumenAI connects to Mathpix with an API token and exposes 28 tools (13 read-only · 6 write · 9 destructive). For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

## Key facts

- Authentication: API token
- Tools available: 28 tools (13 read-only · 6 write · 9 destructive)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: AI & automation

## About Mathpix with LuumenAI

Mathpix reads images and documents and returns text, mathematics, tables, and structured markup you can edit. Connect it with an API key and Luumen can check job status, list past conversions, pull finished output, and submit new documents for OCR. Submissions and deletions are previewed and held for your approval first.

## Example tools

Read-only (13 in total):

- `MATHPIX_GET_APP_TOKEN` — Get expiry and ownership metadata for a specific short-lived Mathpix app token.
- `MATHPIX_GET_CONVERSION_RESULT` — Wait for an existing Mathpix Markdown conversion and requested format to finish, then return its status and downloadable output file without creating a conversion.
- `MATHPIX_GET_DOCUMENT_RESULT` — Wait for an existing Mathpix document job and requested format to finish, then return its status and downloadable output file without creating a new job.
- `MATHPIX_GET_FILE_JOB` — Get aggregate status, file and page counters, and timestamps for one Files API job.
- `MATHPIX_GET_FILE_RESULT` — Wait for an existing Files API file and selected format to finish, then return its status and downloadable output without creating a file.
- `MATHPIX_GET_JOB_FILE_BY_CUSTOM_ID` — Get the complete Files API processing status for one job member using the exact caller-defined custom ID assigned at submission.
- `MATHPIX_GET_OCR_USAGE` — Return one page of aggregated Mathpix OCR usage for a date range, optionally grouped by usage type, request configuration, or application.
- `MATHPIX_LIST_CONVERSIONS` — List one page of retained Mathpix Markdown conversion records, optionally filtered by date, and return IDs usable by conversion result or deletion tools.

Write and destructive (15 in total, subject to configured approval policy):

- `MATHPIX_CONVERT_MATHPIX_MARKDOWN` — Submit Mathpix Markdown, wait for one requested format to finish, then return the conversion ID and downloadable output file.
- `MATHPIX_CREATE_APP_TOKEN` — Mint a short-lived client OCR credential, optionally with a live ink strokes session.
- `MATHPIX_DELETE_CONVERSION` — Permanently delete one Mathpix Markdown conversion's hosted output data after explicit confirmation.
- `MATHPIX_DELETE_DOCUMENT` — Permanently delete one Mathpix document source and its hosted outputs after explicit confirmation.
- `MATHPIX_DELETE_FILE` — Permanently delete one terminal Files API file and its Mathpix-hosted results.
- `MATHPIX_FINALIZE_FILE_JOB` — Permanently close one Files API job to new file additions and arm its completion webhook.
- `MATHPIX_GET_STORAGE_ONBOARDING_IDENTITIES` — Get the Mathpix AWS, Azure, and GCP identities needed to grant cloud-storage access.
- `MATHPIX_OCR_DOCUMENT` — Submit a PDF, office document, or ebook URL, wait for OCR and the requested conversion to finish, then return its Mathpix job ID and downloadable output file.

## Frequently asked questions

### How does LuumenAI connect to Mathpix?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Mathpix on its own?

For connected tools, admins configure which actions may run automatically and which require approval, within the access granted to the user.

### Is there an audit trail?

Every call to Mathpix — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/mathpix/