bookmark-lens
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LLM_MODEL | No | LLM model for Smart Mode (optional). | claude-3-haiku-20240307 |
| LLM_API_KEY | No | API key for the LLM provider (optional). | |
| MAX_CONTENT_LENGTH | No | Maximum content length in characters to extract. | 50000 |
| EMBEDDING_DIMENSION | No | Dimension of the embedding vectors. | 384 |
| EMBEDDING_MODEL_NAME | No | Name of the sentence-transformers embedding model. | all-MiniLM-L6-v2 |
| BOOKMARK_LENS_USER_AGENT | No | User agent string for HTTP requests. | bookmark-lens/0.1.0 |
| BOOKMARK_LENS_DUCKDB_PATH | No | Path to DuckDB database file. | ./data/bookmark_lens.db |
| BOOKMARK_LENS_LANCEDB_PATH | No | Path to LanceDB vector database. | ./data/embeddings.lance |
| BOOKMARK_LENS_FETCH_TIMEOUT | No | Timeout in seconds for fetching web pages. | 30 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| save_bookmarkA | Save a bookmark to the user's bookmark collection. IMPORTANT: Use this tool whenever the user asks to:
After saving, consider helping the user by:
This provides a helpful summary without requiring an API key. |
| search_bookmarksA | Search the user's bookmark collection using semantic search. IMPORTANT: Use this tool whenever the user asks to:
Supports semantic search (meaning-based) with optional filters for domain, tags, and dates. |
| get_bookmarkA | Get full details about a specific bookmark by ID. |
| update_bookmarkB | Update note and/or tags for an existing bookmark. |
| delete_bookmarkB | Delete a bookmark and all its associated data. |
| list_tagsA | List all tags with their usage counts. Returns: List of tags with counts |
| get_bookmark_statsA | Get statistics about your bookmark collection with optional filters. |
| get_bookmark_contentA | Get the full content of a bookmark in Markdown format. Use this tool when the user wants to:
After calling this tool, YOU should summarize or analyze the content based on what the user asked. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| bookmark_search_guide | Guide for using bookmark-lens effectively, including natural language date parsing. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Each tool has a unique and clearly distinct purpose: delete, get details, get content, get stats, list tags, save, search, update. No overlapping functionality.
All tool names follow a consistent verb_noun pattern in snake_case, such as save_bookmark, delete_bookmark, search_bookmarks. The pattern is predictable and uniform.
With 8 tools, the server covers essential CRUD operations, search, stats, and tags without excess or deficiency. The scope fits a bookmark management service well.
Core operations (save, get, update, delete, search, stats) are covered. The only minor gap is the lack of an explicit 'list all bookmarks' tool, though search may partially fulfill that role.