file.cheap MCP tools cheat sheet

Use this page when choosing the smallest file.cheap MCP operation for an agent workflow. Every tool calls the local vault through fcheap mcp serve; no file.cheap API or cloud account is involved.

Tools

Tool	Use it to	Mutates state?	Important guardrail
fcheap_save	Snapshot a file or folder	Yes	Path must not overlap the vault; secrets are scanned
fcheap_list	Filter stash summaries	No	Prefer tags/tool/since before a broad list
fcheap_info	Read one full manifest	No	Stash IDs reject traversal and separators
fcheap_restore	Materialize and verify a stash	Yes	Omit target for a fresh temp directory
fcheap_drop	Permanently delete a stash	Yes	Requires force: true
fcheap_search	Search indexed files	No	Semantic/hybrid queries may reach the configured embedder
fcheap_analyze	Index a stash and optionally search it	Yes	Remote embedding of flagged content is blocked by default
fcheap_diff	Compare a stash with a directory	No	Reports only-in-stash, only-in-target, and changed files
fcheap_connect	Rank source code related to evidence	Yes, with indexing	Requires external vecgrep; results are leads, not proof
fcheap_vacuum	Remove orphaned derived entries and compact indexes	Yes	Payload manifests remain the source of truth
fcheap_ttl	Set or clear stash expiry	Yes	Expiry does not delete until sweep is applied
fcheap_sweep	Preview or apply expired-stash deletion	Optional	Preview is the default
fcheap_cleanup	Score cleanup candidates	Optional	Automatic drops are restricted to safe categories
fcheap_docs	List/read embedded docs or return the site URL	No	Read-only documentation access

Resources

Use resources when the client can read context without an action-oriented tool call:

fcheap://stashes
fcheap://stash/{id}

The first is the stash catalog. The second is the full manifest for one stash.

Prompts

• investigate_stash guides one saved artifact through inspection, search, and optional connection to source code.
• find_across_stashes searches for evidence across the vault and summarizes the best matches.

Safe agent policy

1. List or search before restoring large payloads.
2. Restore to a fresh temporary directory unless replacement is intentional.
3. Treat semantic matches and vecgrep candidates as leads.
4. Never set force: true or apply a cleanup plan without explicit user intent.
5. Surface secret warnings before any remote embedding decision.
6. Keep the stash ID in the investigation output so another agent can reproduce the evidence lookup.

For input fields and exact structured output, use the full MCP server reference. For client configuration, see Connect file.cheap to MCP clients.