Medium Risk

add_linked_url_attachment

Attach a linked URL to an existing Zotero item, or create a standalone linked-URL attachment. Use this to link external PDFs, web pages, or other resources to items already in your library. If parent_item is provided, the attachment is added as a child; otherwise it is standalone.

How to control add_linked_url_attachment ↓

What add_linked_url_attachment does on Mcp Zotero

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

Medium Risk

Why add_linked_url_attachment needs a policy

This tool creates or modifies a Zotero item by attaching a linked URL resource. It is reversible (attachments can be removed), so it is Write rather than Destructive. The severity is medium because an agent misusing this could pollute a research library with spurious or malicious links, potentially causing reputational harm or wasted researcher effort, but it does not delete data or move money.

From the tool's definition Tool description states 'Attach a linked URL' and 'the attachment is added as a child; otherwise it is standalone' — these are create/modify operations that add new data to the Zotero library.

Documented attack patterns abuse exactly the kind of access add_linked_url_attachment gives an agent:

How to control add_linked_url_attachment

PolicyLayer is an MCP gateway — it sits between your AI agents and Mcp Zotero, and nothing reaches the server without passing your rules. This is the rule we recommend for add_linked_url_attachment:

policy.json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "add_linked_url_attachment": {
      "limits": [
        {
          "counter": "add_linked_url_attachment_rate",
          "window": "minute",
          "max": 30,
          "scope": "grant"
        }
      ]
    }
  }
}

add_linked_url_attachment stays usable, but capped — an agent stuck in a loop can't make hundreds of changes a minute. Everything else on the server is denied unless you say otherwise.

  1. Create a free account and register Mcp Zotero — nothing to install.
  2. Add this policy — paste it, or build it visually.
  3. Point your MCP client (Claude, Cursor, anything) at your gateway URL.
LIMIT THIS TOOL →

Free to start. No card required.

Related tools and policies

Go deeper

Questions about add_linked_url_attachment

What does the add_linked_url_attachment tool do? +

Attach a linked URL to an existing Zotero item, or create a standalone linked-URL attachment. Use this to link external PDFs, web pages, or other resources to items already in your library. If parent_item is provided, the attachment is added as a child; otherwise it is standalone. It is categorised as a Write tool in the Mcp Zotero 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_linked_url_attachment? +

Register the Mcp Zotero MCP server in PolicyLayer and add a rule for add_linked_url_attachment: 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 Zotero. Nothing to install.

What risk level is add_linked_url_attachment? +

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

Can I rate-limit add_linked_url_attachment? +

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

Set action: deny in the PolicyLayer policy for add_linked_url_attachment. 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_linked_url_attachment? +

add_linked_url_attachment is provided by the Mcp Zotero MCP server (xevos117/mcp-zotero). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

Enforce policy on every Mcp Zotero tool call.

Start from Mcp Zotero, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

Free to start. No card required.

13 Mcp Zotero tools catalogued and risk-classified — across an index of 43,000+ MCP servers.

// GET IN TOUCH

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

Message sent.

We'll get back to you soon.