MCP server
What this is
Cairnbin provides a remote MCP server over Streamable HTTP. Every public API operation is available to an assistant as a tool.
Endpoint
Use the primary endpoint:
https://pste.us/api/v1/server/mcp
Aliases: https://pste.us/api/mcp and https://pste.us/mcp.
Authentication
Send credentials in Authorization: Bearer {token}. This uses the same tokens as the REST API. Public tools also work anonymously. For owner access, create a linked token for this client at /server/preferences/tokens, then revoke it separately when no longer needed. Do not use the primary owner token or the operator token.
Connect a client
Claude Code
claude mcp add --transport http cairnbin https://pste.us/api/v1/server/mcp --header "Authorization: Bearer $MCP_TOKEN"
Generic client configuration
{"mcpServers":{"cairnbin":{"type":"http","url":"https://pste.us/api/v1/server/mcp","headers":{"Authorization":"Bearer $MCP_TOKEN"}}}}
Verify with curl
curl -q -LSsf -X POST 'https://pste.us/api/v1/server/mcp' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-H 'MCP-Protocol-Version: 2025-06-18' \
-H "Authorization: Bearer $MCP_TOKEN" \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'
Tools
deleteApiV1PastesId— Delete paste. Deletes a paste. Requires `Authorization: Bearer <token>` header (the delete token returned at creation time).getApiV1Pastes— List public pastes. Returns recent public pastes by default. Use scope=owned with a valid owner Bearer token to list all of that owner's non-expired pastes, including unlisted pastes.getApiV1PastesId— Get paste. Returns paste metadata and content by ID. If the paste is a link (is_link=true), responds with a 302 redirect to the target URL instead of a JSON body — use the /raw endpoint to retrieve the target URL as text without redirecting.getApiV1PastesIdRaw— Get raw paste content. Returns the raw paste text as plain text. For links (is_link=true), returns the target URL as plain text without redirecting.getApiV1ServerHealthz— Health check. Returns server health status and basic metrics.getApiV1ServerVersion— Version info. Returns the server version, commit ID, and build date.postApiV1Pastes— Create paste. Creates a new paste. Accepts JSON or multipart/form-data.
Authenticated callers may see additional tools when their token has the required access.
Behavior and limits
The endpoint accepts POST requests only and keeps no sessions. Calls use the same rate limits and audit handling as the API. Present Origin headers are validated. Supported protocol versions: 2025-06-18, 2025-03-26, 2024-11-05.
Troubleshooting
| Status | Cause and fix |
|---|---|
| 400 | Check the MCP protocol version and required request headers. |
| 401 | The token is missing, invalid, or expired. Send a valid Bearer token; the response includes WWW-Authenticate: Bearer. |
| 403 | The Origin was rejected or the token lacks access. Use the correct site origin and an appropriate linked token. |
| 404 | MCP is disabled for this server. |
| 405 | The endpoint is POST-only; use POST for MCP requests. |
Using cairnbin tools
cairnbin tools
getApiV1Pastes: list public pastes;pagedefaults to 1 andlimitdefaults to 20 (maximum 100).postApiV1Pastes: create a paste; providecontent, and optionallytitle,language,is_public,expires_in, andburn_after. An anonymous creation returns anowner_token; save it to manage that paste later.getApiV1PastesId: retrieve a paste by ID; link pastes redirect to their target, so use the raw tool to read the target as text.getApiV1PastesIdRaw: retrieve the raw paste content or link target as text.deleteApiV1PastesId: delete a paste with its owner token in the Bearer header; use a linked token from/server/preferences/tokensfor an assistant that needs access to existing pastes.getApiV1ServerHealthzandgetApiV1ServerVersion: check service health and version.
Example prompts:
- Create a paste containing this code and return its link.
- Find recent public pastes and summarize their titles.
- Check whether cairnbin is healthy and report its version.
Paste operations follow the REST API's visibility, expiry, ownership, and rate limits. cairnbin exposes no additional MCP resources or prompts.