Open the browser Google login page and save tokens for this machine.

Starts a local callback on http://127.0.0.1:18765/callback, opens PromptReady Google OAuth, stores credentials under ~/.config/promptready/credentials.json (mode 600), and applies them to this process.

Users should run this once (or use CLI: promptready-mcp-login) instead of pasting tokens manually. Requires Supabase redirect allowlist for that URL.

Remove saved MCP credentials from this machine and clear env tokens.

Get the calling user's PromptReady credit balance.

Returns JSON: ok + credit_balance + email, or ok:false + error. Requires prior login (promptready-mcp-login / login tool) or env token.

Show saved convert defaults for this machine (not per-file options).

Defaults live in ~/.config/promptready/settings.json. convert_pdf always uses these until you change them with set_convert_settings.

Update saved convert defaults (persists for future convert_pdf calls).

Only pass fields you want to change. Example: set engine to paddle_vl15 once, then every convert uses that until changed again.

Args: engine: paddle | paddle_vl15 | glm_ocr include_tables: keep markdown tables include_images: include image/visual extraction (heavier) remove_references: strip references section when supported

Upload a local PDF/CSV and queue conversion (same credits as the web app).

Uses saved user settings (get_convert_settings / set_convert_settings), not per-call engine flags. Factory default: paddle, tables on, images off.

Args: path: Absolute or home-relative path to a .pdf or .csv file. wait: If true, poll until done and download markdown (can take many minutes). timeout_sec: Max wait when wait=true (default 3600). output_dir: Directory for downloaded .md when wait=true.

Returns JSON with job info; if wait=true and completed, includes local md path.

Get conversion status for the authenticated user's current session job.

Uses GET /api/v1/convert/status (session = user_id when logged in).

Poll get_status until completed/failed/cancelled, then download markdown if available.

Args: timeout_sec: Max seconds to wait (OCR can take many minutes). poll_interval_sec: Sleep between polls (default 3). output_dir: Where to write the .md file. source_path: Optional original file path (used only for output filename).