diff --git a/SUMMARY.md b/SUMMARY.md index aa275fd..2b3c16c 100644 --- a/SUMMARY.md +++ b/SUMMARY.md @@ -25,6 +25,10 @@ * [Export](v1/export.md) * [Backups](v1/backups.md) +## MCP + +* [MCP Server](mcp/README.md) + ## More * [Changelog](more/changelog.md) diff --git a/mcp/README.md b/mcp/README.md new file mode 100644 index 0000000..0176917 --- /dev/null +++ b/mcp/README.md @@ -0,0 +1,33 @@ +--- +description: Connect AI models and agents to Raindrop.io data through the Model Context Protocol (MCP) +--- + +# MCP Server + +The Raindrop.io [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server provides a standardized interface for AI models and agents to read and manage your bookmark data. + +{% hint style="warning" %} +MCP is currently in **beta** and available to [Pro](https://raindrop.io/pro/buy) users. +{% endhint %} + +## Endpoint + +``` +https://api.raindrop.io/rest/v2/ai/mcp +``` + +Transport: **Streamable HTTP** (the only supported transport). + +## Authentication + +### OAuth 2.1 (Interactive) + +The MCP server supports OAuth 2.1 authentication. When connecting through a compatible MCP client (Claude, ChatGPT, Cursor, etc.), your browser will open automatically to authorize access to your Raindrop.io account. + +### Bearer Token + +You can also use the same access token as with the [REST API](../v1/authentication/README.md). Pass it in the `Authorization: Bearer ` header. See [Authentication](../v1/authentication/README.md) for details on obtaining a token. + +## Client Configuration + +For step-by-step setup instructions for Claude, ChatGPT, VS Code, Cursor, and other clients, see the [Raindrop.io Help Center](https://help.raindrop.io/mcp).