# Sleevy

> Sleevy is a native-first read-later app. Save any URL to your queue, organize items with folders and tags, and manage read state across web, iOS, a Chrome extension, Raycast, a REST API, and MCP.

Authenticate to the REST API with a personal API Key (`Authorization: Bearer <api-key>`), created under Settings at https://sleevy.app/settings. Keys are scoped and rate-limited per key. Base URL: https://api.sleevy.app.

## API

- [OpenAPI specification](https://sleevy.app/openapi.json): Full machine-readable REST API schema (v1).
- [API documentation](https://sleevy.app/docs): Overview of the API and its developer workflows.
- [Getting started](https://sleevy.app/docs/getting-started): Create a key, capture a URL, and read your queue.
- [Core concepts](https://sleevy.app/docs/concepts): Understand captures, saved items, read state, folders, and stable IDs.
- [API guides](https://sleevy.app/docs/guides): Save, read, update, and organize links from scripts.
- [Authentication](https://sleevy.app/docs/authentication): Authenticate requests with a personal API key.
- [Errors](https://sleevy.app/docs/errors): Understand structured API errors and status codes.
- [Rate limits](https://sleevy.app/docs/rate-limits): Handle API-key limits and response headers.
- [OpenAPI reference](https://sleevy.app/docs/api-reference): Browse generated endpoint documentation from the OpenAPI schema.
- [MCP documentation](https://sleevy.app/docs/mcp): Connect an AI agent with OAuth to save, find, and organize links.
- [Integration declaration](https://sleevy.app/.well-known/integrations.json): Machine-readable surface and credential declaration.

## Model Context Protocol

- MCP endpoint: `https://api.sleevy.app/mcp`.
- Install it with `npx add-mcp https://api.sleevy.app/mcp --name sleevy`; the installer detects supported MCP clients and lets the user choose where to add it.
- Connect with OAuth to save and list links, manage read state and folders, and remove saved items or folders. Destructive operations should require agent confirmation.

## Core endpoints

- `POST /v1/captures`: Save a URL to the read-later queue.
- `GET /v1/saved-items`: List saved items (supports `sort` and `folder` filters).
- `DELETE /v1/saved-items/{id}`: Remove a saved item.
- `POST /v1/saved-items/{id}/read` · `/unread` · `/open` · `/read-state`: Manage read state.
- `PUT /v1/saved-items/{id}/folder`: Move an item into a folder.
- `GET /v1/folders` · `POST /v1/folders` · `PATCH /v1/folders/{id}` · `DELETE /v1/folders/{id}`: Manage folders.
- `GET /health`: Unauthenticated health check.

## More

- [Sleevy home](https://sleevy.app): Product overview and native clients (iOS, Chrome, Raycast).
- [Privacy](https://sleevy.app/privacy)
- [Support](https://sleevy.app/support)