pastepile_remember

Save the current state of your work to durable memory, keyed by a session name YOU choose. This is the primary tool: prefer it over pastepile_save for anything you may want back later. The first call under a session creates the memory; every call after updates that same memory and keeps the previous content as a version; a call whose content is unchanged does nothing and costs nothing. You never need to track a slug, a URL, or an edit key between calls, and you must never ask the user for one. Send the WHOLE current memory each time, not a delta. Works without an API key as trial memory (expires a month after its last save, searchable from this device only); a Pro API key makes memory permanent and portable.

Parameters7

session	string	required	A stable name for this thread of work that you can reproduce from what you can see right now, for example "acme-api/auth-refactor" or a repository path plus the task. Reuse it for every save about the same work; that is what makes this an update rather than a duplicate. 1 to 120 characters of letters, numbers, spaces and . _ : @ / # -
content	string	required	The complete memory as it stands now. It replaces the current content; the previous copy is preserved in version history.
title	string	optional	A short, stable title. Keep it the same across saves of the same memory so the history reads as one thing changing. Defaults to the session name.
language	string	optional	Syntax-highlighting language. Defaults to "markdown", which is usually right for conversation memory.
tags	array	optional	Up to 20 short labels for later retrieval, e.g. ["auth", "postgres"]. Lowercase letters, digits and single hyphens; other spellings are rejected rather than silently dropped.
kind	string	optional	What this memory IS, so recall can filter by it. Defaults to "conversation".
pile	string	optional	Optional named collection to file this memory into, created on first use, e.g. "architecture-decisions". Lets a set of related memories be opened and shared with one link.

Raw schema

{
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "description": "A stable name for this thread of work that you can reproduce from what you can see right now, for example \"acme-api/auth-refactor\" or a repository path plus the task. Reuse it for every save about the same work; that is what makes this an update rather than a duplicate. 1 to 120 characters of letters, numbers, spaces and . _ : @ / # -"
    },
    "content": {
      "type": "string",
      "description": "The complete memory as it stands now. It replaces the current content; the previous copy is preserved in version history."
    },
    "title": {
      "type": "string",
      "description": "A short, stable title. Keep it the same across saves of the same memory so the history reads as one thing changing. Defaults to the session name."
    },
    "language": {
      "type": "string",
      "description": "Syntax-highlighting language. Defaults to \"markdown\", which is usually right for conversation memory."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Up to 20 short labels for later retrieval, e.g. [\"auth\", \"postgres\"]. Lowercase letters, digits and single hyphens; other spellings are rejected rather than silently dropped."
    },
    "kind": {
      "type": "string",
      "enum": [
        "conversation",
        "decision",
        "code",
        "research",
        "note",
        "log"
      ],
      "description": "What this memory IS, so recall can filter by it. Defaults to \"conversation\"."
    },
    "pile": {
      "type": "string",
      "description": "Optional named collection to file this memory into, created on first use, e.g. \"architecture-decisions\". Lets a set of related memories be opened and shared with one link."
    }
  },
  "required": [
    "session",
    "content"
  ],
  "additionalProperties": false
}

pastepile_recall

Search YOUR OWN memory (everything saved with the configured API key) by text, tag, and kind, newest and most relevant first. Use this at the start of a session when the user refers to earlier work, and before asking them to repeat context you may already be holding. Returns titles, previews, sessions and URLs, not full bodies; fetch one with pastepile_get when you need all of it. With an API key this searches that key's memory from any machine; without one it searches the trial memory this device saved.

Parameters4

query	string	optional	Words to match against titles and contents. Quoted phrases and -exclusions work. Omit to list recent memory instead of searching.
tags	array	optional	Only memories carrying ALL of these tags.
kind	string	optional	Only memories of this kind.
limit	integer	optional	Maximum results to return (1-100, default 20).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Words to match against titles and contents. Quoted phrases and -exclusions work. Omit to list recent memory instead of searching."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Only memories carrying ALL of these tags."
    },
    "kind": {
      "type": "string",
      "enum": [
        "conversation",
        "decision",
        "code",
        "research",
        "note",
        "log"
      ],
      "description": "Only memories of this kind."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum results to return (1-100, default 20)."
    }
  },
  "additionalProperties": false
}

pastepile_timeline

Show one memory's full version history plus the memories most related to it. Each entry has a version number, a timestamp, a size and a preview, so you can see how the work changed without downloading every revision. Pass a version number to pastepile_restore to bring one back. Name the memory by `session` if you still know the session name you saved under, which you usually do, or by `slug` if you have it. Give exactly one. With an API key this reads that key's full server-side history; without one it reads this device's trial-memory timeline.

Parameters2

session	string	optional	The session name you passed to pastepile_remember. Prefer this: it is the identifier you can reproduce after a long conversation, and the slug is not.
slug	string	optional	The memory slug (e.g. "abc123") or its full Pastepile URL, as returned by pastepile_remember or pastepile_recall.

