add_child_bookmark

Add a child bookmark under an existing bookmark. Creates hierarchical structure. 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 NUMBER...

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

What add_child_bookmark does on MCP Bookmarks

AI agents use add_child_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_child_bookmark needs a policy

This tool creates new bookmark entries in a hierarchical bookmark management system. It is a write operation because it adds/creates data (child bookmarks) to an existing data structure, with no irreversible deletion or financial impact. The operation is reversible (bookmarks can be removed via sibling tools like batch_remove_bookmarks), affecting only code annotation metadata within a VSCode extension.

From the tool's definition Tool description states it 'Add[s] a child bookmark under an existing bookmark' and 'Creates hierarchical structure' — these are create operations that add data to a bookmark tree structure.

Questions about add_child_bookmark

What does the add_child_bookmark tool do? +

Add a child bookmark under an existing bookmark. Creates hierarchical structure. 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 CRITICAL - Location = CALL SITE in parent function: - The location should be WHERE the child function is CALLED (inside the parent) - NOT the definition of the child function Example - Correct call site marking: \. 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_child_bookmark? +

Register the MCP Bookmarks MCP server in PolicyLayer and add a rule for add_child_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_child_bookmark? +

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

Can I rate-limit add_child_bookmark? +

Yes. Add a rate_limit block to the add_child_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_child_bookmark completely? +

Set action: deny in the PolicyLayer policy for add_child_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_child_bookmark? +

add_child_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.