Cairnbin

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

StatusCause and fix
400Check the MCP protocol version and required request headers.
401The token is missing, invalid, or expired. Send a valid Bearer token; the response includes WWW-Authenticate: Bearer.
403The Origin was rejected or the token lacks access. Use the correct site origin and an appropriate linked token.
404MCP is disabled for this server.
405The endpoint is POST-only; use POST for MCP requests.

Using cairnbin tools

cairnbin tools

  • getApiV1Pastes: list public pastes; page defaults to 1 and limit defaults to 20 (maximum 100).
  • postApiV1Pastes: create a paste; provide content, and optionally title, language, is_public, expires_in, and burn_after. An anonymous creation returns an owner_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/tokens for an assistant that needs access to existing pastes.
  • getApiV1ServerHealthz and getApiV1ServerVersion: 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.

Install this app

  1. Tap the Share button
  2. Scroll down and tap "Add to Home Screen"
  3. Tap "Add" in the top right

Please confirm