pastepile_save

Saves content as a paste and returns its URL. This is the tool assistants use whenever they produce output worth keeping across sessions: a design, a decision record, a runbook, a snippet.

Parameters

Example

A prompt like this:

Save this rollback command to Pastepile titled "prod rollback runbook".

produces this tool call and result:

{
  "name": "pastepile_save",
  "arguments": {
    "content": "kubectl rollout undo deploy/api",
    "title": "prod rollback runbook",
    "language": "bash"
  }
}

{
  "saved": true,
  "url": "https://www.pastepile.com/p/aB3xY9z",
  "slug": "aB3xY9z",
  "raw_url": "https://www.pastepile.com/raw/aB3xY9z",
  "edit_key": "ek_...",
  "visibility": "unlisted",
  "expiry": "never",
  "note": "Retain edit_key to update or delete this paste later; it is shown only once."
}

Behavior notes

• The edit_key is shown exactly once. It authorizes later updates or deletion through the REST API; this MCP server has no write-by-key tools yet.
• On a free API key, a defaulted never expiry falls back to 1mo and the result carries an expiry_note saying so. An explicit never is never silently overridden: it errors instead, so the assistant knows persistence was not granted.
• Empty content is rejected locally, before any network request.

Errors