Check whether the wrapped local ppt API is reachable.

List human-friendly routes for the user to choose from.

Do not choose, infer, or recommend a route on the user's behalf. The next step is to ask the user to pick one route, then call ppt_check_route with that route and route_confirmed=true.

Lock a high-level route workflow after the user explicitly confirms it.

This is step 1 of the high-level guided flow. It only locks the route and returns a route_workflow_id. Then use ppt_set_conversion_target, ppt_list_route_models if needed, ppt_set_route_options, and finally ppt_convert_pdf.

Write pdf_path and page range decisions into a locked route workflow.

This is step 2 of the high-level guided flow. Use it to persist conversion target state so weaker models do not have to remember page ranges from chat history. pdf_path must be a real local PDF path explicitly provided by the user. Do not treat the page scope as complete until page_range_confirmed=true is explicitly written for the currently selected pages.

Write scanned-page, footer, and AI model decisions into the workflow.

This is step 3 of the high-level guided flow. Use ppt_list_route_models first when the user wants to select a non-default AI OCR model. Do not use this tool before pdf_path and page range are confirmed.

Submit the locked high-level workflow after target and options are ready.

Create a PDF-to-PPT conversion job from a local pdf_path.

The PDF is read from local disk by this MCP server, then uploaded to the running ppt API. This is the low-level escape hatch. For normal use prefer ppt_list_routes -> ppt_check_route -> ppt_set_conversion_target -> ppt_list_route_models (if needed) -> ppt_set_route_options -> ppt_convert_pdf.

Never use this tool unless the user explicitly asks to bypass the guided route workflow and confirms low_level_override_confirmed=true. The pdf_path must be a real existing local PDF path explicitly provided by the user.

List recent conversion jobs from the wrapped local ppt API.

Get the current status, stage, progress, and errors for a job.

Cancel a pending or running conversion job.

Return debug/process artifact metadata for a job.

Download the completed PPTX result to a local output path.

Download a retained artifact file to a local output path.

List candidate models for the currently locked high-level route workflow.

Only use this after pdf_path and page range are already confirmed on the same route_workflow_id.

Low-level raw model discovery. Prefer ppt_list_route_models in normal OCR flows.

Only repeat the exact returned model IDs to the user. Do not invent provider categories, unofficial aliases, or recommendations.

Probe whether a model can work on the current AI OCR chain.