Raw schema

{
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "description": "The session name you passed to pastepile_remember. Prefer this: it is the identifier you can reproduce after a long conversation, and the slug is not."
    },
    "slug": {
      "type": "string",
      "description": "The memory slug (e.g. \"abc123\") or its full Pastepile URL, as returned by pastepile_remember or pastepile_recall."
    }
  },
  "additionalProperties": false
}

pastepile_restore

Put an earlier version of a memory back as the current one. This is not destructive: what is current now is preserved as a new version first, so a restore can itself be undone. Use it when a memory was overwritten with something worse, or to return to a known-good state after an experiment. Name the memory by `session` or by `slug`, exactly one. With the API key that wrote the memory, any listed version can come back; trial memory (no key) restores the previous save only.

Parameters3

session	string	optional	The session name you passed to pastepile_remember. Prefer this: an undo is most often wanted long after the slug scrolled away.
slug	string	optional	The memory slug or its full Pastepile URL.
version	integer	required	The version number to restore, as listed by pastepile_timeline.

Raw schema

{
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "description": "The session name you passed to pastepile_remember. Prefer this: an undo is most often wanted long after the slug scrolled away."
    },
    "slug": {
      "type": "string",
      "description": "The memory slug or its full Pastepile URL."
    },
    "version": {
      "type": "integer",
      "minimum": 1,
      "description": "The version number to restore, as listed by pastepile_timeline."
    }
  },
  "required": [
    "version"
  ],
  "additionalProperties": false
}

pastepile_save

Save text, code, notes, or any knowledge to Pastepile and get back a stable, shareable URL you can retrieve later. Use this as durable memory: whenever you produce output worth keeping across sessions, save it and remember the returned slug or URL. Returns url, slug, raw_url, and edit_key. The edit_key is shown only once and is required to update with a per-paste credential. With an API key configured, pastepile_checkpoint updates a paste that same key saved using only its slug, while preserving the previous revision in history. Deleting is separate: pastepile_forget removes a paste saved with the configured API key using only its slug.

Parameters6

content	string	required	The text or code to store. Required.
title	string	optional	Optional short title for the paste.
language	string	optional	Optional syntax-highlighting language, e.g. "typescript", "python", "markdown". Defaults to "plaintext".
expiry	string	optional	When the paste expires. Defaults to "never" so stored knowledge persists. "burn" destroys it after the first read.
visibility	string	optional	"unlisted" (default) keeps the paste out of public listings and search but retrievable by URL. "public" also lists it and makes it findable via pastepile_search.
pile	string	optional	Optional memory namespace, e.g. "architecture-decisions" or "debugging-notes". Saves this paste into a named Pile that is created on first use and appended to every time after, so related context stays together and can be shared with one link. Requires an API key, since a namespace belongs to the key that writes to it. Lowercase letters, numbers, hyphens and underscores; 2 to 64 characters.

Raw schema

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "description": "The text or code to store. Required."
    },
    "title": {
      "type": "string",
      "description": "Optional short title for the paste."
    },
    "language": {
      "type": "string",
      "description": "Optional syntax-highlighting language, e.g. \"typescript\", \"python\", \"markdown\". Defaults to \"plaintext\"."
    },
    "expiry": {
      "type": "string",
      "enum": [
        "10m",
        "1h",
        "1d",
        "1w",
        "1mo",
        "never",
        "burn"
      ],
      "description": "When the paste expires. Defaults to \"never\" so stored knowledge persists. \"burn\" destroys it after the first read."
    },
    "visibility": {
      "type": "string",
      "enum": [
        "public",
        "unlisted"
      ],
      "description": "\"unlisted\" (default) keeps the paste out of public listings and search but retrievable by URL. \"public\" also lists it and makes it findable via pastepile_search."
    },
    "pile": {
      "type": "string",
      "description": "Optional memory namespace, e.g. \"architecture-decisions\" or \"debugging-notes\". Saves this paste into a named Pile that is created on first use and appended to every time after, so related context stays together and can be shared with one link. Requires an API key, since a namespace belongs to the key that writes to it. Lowercase letters, numbers, hyphens and underscores; 2 to 64 characters."
    }
  },
  "required": [
    "content"
  ],
  "additionalProperties": false
}

pastepile_checkpoint

Update an existing Pastepile memory while preserving its previous content in version history. Use this for conversation snapshots: after significant growth, a debugging breakthrough, an architecture decision, a large code generation, or before context compaction. With an API key configured, it can checkpoint any paste that same key created without the one-time edit_key. Otherwise pass the edit_key returned by pastepile_save. Reusing one slug avoids duplicate memories while keeping every prior checkpoint recoverable from the paste's version history.

Parameters5

