StayPut

io.github.keenanlkPublished by GitHub account keenanlkv0.1.0Updated Oct 24, 2026

Local PDF and photo tools: merge, split, rotate, number PDFs; strip photo GPS. No uploads.

VerifiedSTDIODesktop onlyFiles & StorageMedia & Design

Overview

AI-generated overview

Local MCP server that lets an assistant merge, split, rotate and number PDFs and strip GPS/EXIF metadata from photos, all on your own machine.

What you can do
  • Merge, split, extract or reorder pages, rotate and stamp page numbers on PDFs, and read page count, sizes and title
  • Convert JPG and PNG images into a single PDF without re-compression
  • Inspect a photo's hidden metadata (GPS location, camera, capture time) and write a cleaned copy with EXIF, GPS, XMP and comments removed
  • Every tool writes a new file and returns its path; inputs are never modified and existing files are never overwritten
When to use it
Useful when you want an assistant to do routine PDF assembly or page surgery and privacy cleanup of photos without uploading files to a web service. Good for invoices, contracts, theses and photos whose location data you want removed before sharing.
Requirements
Node.js 20 or newer; installed as the npm package stayput-mcp and run locally over stdio (for example via npx). No account, API key or network access is needed. Encrypted PDFs are decrypted locally with qpdf; password-protected PDFs need the password passed in the password argument.
Before you install
Tools write new files to disk, so point it at folders you are comfortable having written to; relative paths resolve from the folder the server was started in. For password-protected PDFs the password is passed to the assistant as a tool argument, so it appears in the conversation. Photo metadata inspection reveals location data, and the server makes no network requests, so files stay local.

Installation

In SourceWeft

  1. Open StayPut in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Stayput MCP server

Local PDF and photo tools for Claude, Cursor, VS Code and any other app that speaks the Model Context Protocol. Ask your assistant to merge PDFs, pull out pages, or remove the GPS location from a photo, and it does the work on your own machine.

It runs the same code as stayput.dev, the browser version. Your files are read from disk and written back to disk; nothing is uploaded, and the server makes no network requests. It is free and open source (MIT), with no account and no API key.

Tools

ToolWhat it does
merge_pdfsCombine PDFs into one, in the order given
extract_pdf_pagesKeep only some pages, reorder them ("3,1,2") or drop pages
split_pdfSplit into one file per page, or every N pages
rotate_pdfRotate all pages or chosen pages by 90, 180 or 270 degrees
number_pdf_pagesStamp page numbers, e.g. "Page {n} of {total}"
pdf_infoPage count, page sizes and title
images_to_pdfJPG and PNG images into one PDF, one per page, no re-compression
inspect_image_metadataShow GPS location, camera, capture time and other hidden metadata in a photo
strip_image_metadataWrite a copy of a JPG, PNG or WebP with EXIF, GPS, XMP and comments removed, without re-encoding

Every tool writes a new file and returns its path. Input files are never modified, and an existing file is never overwritten (you get file-1.pdf instead). Encrypted PDFs (bank statements, forms with printing restrictions) are decrypted locally with qpdf; for PDFs that need a password to open, the assistant passes it in the password argument.

Install

Requires Node.js 20 or newer.

Claude Code

sh
claude mcp add stayput -- npx -y stayput-mcp

Claude Desktop, Cursor, Windsurf and other JSON configs (claude_desktop_config.json, .cursor/mcp.json, ...)

json
{  "mcpServers": {    "stayput": {      "command": "npx",      "args": ["-y", "stayput-mcp"]    }  }}

VS Code

sh
code --add-mcp '{"name":"stayput","command":"npx","args":["-y","stayput-mcp"]}'

Then ask things like:

  • "Merge invoice-march.pdf and invoice-april.pdf in ~/Downloads"
  • "Take pages 2 to 5 out of contract.pdf"
  • "Does IMG_2041.jpg have a location in it? If so, make a copy without it"
  • "Number the pages of thesis.pdf, starting on page 3"

Relative paths are resolved from the folder the server was started in, so absolute paths or ~/... are the safest thing to give it.

Not covered here

HEIC, WebP and AVIF conversion, compression, PDF to image and PDF signing need a browser engine. They are on stayput.dev, which works the same way: in your browser, nothing uploaded.

Development

sh
cd mcpnpm installnpm test   # builds dist/index.js and runs the end-to-end tests

The tests use the site's fixtures; generate them first from the repository root with python3 tests/fixtures/make-fixtures.py && node tests/fixtures/make-pdf.mjs (needs Pillow and pillow-heif).

The server imports the PDF and metadata code from ../src/lib and bundles it with esbuild (build.mjs). Two browser-only modules are swapped at build time: src/unlock.ts loads qpdf from node_modules instead of a <script> tag, and src/no-canvas.ts stands in for the canvas helpers that only PDF compression uses.

Source: mcp/README.md at commit 49a7dce

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 29, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts