Tools
pastepile_get
Retrieve a paste by slug or full URL and reload previously saved knowledge into the model's context.
1 min read · Updated
Retrieves a paste's title, language, and full file contents. This is how an assistant reloads knowledge that it, you, or a teammate saved earlier.
Parameters
| Parameter | Type | Description | |
|---|---|---|---|
slug | string | required | A slug (aB3xY9z) or any full share URL (https://pastepile.com/p/aB3xY9z). URL fragments are stripped safely, so encrypted-paste links never leak their key. |
Example
Pull up https://pastepile.com/p/aB3xY9z and apply that runbook.
{
"name": "pastepile_get",
"arguments": { "slug": "https://pastepile.com/p/aB3xY9z" }
}{
"slug": "aB3xY9z",
"title": "prod rollback runbook",
"language": "bash",
"files": [
{ "name": "file1.txt", "language": "bash", "content": "kubectl rollout undo deploy/api" }
],
"created_at": "2026-07-28T23:00:00Z",
"expires_at": null,
"url": "https://www.pastepile.com/p/aB3xY9z"
}Behavior notes
- Multi-file pastes return every file in
files, in order. - Accepting full URLs means an assistant can act on any Pastepile link it sees in conversation, an issue, or a commit message.
Errors
| Error | Cause |
|---|---|
not_found (404) | Unknown or expired slug. |
encrypted (404) | End-to-end encrypted paste; unreadable by the API by design. |
password_protected (404) | Password-protected paste; no automated password path exists. |
burn_after_read (403) | Burn pastes are not served to automated clients, so a tool call can never destroy a one-time secret. |
sealed (403) | Time capsule still sealed; retrievable after its unlock time. |
The four protected-content refusals are enforced server-side. No client, prompt, or bug in this package can pull guarded content into a model context. See the security model.
Related documentation
pastepile_saveSave text, code, or notes to Pastepile and get back a stable, shareable URL plus a one-time edit key. The write path of durable AI memory.pastepile_searchSearch pastes by keyword. With an API key it defaults to your private memory; without one it searches the public corpus.Security modelWhat the Pastepile MCP server can and cannot touch: local execution, zero-knowledge encryption boundaries, and why protected pastes can never leak into a model context.