About
Turn scanned books (PDF or DjVu, up to 1,000 pages) into clean, searchable PDFs for Kindle, Kobo, reMarkable and tablets through FixMyScan's hosted MCP server (Streamable HTTP at https://mcp.fixmyscan.com/mcp, OAuth 2.1 with dynamic client registration and PKCE, no keys in config): crop pages to the text, straighten them, make them sharp black and white or greyscale, split two-page spreads and add a searchable text layer, then return a download link. Bundles the fixmyscan workflow skill. Agent Plugins v1 package (plugin.json + mcp.json + skills/), configuration only. Disclosure: hosted-only connector with no local code; every tool call goes to FixMyScan's server at mcp.fixmyscan.com, signed in as the user through FixMyScan's OAuth sign-in, and counts against that account's FixMyScan allowance or plan. The tool list comes from the server at run time, so the pinned commit doesn't cover it. fix_scan uploads the user's file or downloads the public link they give; files are deleted 24 hours after a book is ready. Write-capable tools: fix_scan and create_upload_link (start a book), cancel_scan and delete_scan (stop or delete one of the user's books). Tool results enter the session context and so reach the user's model provider. The package marks the server untrusted. OAuth must be enabled with `hermes mcp add fixmyscan --url https://mcp.fixmyscan.com/mcp --auth oauth`; the bundled mcp.json alone yields 401 on tool calls.
FixMyScan MCP server and agent skill
FixMyScan turns scanned books (PDF or DjVu, up to 1,000 pages) into clean, searchable PDFs for Kindle, Kobo, reMarkable and tablets: pages cropped and straightened, sharp black and white or gentle greyscale, two-page spreads split, searchable text added.
This repo holds the public connection details. The server itself is hosted.
Connect
Remote MCP server (Streamable HTTP, OAuth 2.1 sign-in):
https://mcp.fixmyscan.com/mcp
Setup for ChatGPT, Claude, Cursor and other MCP clients: fixmyscan.com/ai
Tools
| Tool | What it does |
|---|---|
| fix_scan | Starts a book from an attachment, a link or an upload |
| create_upload_link | Gives the reader a page to drop a PDF when the app can't pass files |
| preview_scan | Shows 3 pages before and after |
| get_scan_status | Progress, then the download link |
| list_my_scans | Books from the last 24 hours |
| cancel_scan, delete_scan | Stop or remove a book |
Agent skill
skills/fixmyscan/SKILL.md tells an agent how to use the MCP server or the REST API.
npx skills add FixMyScan/fixmyscan-mcp
REST API
Base URL https://api.fixmyscan.com/v1 with an API key from your account. Reference: openapi.json, developer page.
Files are deleted 24 hours after a book is ready.
README from the reviewed commit 1c87e4a; it updates when the author re-pins.
FixMyScan
