Promptready MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/hydrojwh-promptready-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.

Tools

4 read · 3 write · 1 delete · 1 not yet classified

Secrets

None asked for

Install scripts

None found

Runs as

Python package

Tools (9)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• convert_pdf

  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. The download can lag…

• get_convert_settings

  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.

• get_credits

  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.

• get_status

  Get conversion status — durable by log_id, session memory otherwise. With log_id (the UUID from convert_pdf's response): reads the DB-backed usage row (GET /users/usage) — survives backend restarts, redeploys and back-to-back converts. Status is the DB value (pending / completed / failed / cancelled). Without log_id: reads the session status (GET /convert/status); if the server no longer knows the session job ("not_found" — restart, scale-to-zero), falls back to the most recent usage row and says which file it picked.

• list_conversions

  List this account's recent conversions (DB-backed, restart-proof). Each entry: log_id, file_name, page_count, credits, status (pending/completed/failed/cancelled), created_at, expires_at, engine_used, and downloadable (completed ∧ result retained — false once the 3-hour window passed). Use a log_id with wait_and_download to fetch any downloadable result, even after a server restart.

• login

  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. After sign-in the browser returns to the local callback URL; no Supabase configuration is required.

• logout

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

• 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 once, then every convert uses that until changed again. Args: engine: paddle (PaddleOCR-VL-1.6) | deepseek_ocr (DeepSeek-OCR) | glm_ocr (GLM-OCR) include_tables: keep markdown tables include_images: include image/visual extraction (heavier) remove_references: strip references section when supported

• wait_and_download

  Wait for a conversion to finish, then save its markdown. Durable path (0.4.0): pass log_id (UUID from convert_pdf's response or list_conversions) — status comes from the DB usage row and the file from GET /convert/download/{log_id}, so the result survives backend restarts and later converts. 410/404 there mean the 3-hour retention window closed: the stored result is gone and converting again (fresh credits) is the only way to get it. Without log_id: polls the session status as before (free reads); if the server reports not_found, falls back to the most recent usage row and says which file wa…

Compare and alternatives

Featured in

• Best MCP servers for OCR

Signals

Stars

0

Forks

0

Open issues

0

Weekly downloads

238

Last commit

Oct 4, 2026 (24 days ago)

Last release

Oct 2, 2026 (26 days ago)

Last package publish

Oct 2, 2026 (26 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.hydrojwh/promptready-mcp

Version

0.4.0

Auth

No auth

Packages

pypi promptready-mcp

License

MIT

Repository

github.com/hydrojwh/promptready-mcp

Website

promptready.space

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql