list-collections
Retrieve all Raindrop.io bookmark collections via the MCP server, enabling structured access to organize and manage saved resources directly through AI integrations.
Instructions
List all your Raindrop.io collections
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:110-136 (handler)Handler for the 'list-collections' tool: fetches collections using RaindropAPI, formats them into a text list with details (name, ID, count, parent, created date), and returns in MCP content format.
if (name === "list-collections") { const collections = await api.listCollections(); const formattedCollections = collections.items .map( (item) => ` Name: ${item.title} ID: ${item._id} Count: ${item.count} bookmarks Parent: ${item.parent?._id || "None"} Created: ${new Date(item.created).toLocaleString()} ---`, ) .join("\n"); return { content: [ { type: "text", text: collections.items.length > 0 ? `Found ${collections.items.length} collections:\n${formattedCollections}` : "No collections found.", }, ], }; } - src/lib/raindrop-api.ts:55-57 (helper)Helper method in RaindropAPI class that makes an authenticated GET request to Raindrop.io's /collections endpoint to retrieve all collections.
async listCollections(): Promise<CollectionsResponse> { return this.makeRequest<CollectionsResponse>("/collections"); } - src/lib/tools.ts:82-89 (schema)MCP tool schema definition for 'list-collections', specifying name, description, and empty input schema (no input parameters required). Included in the exported tools array.
{ name: "list-collections", description: "List all your Raindrop.io collections", inputSchema: { type: "object", properties: {}, }, }, - src/types/index.ts:58-60 (schema)TypeScript interface defining the structure of the Raindrop.io collections API response.
export interface CollectionsResponse { items: Collection[]; } - src/index.ts:29-31 (registration)Registers the tools list (including 'list-collections') for MCP's ListToolsRequest, making the tool discoverable.
server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools }; });