add_item
Save an item to the user's Grabblist. Creates a static snapshot — Grabblist does not monitor prices or auto-update data. Only include fields with values available from the source. If no image is provided, the server attempts to fetch og:image automatically.
This record as markdown: /tools/com-grabbitapp-grabblist/add-item.md
What add_item does on Grabblist
AI agents use add_item to create or update resources in Grabblist, usually the action step of a workflow, after the agent has gathered context. Every call changes real data in your Grabblist environment.
| Parameter | Type | Required | Description |
|---|---|---|---|
url | object | Yes | Direct public HTTP(S) page URL. |
tags | array | — | Tags for categorization |
image | object | — | Main image URL. Server auto-fetches og:image if not provided. |
price | number | Yes | Price as number (e.g. 99.99) — REQUIRED, extract from page |
title | string | Yes | Exact title from the page |
images | array | — | All image URLs found on the page |
reason | string | — | Why this change was made (shown to user in change history) |
category | string | — | Category — pick the best match |
currency | string | Yes | Currency code: USD, NZD, AUD, EUR, GBP, etc. |
location | string | — | Seller location or pickup location |
platform | string | Yes | Site domain name without TLD: amazon.com→"amazon", ebay.co.nz→"ebay", kiwiquads.co.nz→"kiwiquads" |
quantity | integer | — | How many of this item |
Parameters from the server's own tool schema.
Why add_item is rated Medium
An AI agent can call add_item faster than any human can review: one bad instruction and it creates or modifies resources in Grabblist by the hundred, each call as confident as the last.
Risk signalsAccepts URL/endpoint input (url) · High parameter count (21 properties)
Attacks that exploit this kind of access
The rule that runs add_item safely
PolicyLayer is an MCP gateway: it sits between your AI agents and Grabblist, and checks every tool call against a rule you set before the call runs. Nothing changes on the server itself. For add_item, this is the rule to start with:
add_item 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.
The button opens the PolicyLayer dashboard: create your workspace, connect Grabblist, apply this rule, and every add_item call is checked against it from then on.
Questions about add_item
Save an item to the user's Grabblist. Creates a static snapshot — Grabblist does not monitor prices or auto-update data. Only include fields with values available from the source. If no image is provided, the server attempts to fetch og:image automatically. It is categorised as a Write tool in the Grabblist MCP Server, which means it can create or modify data. Consider rate limits to prevent runaway writes.
add_item accepts 12 parameters: url, tags, image, price, title, images, reason, category, currency, location, platform, quantity. Required: url, price, title, currency, platform. The full parameter table on this page comes from the server's own tool schema.
Register the Grabblist MCP server in PolicyLayer and add a rule for add_item: 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 Grabblist. Nothing to install.
add_item is a Write tool with medium risk. Write tools should be rate-limited to prevent accidental bulk modifications.
Yes. Add a rate_limit block to the add_item 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.
Set action: deny in the PolicyLayer policy for add_item. 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.
add_item is provided by the Grabblist MCP server (https://mcp.grabbitapp.com/api/mcp). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.
More on Grabblist, and thousands of servers like it.
This server
Across the catalogue