# Mathpix MCP

Vendor: Mathpix  
Category: docs  
Auth: API_KEY  
Composio slug: `mathpix`

Mathpix extracts text, mathematics, tables, and other structured content from images and documents and converts results into editable formats.

## Verdict

Mathpix turns images of equations, PDFs, and handwritten notes into clean LaTeX, Markdown, or DOCX files your team can edit. @mention it to extract formulas from screenshots, convert lecture slides into structured text, or parse scanned research papers without retyping. The MCP handles OCR, format conversion, and file management — you get back machine-readable math and prose. Best for teams working with technical documents, academic content, or any workflow where manual transcription wastes hours. Auth requires a Mathpix API key; conversions bill against your account quota.

## Tools

- **Convert Mathpix Markdown** — Submit Mathpix Markdown, wait for one requested format to finish, then return the conversion ID and downloadable output file. The remote conversion remains if waiting fails or times out.
- **Create App Token** — Mint a short-lived client OCR credential, optionally with a live ink strokes session. Requires explicit acknowledgement because the response exposes the new secret exactly once to the caller.
- **Delete Conversion** — Permanently delete one Mathpix Markdown conversion's hosted output data after explicit confirmation. The response preserves the status immediately before deletion; Mathpix may continue to report that status after the output data has been de
- **Delete Document** — Permanently delete one Mathpix document source and its hosted outputs after explicit confirmation. The response reports the status immediately before deletion, not a deleted status marker, and cached downloads may remain reachable for up to
- **Delete File** — Permanently delete one terminal Files API file and its Mathpix-hosted results. This does not remove customer-owned destination objects, reverse billing, or delete a file that is still processing.
- **Finalize File Job** — Permanently close one Files API job to new file additions and arm its completion webhook. Already accepted files may continue processing. Requires explicit confirmation; repeating the same finalization is provider-idempotent.
- **Get App Token** — Get expiry and ownership metadata for a specific short-lived Mathpix app token. The secret token is used only in the request path and is omitted from the returned object and provider-error diagnostics.
- **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.
- **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.
- **Get File Job** — Get aggregate status, file and page counters, and timestamps for one Files API job. A completed job can still contain errored files; inspect files_errored and has_file_errors.
- **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.
- **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.
- **Get OCR Usage** — Return one page of aggregated Mathpix OCR usage for a date range, optionally grouped by usage type, request configuration, or application.
- **Get Storage Onboarding Identities** — Get the Mathpix AWS, Azure, and GCP identities needed to grant cloud-storage access. Requires explicit acknowledgement because the first call may lazily create the account's immutable external ID.
- **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.
- **List Data Sources** — List cloud-storage data sources registered with Mathpix, returning only allowlisted non-secret metadata.
- **List Documents** — List retained document OCR jobs for the connected account, optionally filtered by date or document ID, and return one page.
- **List File Job Files** — List one cursor-paginated page of files in a Mathpix Files API job, optionally filtered by terminal status.
- **List File Jobs** — List one cursor-paginated page of Files API jobs newest first, optionally bounded by inclusive UTC dates.
- **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. Mathpix retains the remote job after success; call Delete Document when the hoste
- **OCR Image** — Extract text, math, tables, diagrams, or chemistry from one image URL or base64 data URI and return the requested OCR representations. Mathpix may retain the submitted image and result, and provides no image deletion endpoint.
- **Process Equation (Deprecated)** — Compatibility-only access to Mathpix's deprecated equation-image OCR endpoint. Use MATHPIX_OCR_IMAGE for all new image OCR work. This paid operation may retain the submitted image and result in Mathpix history.
- **Process File URI** — Submit one public or registered-cloud document URI to the paid Files API, wait for OCR and one requested output, and return the retained file ID and downloadable result. Supply an idempotency key for safely retryable standalone submissions.
- **Process Image Batch** — Submit a paid asynchronous batch of 1-100 named public image URLs, wait until every key has a semantically successful OCR result, and return the retained batch ID and results. Explicit confirmation is required because Mathpix provides no ba
- **Recognize Strokes** — Recognize handwritten math or text from aligned x/y digital-ink stroke arrays and return OCR representations. This paid call may retain the result.
- **Revoke App Token** — Irreversibly revoke one short-lived app token immediately. Existing clients using the credential will stop authenticating. Requires explicit confirmation.
- **Search OCR Results** — Search retained image and stroke OCR history by date, identifiers, content, tags, or detected content and return one page of results.
- **Submit File Job** — Submit 1 to 200,000 remote documents as one paid asynchronous Mathpix Files job. This creates retained processing state and may read or write external storage or deliver callbacks. Acceptance defers per-file validation, so use job status an
- **Upload and Process File** — Upload one local document to the paid Mathpix Files API, wait until OCR and one requested output are ready, then return the retained Mathpix file ID and a downloadable result. The operation can consume page quota and does not delete the rem

## Setup

1. Create or open a Switchy Project.
2. Open Integrations and connect Mathpix.
3. Authorise through api_key.
4. Teammates can now @-mention Mathpix tools in chat.

---
Last verified: 2026-10-17T02:00:10.360Z  
Canonical URL: https://switchy.build/directory/mcps/mathpix