# Raindrop.io — how to use (mcp.ai)

Connect your Raindrop.io account and use 11 tools for bookmarks straight from your AI agent. Connect with your own API key. Raindrop.io is a bookmark manager for organizing, searching, tagging, highlighting, sharing, importing, and exporting saved web content.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_raindrop?ms=1787295780000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `raindrop_create_bookmark`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/raindrop`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/raindrop/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/raindrop/create/bookmark` — Save one URL as a Raindrop bookmark with optional organization and notes.
  - body: { link: string, note?: string, tags?: string[], title?: string, excerpt?: string, important?: boolean, collection_id?: integer }
- `POST https://api.mcp.ai/api/raindrop/create/bookmarks` — Create 1 to 100 bookmarks in one request with optional organization and notes.
  - body: { bookmarks: object[] }
- `POST https://api.mcp.ai/api/raindrop/create/collection` — Create a root or nested Raindrop collection.
  - body: { view?: string, title: string, public?: boolean, parent_id?: integer }
- `POST https://api.mcp.ai/api/raindrop/delete/bookmark` — Move a bookmark to Trash or permanently delete a bookmark already in Trash, requiring the caller to state the intended deletion mode.
  - body: { permanent: boolean, raindrop_id: integer }
- `POST https://api.mcp.ai/api/raindrop/delete/empty/collection` — Delete a positive-ID collection after a best-effort check that it contains no bookmarks or child collections. Raindrop has no atomic conditional delete, so avoid concurrent changes while this action r
  - body: { collection_id: integer }
- `POST https://api.mcp.ai/api/raindrop/get/bookmark` — Get one bookmark and its highlights by Raindrop ID.
  - body: { raindrop_id: integer }
- `POST https://api.mcp.ai/api/raindrop/list/bookmarks` — List, search, filter, and sort bookmarks in a collection, all bookmarks, Unsorted, or Trash, returning one page and the next page number when available.
  - body: { page?: integer, sort?: string, nested?: boolean, search?: string, per_page?: integer, collection_id?: integer }
- `POST https://api.mcp.ai/api/raindrop/list/collections` — List all root and nested collections in the connected Raindrop account, including IDs, parent relationships, titles, and bookmark counts.
- `POST https://api.mcp.ai/api/raindrop/list/tags` — List tag names and bookmark counts globally or within one collection.
  - body: { collection_id?: integer }
- `POST https://api.mcp.ai/api/raindrop/update/bookmark` — Update selected bookmark fields, move it to another collection, or replace its tags while preserving omitted fields.
  - body: { link?: string, note?: string, tags?: string[], title?: string, excerpt?: string, important?: boolean, raindrop_id: integer, collection_id?: integer }
- `POST https://api.mcp.ai/api/raindrop/update/collection` — Change selected properties of an existing Raindrop collection without replacing omitted properties.
  - body: { view?: string, title?: string, public?: boolean, expanded?: boolean, collection_id: integer }

## Example prompts
- "What can I do in Raindrop.io?"
- "Show me a summary of my Raindrop.io account"

## More
- Page: https://mcp.ai/raindrop
- Agent spec (llms.txt): https://mcp.ai/raindrop/llms.txt
- Postman collection: https://mcp.ai/raindrop/postman.json