Send an MCP message

​

JSON-RPC entry point of the Paperpile MCP server, over the Model Context Protocol Streamable HTTP transport. Lives at the host root, outside the /v1 prefix.

The endpoint is stateless: every POST is an independent exchange, no mcp-session-id is issued, and one sent by a client is ignored.

Authenticate with Authorization: Bearer <token>, using either an API key or an OAuth access token — see Authentication. The endpoint itself only requires the read scope, but tools that modify your library fail on a read-only token.

Body

required
application/json
Empty object

Responses

  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/
curl https://stage-mcp.paperpile.com/ \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list"
}'

{}

JSON-RPC response, or an SSE stream when the transport upgrades the connection.