MCP server for terminal commands, file operations, and process management
StayPut is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Stayput MCP gives your AI assistant nine tools for PDFs and photos: merge, split, extract, rotate and number PDF pages, turn JPG and PNG images into a PDF, and inspect or remove photo metadata such as GPS location. It runs on your own computer with Node.js 20 or newer. Files are read from disk and saved as new copies, and the server makes no network requests. Free, open source (MIT), no account or API key. The browser version is at stayput.dev.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user stayput-mcp '--' npx -y stayput-mcp
# 2 — ask your agent for something these tools do
# pdf_info, merge_pdfs, extract_pdf_pages and 6 more
StayPut costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts StayPut as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. Its scan result is on the Security tab — read the surface before you approve it.
This is a public server: you run it yourself and this marketplace is not in the path. You need Node.js — the current LTS (24) is the safe choice; npx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. The '--' is in quotes so that PowerShell passes it on.
claude mcp add --scope user stayput-mcp '--' npx -y stayput-mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.
9 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
Read a PDF on this machine and report its page count, page sizes, title and whether it was encrypted. Use before splitting, extracting or rotating to learn how many pages there are.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | yes | Path to the PDF. |
| password | string | no | Password for a PDF that asks for one when opened. Used only on this machine. |
Combine several PDFs on this machine into one, in the order given. The same file may appear more than once. Writes a new PDF and returns its path.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inputs | array | yes | PDF paths, in the order their pages should appear. |
| output | string | no | Where to write the result. Defaults to a new file beside the input. Existing files are never overwritten; a free name like file-1.pdf is used instead. |
| password | string | no | Password for a PDF that asks for one when opened. Used only on this machine. |
Write a new PDF containing only the listed pages, in the listed order. Use it to pull out a range, reorder pages ("3,1,2") or drop pages (list the ones to keep). Pages are 1-based; ranges like "1-3, 7" and reversed ranges like "5-1" work.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| input | string | yes | Path to the PDF. |
| pages | string | yes | Pages to keep, for example "1-3, 7" or "3,1,2". |
| output | string | no | Where to write the result. Defaults to a new file beside the input. Existing files are never overwritten; a free name like file-1.pdf is used instead. |
| password | string | no | Password for a PDF that asks for one when opened. Used only on this machine. |
Split a PDF into several files of N pages each (1 = one file per page), written into a folder. Returns the list of files.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| input | string | yes | Path to the PDF. |
| pages_per_file | integer | no | Pages in each output file. Default 1. |
| output_dir | string | no | Folder for the parts. Defaults to a new folder beside the input named <file>-split. |
| password | string | no | Password for a PDF that asks for one when opened. Used only on this machine. |
Rotate all pages, or only the listed ones, clockwise by 90, 180 or 270 degrees, and save the rotation permanently in a new PDF.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| input | string | yes | Path to the PDF. |
| degrees | yes | Clockwise rotation to add. | |
| pages | string | no | Pages to rotate, for example "1, 3-4". Default: every page. |
| output | string | no | Where to write the result. Defaults to a new file beside the input. Existing files are never overwritten; a free name like file-1.pdf is used instead. |
| password | string | no | Password for a PDF that asks for one when opened. Used only on this machine. |
Stamp page numbers on a PDF. The template may use {n} for the page number and {total} for the last number, e.g. "Page {n} of {total}".
| Parameter | Type | Required | Notes |
|---|---|---|---|
| input | string | yes | Path to the PDF. |
| template | string | no | Text to print. Default "{n}". |
| position | string | no | — |
| start | integer | no | Number printed on the first numbered page. |
| first_page | integer | no | First page (1-based) that gets a number; earlier pages, such as a cover, are left blank. |
| font_size | number | no | — |
| output | string | no | Where to write the result. Defaults to a new file beside the input. Existing files are never overwritten; a free name like file-1.pdf is used instead. |
| password | string | no | Password for a PDF that asks for one when opened. Used only on this machine. |
Put JPG and PNG images into one PDF, one image per page, in the order given. Images are embedded as they are, without re-compression.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| inputs | array | yes | JPG or PNG paths, in page order. |
| page_size | string | no | "fit" makes each page the size of its image; "a4" and "letter" centre the image on a standard page. |
| margin | number | no | Margin in points (72 = 1 inch). |
| output | string | no | Where to write the result. Defaults to a new file beside the input. Existing files are never overwritten; a free name like file-1.pdf is used instead. |
Report the metadata hidden in a JPG, PNG or WebP photo: GPS location, camera make and model, capture time, editing software, and which blocks (EXIF, XMP, IPTC, comments) are present. HEIC files report EXIF only.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| path | string | yes | Path to the image. |
Write a copy of a JPG, PNG or WebP photo with EXIF (including GPS location), XMP, IPTC and comments removed. Lossless: the image data is not re-encoded. The original file is left untouched.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| input | string | yes | Path to the image. |
| keep_color_profile | boolean | no | Keep the ICC colour profile so colours look the same. Default true. |
| output | string | no | Where to write the cleaned copy. Defaults to <name>-clean.<ext> beside the input. Existing files are never overwritten. |
- Every tool, no call limit
- No card, and mcprush charges nothing for it
- Source published under MIT
- Runs on your machine — nothing of it reaches our gateway
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install StayPut or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
| Term | Level | What it prices | Points |
|---|---|---|---|
| capability-exposure | moderate | capability blast radius (moderate) — client exposure if the model is manipulated | −3 |
| verification-discount | repo | publisher verification (public source) — no provenance, but the source is public and inspectable | −1 |
| coverage-honesty | source | inspection depth (source) — how much of the target the scan could see | −0 |
What the scan could actually read
A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.
Tools were statically extracted from the published source (9 recovered), not enumerated from a running server. Tool-poisoning, Unicode-smuggling, capability and toxic-flow analysis ran on this inferred surface, but a mis-parsed registration could be missed or mis-attributed, so tool-derived findings are capped below “confirmed”. To grade the real runtime surface, scan the running server: --command "npx -y <package>".
Capability — what it could do if the model were manipulated
Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.
| Tool | Capability tags | Why the tag was assigned |
|---|---|---|
| pdf_info | no tags | |
| merge_pdfs | state-write | state-write: declares readOnlyHint: false |
| extract_pdf_pages | state-write | state-write: declares readOnlyHint: false |
| split_pdf | state-write | state-write: declares readOnlyHint: false |
| rotate_pdf | state-write | state-write: declares readOnlyHint: false |
| number_pdf_pages | state-write | state-write: declares readOnlyHint: false |
| images_to_pdf | state-write | state-write: declares readOnlyHint: false |
| inspect_image_metadata | no tags | |
| strip_image_metadata | state-write | state-write: declares readOnlyHint: false |
Toxic-flow graph
The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.
The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.
Supply chain and provenance
This is the first scan of this surface here, so there is nothing yet to compare it against.
Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.
Release history
Always latest — the install command names no version, so it installs the newest release when it runs; the current release on file is 0.1.0. Pin a release below and the command asks for exactly that one.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish StayPut can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.