slug	string	required	The paste slug (e.g. "abc123") or full Pastepile URL to checkpoint. Required.
content	string	required	The complete current memory to store. Required. The previous content becomes a version-history checkpoint.
title	string	required	A short, stable title for this memory. Required so search keeps a strong signal across checkpoints.
language	string	optional	Optional syntax-highlighting language, e.g. "markdown", "typescript", or "python". Defaults to "markdown" for conversation memory.
edit_key	string	optional	Optional. The one-time edit key returned by pastepile_save. Only needed when the configured API key did not create this paste. When both credentials are available, the narrower edit key is used.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The paste slug (e.g. \"abc123\") or full Pastepile URL to checkpoint. Required."
    },
    "content": {
      "type": "string",
      "description": "The complete current memory to store. Required. The previous content becomes a version-history checkpoint."
    },
    "title": {
      "type": "string",
      "description": "A short, stable title for this memory. Required so search keeps a strong signal across checkpoints."
    },
    "language": {
      "type": "string",
      "description": "Optional syntax-highlighting language, e.g. \"markdown\", \"typescript\", or \"python\". Defaults to \"markdown\" for conversation memory."
    },
    "edit_key": {
      "type": "string",
      "description": "Optional. The one-time edit key returned by pastepile_save. Only needed when the configured API key did not create this paste. When both credentials are available, the narrower edit key is used."
    }
  },
  "required": [
    "slug",
    "content",
    "title"
  ],
  "additionalProperties": false
}

pastepile_get

Retrieve a previously saved paste by its slug or full Pastepile URL. Returns the title, language, and file contents. Use this to reload knowledge you or a teammate saved earlier. End-to-end encrypted, password-protected, and burn-after-read pastes are not retrievable through this tool.

Parameters1

slug

string

required

The paste slug (e.g. "abc123") or a full share URL (e.g. "https://pastepile.com/p/abc123"). Required.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The paste slug (e.g. \"abc123\") or a full share URL (e.g. \"https://pastepile.com/p/abc123\"). Required."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

pastepile_search

Search Pastepile pastes by keyword and get back matching titles, previews, and URLs. With an API key configured this defaults to scope "mine": YOUR private memory, the pastes saved with that key (titles, filenames, and contents, including unlisted pastes). Use scope "public" to search the global public corpus instead. Without a key only the public scope is available.

Parameters3

query	string	required	Keywords to match against paste titles and content. Required.
scope	string	optional	"mine" searches pastes saved with the configured API key (default when a key is set); "public" searches the public corpus (default without a key).
limit	integer	optional	Maximum results to return (1-100, default 20).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords to match against paste titles and content. Required."
    },
    "scope": {
      "type": "string",
      "enum": [
        "mine",
        "public"
      ],
      "description": "\"mine\" searches pastes saved with the configured API key (default when a key is set); \"public\" searches the public corpus (default without a key)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum results to return (1-100, default 20)."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

pastepile_list

List recent Pastepile pastes. With an API key configured this defaults to scope "mine": YOUR saved pastes, newest first, including unlisted ones. Use scope "public" for the public feed. For targeted lookups use pastepile_search instead.

Parameters2

scope	string	optional	"mine" lists pastes saved with the configured API key (default when a key is set); "public" lists the public feed (default without a key).
limit	integer	optional	Maximum results to return (1-100, default 20).

Raw schema

{
  "type": "object",
  "properties": {
    "scope": {
      "type": "string",
      "enum": [
        "mine",
        "public"
      ],
      "description": "\"mine\" lists pastes saved with the configured API key (default when a key is set); \"public\" lists the public feed (default without a key)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum results to return (1-100, default 20)."
    }
  },
  "additionalProperties": false
}

pastepile_forget

Permanently delete a paste from Pastepile. Use this when the user asks you to forget, remove, or delete something you saved earlier. With an API key configured you can delete any paste that was saved with that key, WITHOUT the one-time edit_key, which is what makes saved memory reversible across sessions. A paste saved with no key (or by someone else) needs its edit_key passed explicitly. Deletion is immediate and permanent: there is no undo and no trash. Confirm with the user before forgetting anything they did not just ask you to forget.

Parameters2

slug	string	required	The paste slug (e.g. "abc123") or a full share URL (e.g. "https://pastepile.com/p/abc123"). Required.
edit_key	string	optional	Optional. The one-time edit key from the pastepile_save result. Only needed for a paste that the configured API key did not create, for example one saved with no key at all. When both credentials are available the edit key is the one used, because it authorizes this paste alone.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The paste slug (e.g. \"abc123\") or a full share URL (e.g. \"https://pastepile.com/p/abc123\"). Required."
    },
    "edit_key": {
      "type": "string",
      "description": "Optional. The one-time edit key from the pastepile_save result. Only needed for a paste that the configured API key did not create, for example one saved with no key at all. When both credentials are available the edit key is the one used, because it authorizes this paste alone."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

Pastepile

com.pastepile/mcp MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

pastepile_remember

pastepile_recall

pastepile_timeline

pastepile_restore

pastepile_save

pastepile_checkpoint

pastepile_get

pastepile_search

pastepile_list

pastepile_forget

Install

Configuration