MCP integration

One config line.
Your bookmarks become context.

Model Context Protocol is the open standard for giving agents access to live data. ContextBolt Pro ships a personal MCP endpoint that exposes your library to any compatible client: Claude, Cursor, Windsurf, Cline, Zed, anything that speaks MCP.

001 / The protocol

What MCP is,
plainly.

Model Context Protocol is an open standard, originally from Anthropic, that lets AI agents talk to external tools and data in a uniform way. Think of it as USB for AI: one connector, many devices.

Before MCP, each tool wrote a bespoke integration for each agent. With MCP, you write one server and every client speaks to it. ContextBolt is one such server, for your social bookmarks.

Your agent
Claude / Cursor
Sends a query mid-conversation. Does not know what you have bookmarked, only that the tools exist.
MCP ▸▸▸ JSON-RPC
ContextBolt
/mcp/<token>
Runs the query against your indexed library. Returns the top matches with metadata and links back to the source.
002 / The flow

What happens
per query.

You ask Claude "what did I save about rate limiting?". Claude does not need to know we exist. It just sees a search_bookmarks tool registered via MCP and calls it.

The query goes to your ContextBolt endpoint. We search the index, run the embeddings, and return the top results. Claude composes a reply. You see the citations.

01

User prompt

"What did I save about rate limiting?"

02

Agent decides

Claude sees the search_bookmarks tool and decides it is relevant.

03

Tool call

JSON-RPC over HTTP to your /mcp/<token> endpoint.

04

Cited answer

Top matches returned with source links. Claude composes with citations.

003 / Tools exposed

Five functions.
That's it.

We deliberately ship a small surface area. Less to learn, less to break. Each tool maps to one obvious thing an agent needs from a personal library.

The full schema is published in tools/list at every endpoint, so Claude introspects it on connect.

search_bookmarks
most used

Semantic search across the entire library. Returns the top matches ranked by cosine similarity over 1536-dimension embeddings.

qstringnatural-language query
kint = 10number of results
platform?enumx | reddit | linkedin
list_clusters

List every topic cluster discovered in your library. Useful when an agent wants to take stock before drilling in.

(no params)
returnscluster[]id, label, count
get_cluster_bookmarks

Fetch every bookmark inside one cluster. Pairs naturally with list_clusters for "show me everything about X".

cluster_idstringfrom list_clusters
limit?int = 50
get_recent_bookmarks

Recent saves, in reverse chronological order. Used in morning briefings and "catch me up since last week" prompts.

since?ISO datedefault: 7 days ago
limit?int = 20
save_bookmark
write

Save a new bookmark to your library from inside an agent. ContextBolt tags and embeds it server-side, so it is searchable straight away.

urlstringthe page or post to save
note?stringoptional context
004 / Client setup

One line.
Six clients.

Drop your endpoint URL into your client's MCP config and restart. Your token is generated in the extension, under Settings, MCP.

If your client speaks MCP but isn't listed below, the same URL works. It's just JSON.

Claude Desktop
macOS / Win / Linux
// claude_desktop_config.json
{
  "mcpServers": {
    "bookmarks": {
      "url": ".../mcp/<token>"
    }
  }
}
after editquit and relaunch
Claude Code
CLI
// .mcp.json at project root
// or ~/.claude/mcp.json globally
{
  "mcpServers": {
    "bookmarks": {
      "url": ".../mcp/<token>"
    }
  }
}
scopeproject or user
Cursor
IDE
// .cursor/mcp.json
{
  "mcpServers": {
    "bookmarks": {
      "url": ".../mcp/<token>"
    }
  }
}
verifySettings, MCP
Windsurf
IDE
// ~/.codeium/windsurf/
// mcp_config.json
{
  "mcpServers": {
    "bookmarks": {
      "url": ".../mcp/<token>"
    }
  }
}
verifyCascade panel
Cline
VS Code
// Settings, MCP Servers
// the Cline UI or json directly
{
  "bookmarks": {
    "url": ".../mcp/<token>"
  }
}
verifyCline tools tab
Zed and any host
JSON-RPC
// settings.json
// context_servers
{
  "bookmarks": {
    "url": ".../mcp/<token>"
  }
}
specmodelcontextprotocol.io
005 / Prompts that work

What to ask
your agent.

You don't have to mention ContextBolt. Just ask the kind of question that only your library could answer. The agent figures out which tool to call.

What did I save about rate limiting last month?
Calls search_bookmarks with the question and a time bias. Returns ranked posts with similarity scores.
Summarize everything I've bookmarked about Cloudflare Workers.
Calls search_bookmarks, then composes a synthesis. Source links are preserved as citations.
Which topics am I obsessed with right now?
Calls list_clusters. Returns top topics by recent activity. Surprisingly revealing.
Give me the weekly catch-up: what should I read from last week?
Calls get_recent_bookmarks with a 7-day window, filtered by cluster relevance.
Draft a thread based on what I saved about MCP.
Calls search_bookmarks, then generates. Your saved points of view become your published ones.
In the Startups cluster, what's the contrarian take?
Calls get_cluster_bookmarks, then reasons across them. Multi-source pattern matching.
006 / Privacy and security

Your library
stays yours.

The MCP endpoint is the only thing on our servers. The library itself lives in IndexedDB on your device. Pro users opt into encrypted sync, and the keys never leave the browser.

Local first

Bookmark storage, embeddings, and the search index all live on your device. No server round-trips for reads.

Rotatable tokens

Your MCP token can be rotated from the extension at any time. Old configs stop working straight away, no support ticket needed.

No query retention

We log query counts for billing, never query content. Usage is readable in the extension dashboard.

Personal MCP endpoint, $6 a month

Plug in your bookmarks.
See your agents change.

Pro takes about ninety seconds to set up. Most of that is restarting your client.