add_bookmark

Add a bookmark to a group. Bookmarks mark important code locations with explanations. Supports hierarchical bookmarks via parentId. NEW: Markdown links in descriptions! - Link to files: [config](src/config.ts) - Link to specific lines: [handler](src/handler.ts:45) - Create cross-references betwee...

Server MCP Bookmarks linonon/mcpbookmarks
Category Write
Risk class Medium
Parameters 00 required

What add_bookmark does on MCP Bookmarks

AI agents use add_bookmark to create or update resources in MCP Bookmarks — usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your MCP Bookmarks environment.

Why add_bookmark needs a policy

This tool creates new bookmark entries and organizes them hierarchically via parentId, which are data structures that can be updated, moved, or deleted. There are no side effects beyond the bookmark system itself (no execution, deletion, or financial impact). The capability is reversible and represents a Write operation.

From the tool's definition Tool description states 'Add a bookmark to a group' and 'mark important code locations' - this creates or modifies bookmark data in the codebase organization system reversibly.

Questions about add_bookmark

What does the add_bookmark tool do? +

Add a bookmark to a group. Bookmarks mark important code locations with explanations. Supports hierarchical bookmarks via parentId. NEW: Markdown links in descriptions! - Link to files: [config](src/config.ts) - Link to specific lines: [handler](src/handler.ts:45) - Create cross-references between code locations CRITICAL - NEVER GUESS LINE NUMBERS! - You MUST use Grep tool to search and confirm the EXACT line number before adding a bookmark - NEVER estimate or guess line numbers - always search with Grep first - NEVER use file:1 - the first line is almost always an import statement, not meaningful code - Example: \. It is categorised as a Write tool in the MCP Bookmarks MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.

How do I enforce a policy on add_bookmark? +

Register the MCP Bookmarks MCP server in PolicyLayer and add a rule for add_bookmark: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches MCP Bookmarks. Nothing to install.

What risk level is add_bookmark? +

add_bookmark is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.

Can I rate-limit add_bookmark? +

Yes. Add a rate_limit block to the add_bookmark rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block add_bookmark completely? +

Set action: deny in the PolicyLayer policy for add_bookmark. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides add_bookmark? +

add_bookmark is provided by the MCP Bookmarks MCP server (linonon/mcpbookmarks). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

// LOOK UP ANOTHER SERVER

Every MCP server has a record like this.

Type a name, get the same breakdown: verified identity, auth posture, risk grade, capabilities, recommended policy.

Teams ship this data inside their own products. See what a licence covers →

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.