MCP Server

Pro & Lifetime only

The MCP Server integration is available on Pro and Lifetime plans.

Savebase exposes a Model Context Protocol (MCP) server so your AI assistants can search and read your saved bookmarks. Ask Claude, Cursor, or Windsurf something like "What did I save about kettlebell training?" and it will query your Savebase library directly.

Overview

MCP is an open standard that lets AI applications connect to external data sources. Savebase implements an MCP-compatible HTTP endpoint that gives your AI assistant read-only access to your bookmarks, folders, and tags — all secured behind a durable access token that you generate from your settings.

Requirements

A Savebase account on the Pro or Lifetime plan
An MCP-compatible AI client (Claude Desktop, Cursor, or Windsurf)

Generate an Access Token

Unlike short-lived session tokens, Savebase MCP tokens are durable — they stay valid until you explicitly revoke them. This means your AI client won't lose access when your browser session expires.

Open Settings

Go to your Dashboard → Settings.

Navigate to MCP Server tab

Click the MCP Server tab.

Generate a token

Enter a label (e.g. "Cursor", "Claude Desktop") and click Generate Token. A new token starting with sb- will appear.

Copy immediately

Copy the token right away — it is only shown once. If you lose it, revoke it and generate a new one.

Copy the config snippet

The settings page shows a ready-to-paste JSON config block with your token pre-filled. Click Copy to grab it.

Token security

Savebase never stores your raw token. Only a SHA-256 hash is saved. You can revoke any token at any time from Settings → MCP Server.

Claude Desktop

Open Claude Desktop settings

Open the Claude Desktop app, go to Settings → Developer → Edit Config. This opens the claude_desktop_config.json file.

Paste the configuration

Paste the JSON config from your Savebase MCP Server settings:

json

{
  "mcpServers": {
    "savebase": {
      "url": "https://dlkudculfhmyntsirdld.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer sb-YOUR_MCP_TOKEN"
      }
    }
  }
}

Restart Claude Desktop

Close and reopen Claude Desktop. You should see the Savebase tools listed when you start a new conversation.

Cursor

Open MCP settings

In Cursor, go to Settings → MCP (or press Cmd/Ctrl+Shift+P and search "MCP").

Add a new MCP server

Click + Add new MCP server. Select Type: HTTP and paste your Savebase MCP endpoint URL.

Configure via mcp.json (recommended)

Alternatively, add Savebase to your project's .cursor/mcp.json file:

json

{
  "mcpServers": {
    "savebase": {
      "url": "https://dlkudculfhmyntsirdld.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer sb-YOUR_MCP_TOKEN"
      }
    }
  }
}

Restart Cursor

Restart Cursor completely. The Savebase MCP server should appear as active in Settings → MCP.

Important for Cursor users

Always select HTTP as the server type — not SSE. If you previously had an SSE entry for Savebase, delete it and re-add it as HTTP, then restart Cursor.

Windsurf

Open MCP configuration

In Windsurf, go to Settings → MCP or open the mcp_config.json file.

Add the Savebase server

Add the Savebase MCP server configuration:

json

{
  "mcpServers": {
    "savebase": {
      "serverUrl": "https://dlkudculfhmyntsirdld.supabase.co/functions/v1/mcp-server",
      "headers": {
        "Authorization": "Bearer sb-YOUR_MCP_TOKEN"
      }
    }
  }
}

Restart Windsurf

Restart the editor. Savebase tools should appear in the MCP panel.

Available Tools

Once connected, your AI assistant has access to these tools:

Tool	Description
`search_bookmarks`	Search by keyword across titles, content, authors, URLs, and notes
`list_bookmarks`	List bookmarks with optional source/folder filters and pagination
`get_bookmark`	Get full details of a single bookmark by ID
`list_folders`	List all your bookmark folders
`list_tags`	List all your tags

Example Prompts

Try asking your AI assistant questions like:

"What did I save about kettlebell training?"
"Show me my most recent Reddit bookmarks."
"Find all bookmarks in my 'Design Inspiration' folder."
"What articles have I tagged with 'AI'?"
"Summarise the posts I saved last week."

Troubleshooting

Problem	Solution
`Internal error` or `-32603`	Your token may be invalid or revoked. Go to Settings → MCP Server, generate a new token, update your config, and restart your AI client.
Server shows "errored" in Cursor	Delete the old Savebase MCP entry in Cursor Settings → MCP. Re-add it as Type: HTTP (not SSE) with a fresh token. Restart Cursor completely.
Authentication error	Make sure your token starts with `sb-`. Old session-based tokens no longer work reliably — generate a new durable token from Settings.
Server not responding	Check your internet connection. The MCP endpoint requires an active connection to Savebase servers.
Tools not showing	Restart your AI client after adding the configuration. Some clients require a full restart to detect new MCP servers.
Empty results	Make sure you have bookmarks saved in your Savebase library. The MCP server only searches your own data.
Lost your token	Tokens are only shown once when generated. Revoke the old token in Settings → MCP Server and generate a new one.

Quick recovery steps

If things aren't working: (1) Generate a new token in Settings → MCP Server, (2) Delete the old MCP entry in your AI client, (3) Re-add it with the new config, (4) Restart the AI client completely.

Rule Engine

Overview & Setup