Model Context Protocol
Server URL
Point your MCP client at:
Install in VS Code MCP Registry record
Add https://pastebin.ca/mcp as a remote MCP server in your client, then sign in with your Pastebin.ca account.
In Claude, open Customize → Connectors → Add → Custom → Web, enter the URL and use Claude’s published identity when prompted.
Try it List my three most recent pastes and show their titles.
Discovery documents (no client config needed):
/.well-known/oauth-protected-resource/mcp— RFC 9728 Protected Resource Metadata/.well-known/oauth-authorization-server— RFC 8414 Authorization Server Metadata
Two ways to authenticate
pastebin.ca's MCP server accepts either OAuth 2.1 (recommended for desktop clients) or a long-lived bearer API key (recommended for server-side automation).
- OAuth 2.1 + PKCE — Your client opens a Pastebin.ca sign-in and consent page, then receives a token for this MCP server. Pastebin.ca supports Client ID Metadata Documents (CIMD) and dynamic client registration (DCR).
- Static API key — Mint a key under Account → Automation tokens.
Send JSON-RPC requests to POST /mcp. This stateless streamable-HTTP server does not support SSE over GET.
Cursor / Windsurf
Edit ~/.cursor/mcp.json:
{
"mcpServers": {
"pastebin": { "url": "https://pastebin.ca/mcp" }
}
} MCP Inspector
Launch the official inspector against the live URL:
npx @modelcontextprotocol/inspector Enter https://pastebin.ca/mcp as the server URL and choose OAuth when prompted.
Manual API-key configuration
If your client doesn't speak OAuth, hand it a bearer header directly:
{
"mcpServers": {
"pastebin": {
"url": "https://pastebin.ca/mcp",
"headers": { "Authorization": "Bearer pbca_live_…" }
}
}
} What MCP clients can do
Use tools/list to discover the full surface — every tool ships with an inputSchema, an outputSchema, and a human-readable description. The current inventory:
create_paste— create a plaintext paste. Body can be sent as UTF-8 text (body) or base64-encoded UTF-8 bytes (body_b64).get_paste— fetch a paste you own or any public paste. body_format=base64 returns raw bytes as body_b64 for safe transport.get_encrypted_paste— fetch ciphertext + cipher metadata for an encrypted paste; decrypt out-of-band.list_my_pastes— page through your own pastes, with an opaque next_cursor.amend_paste— add a new version to a paste lineage, with optional title and change_note.update_visibility— flip a plaintext paste between public and unlisted (encrypted and read-limited pastes are immutable).delete_paste— soft-delete a paste you own.list_paste_versions— return the full amendment chain for any paste in a lineage in one call (oldest first), with deleted versions tombstoned in place.diff_pastes— return a standard unified diff between two pastes in the same lineage. Plaintext only.search_my_pastes— full-text search across your own public pastes; returns highlighted snippets and paste:// URIs. Private, unlisted, and encrypted pastes are never indexed.whoami— confirm the authenticated account, scopes, and (for OAuth) the bound audience. No scope required.
Recipient flows (sending and reading inbox pastes) are intentionally not exposed over MCP because the server would briefly hold plaintext during sealing — use the REST API for those.
paste:// resource URIs
The MCP resources capability lets clients address any paste by URI. The template is:
paste://{id} resources/read returns the body as a text part (when valid UTF-8) or a base64 blob part (binary). Authorization mirrors get_paste: owners may read any of their own pastes; anyone may read public pastes.
Plain pastebin.ca view links following the canonical id pattern (10 chars, first char 2-9) are accepted too — clients may pass https://pastebin.ca/{id} URLs anywhere the protocol expects paste://{id} URIs, and tools that take an id (get_paste, amend_paste, update_visibility, delete_paste) accept all three forms.
resources/list returns empty by design — pastes are not enumerated as resources. Use list_my_pastes for discovery.
Scopes
OAuth tokens may request a subset of these scopes; the consent page shows which ones the client asked for.
paste:create— create new pastespaste:read— read pastes you own or have a link topaste:list— list your own pastespaste:edit— amend pastes you own and toggle their visibility between public and unlistedpaste:revoke— delete pastes you own
Revoking access
All tokens issued to MCP clients show up under Apps on your account page. Revoking an access token stops requests that use it. It does not remove the app’s authorization to request a new token.