Create a paste

One endpoint. Send text, get a key. Everything else — expiry, password, server details — is an optional field.

POST https://mcpaste.com/api/create

curl https://mcpaste.com/api/create \ -H "Authorization: Bearer mcp_live_…" \ -H "Content-Type: application/json" \ -d '{"content": "…", "title": "SkyHaven — console", "expiry": "30d", "password": null}'

201 · response

{ "key": "k8Qv2n", "url": "https://mcpaste.com/k8Qv2n",
  "expires": 1789200684000 }

Field	Type	Notes
content	string	The log itself. Required; everything else is optional.
title	string	Shown as the paste heading. Defaults to the paste key.
expiry	"1h" \| "24h" \| "30d" \| "never"	Or "burn" to delete on first read.
password	string \| null	Locks the paste behind the gate.
domain	string	Panel hostname, shown as the paste's provenance.
hideIps	boolean	Masks IPv4 addresses before the paste is written.

Limits: 25 MB per paste, 60 requests a minute per token. Anonymous pastes work without the header — post to https://mcpaste.com/documents with a plain-text body — they just can't be managed later.

GET https://mcpaste.com/api/whoami checks a token without creating anything.