Servidor MCP

Grabblist

com.grabbitapp/grabblist
Comercio y retail Productividad Público y accesible MCP 2026-07-28

Qué hace este MCP

Saves, organizes, searches, compares, and shares static snapshots of web products and other finds in collections and wishlists.

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. Price is optional: omit it for videos and other things without a price. If no image is provided, the server attempts to fetch og:image automatically.
Acceso externo
Esquema de entrada
{'type': 'object', 'required': ['url', 'title', 'platform'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'maxLength': 2000, 'description': 'Direct public HTTP(S) page URL.'}, 'tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100}, 'description': 'Tags for categorization'}, 'image': {'type': 'string', 'format': 'uri', 'maxLength': 2000, 'description': 'Main image URL. Server auto-fetches og:image if not provided.'}, 'price': {'type': 'number', 'maximum': 1000000000000, 'minimum': 0, 'description': 'Price as a number (e.g. 99.99), taken from the page. Omit when the item has no price (videos, free content).'}, 'title': {'type': 'string', 'maxLength': 500, 'description': 'Exact title from the page'}, 'images': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'maxLength': 2000}, 'description': 'All image URLs found on the page'}, 'reason': {'type': 'string', 'maxLength': 1000, 'description': 'Why this change was made (shown to user in change history)'}, 'category': {'enum': ['electronics', 'furniture', 'home', 'clothing', 'vehicles', 'kids', 'sports', 'collectibles', 'tools', 'other'], 'type': 'string', 'description': 'Category — pick the best match'}, 'currency': {'type': 'string', 'maxLength': 10, 'description': 'Currency code of the price: USD, NZD, AUD, EUR, GBP, etc. Omit when there is no price.'}, 'location': {'type': 'string', 'maxLength': 500, 'description': 'Seller location or pickup location'}, 'platform': {'type': 'string', 'maxLength': 100, 'description': 'Site domain name without TLD: amazon.com→"amazon", ebay.co.nz→"ebay", kiwiquads.co.nz→"kiwiquads"'}, 'quantity': {'type': 'integer', 'maximum': 1000000, 'minimum': 1, 'description': 'How many of this item'}, 'condition': {'type': 'string', 'maxLength': 100, 'description': 'Condition if applicable: New, Used, Refurbished, Used - Like New, Used - Good, Used - Fair'}, 'item_type': {'enum': ['product', 'rental', 'service', 'course', 'listing', 'event', 'video', 'other'], 'type': 'string', 'description': 'What kind of item: product (buy), rental (Airbnb), service (cleaning), course (Udemy), listing (classified), event (ticket), video (YouTube, Twitch, TikTok, Vimeo…). If omitted, the server infers it from the platform (video sites → video, otherwise product).'}, 'posted_at': {'type': 'string', 'maxLength': 64, 'description': 'When the listing was originally posted (ISO 8601)'}, 'attributes': {'type': 'object', 'description': 'Specs/details as key-value pairs', 'additionalProperties': {'oneOf': [{'type': 'string', 'maxLength': 500}, {'type': 'number'}, {'type': 'boolean'}]}}, 'description': {'type': 'string', 'maxLength': 2000, 'description': 'Description from the page (max 2000 chars)'}, 'seller_name': {'type': 'string', 'maxLength': 200, 'description': 'Seller or store name'}, 'seller_rating': {'type': 'number', 'maximum': 5, 'minimum': 0, 'description': 'Seller rating 0-5'}, 'original_price': {'type': 'number', 'maximum': 1000000000000, 'minimum': 0, 'description': 'Original price before discount (if on sale)'}, 'seller_reviews': {'type': 'integer', 'maximum': 1000000000, 'minimum': 0, 'description': 'Number of seller reviews'}}}
add_to_collection
Add a saved item to a collection. Both the item and collection must already exist.
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['collection_id', 'item_id'], 'properties': {'reason': {'type': 'string', 'description': 'Why this change was made (shown to user in change history)'}, 'item_id': {'type': 'string', 'description': 'The item ID to add'}, 'collection_id': {'type': 'string', 'description': 'The collection ID'}}}
create_collection
Create a new collection (folder) in the user's Grabblist to organize saved items.
Esquema de entrada
{'type': 'object', 'required': ['name'], 'properties': {'icon': {'type': 'string', 'description': 'Material Symbols icon name (e.g. "devices", "home", "shopping_bag", "checkroom", "directions_car", "favorite"). Default: inventory_2'}, 'name': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Collection name, e.g. "Gaming Setup" or "Gift Ideas"'}, 'color': {'type': 'string', 'description': 'Hex color for the collection (e.g. "#3B82F6", "#22C55E", "#A855F7", "#EC4899", "#F59E0B", "#EF4444"). Default: #3B82F6'}, 'budget': {'type': 'number', 'description': 'Total spending target for this collection (e.g. 1500 for "Build PC under $1500")'}, 'reason': {'type': 'string', 'description': 'Why this change was made (shown to user in change history)'}, 'description': {'type': 'string', 'maxLength': 500, 'description': 'Short description of what this collection is for'}, 'budget_currency': {'type': 'string', 'description': 'Currency for the budget (default: NZD)'}}}
delete_collection
Permanently delete a collection. Items inside are not deleted — they stay in the Grabblist.
Destructivo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The collection ID to delete'}, 'reason': {'type': 'string', 'description': 'Why this change was made (shown to user in change history)'}}}
delete_item
Remove one or more items from the user's Grabblist (soft-delete). Pass a single id or an array of ids for batch operations.
Destructivo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Item ID or array of item IDs to delete'}, 'reason': {'type': 'string', 'maxLength': 1000, 'description': 'Why this change was made (shown to user in change history)'}}}
get_collection_activity
Get recent activity on a collection — additions, removals, edits.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['collection_id'], 'properties': {'limit': {'type': 'number', 'maximum': 50, 'minimum': 1, 'description': 'Max events to return (default: 20)'}, 'collection_id': {'type': 'string', 'description': 'The collection ID'}}}
get_item
Get full details of a saved item by ID. Returns a static snapshot from the user's Grabblist.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The item ID'}}}
get_item_graph
Get all relations for an item — alternatives, complements, upgrades, duplicates. Returns the item and all connected items with their relation types.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The item ID to get relations for'}}}
get_item_history
Get the change history for a saved item — who changed what and when.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['item_id'], 'properties': {'limit': {'type': 'number', 'maximum': 50, 'minimum': 1, 'description': 'Max events to return (default: 20)'}, 'item_id': {'type': 'string', 'description': 'The item ID'}}}
get_wishlist
Get all saved items from the user's Grabblist. Each item is a static snapshot — data reflects the moment it was saved, not current prices.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'limit': {'type': 'number', 'maximum': 100, 'minimum': 1, 'description': 'Max items to return (default: 50)'}, 'platform': {'type': 'string', 'description': 'Filter by platform (domain name, e.g. "amazon", "ebay", "trademe")'}}}
link_items
Create typed relations between items: alternative (A or B), complement (A and B together), upgrade (B replaces A), duplicate (same item different site), same_seller. Supports single pair (from_id, to_id, relation) or bulk (pairs array).
Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'pairs': {'type': 'array', 'items': {'type': 'object', 'required': ['from_id', 'to_id', 'relation'], 'properties': {'to_id': {'type': 'string', 'description': 'Second item ID'}, 'from_id': {'type': 'string', 'description': 'First item ID'}, 'relation': {'enum': ['alternative', 'complement', 'upgrade', 'duplicate', 'same_seller'], 'type': 'string', 'description': 'Type of relationship'}}}, 'description': 'Array of pairs to link (for bulk mode)'}, 'to_id': {'type': 'string', 'description': 'Second item ID (for single pair mode)'}, 'reason': {'type': 'string', 'description': 'Why this change was made (shown to user in change history)'}, 'from_id': {'type': 'string', 'description': 'First item ID (for single pair mode)'}, 'relation': {'enum': ['alternative', 'complement', 'upgrade', 'duplicate', 'same_seller'], 'type': 'string', 'description': 'Type of relationship (for single pair mode)'}}}
list_collections
List all collections OR get a specific collection with its items. Without id: returns all collections with counts/values. With id: returns that collection's metadata and all items inside (with optional filters).
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Collection ID — if provided, returns that collection with all its items. If omitted, lists all collections.'}, 'sort': {'enum': ['newest', 'oldest', 'price_asc', 'price_desc', 'title'], 'type': 'string', 'description': 'Sort order (only when id is provided, default: newest)'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Filter items that have ALL these tags (only when id is provided)'}, 'status': {'enum': ['considering', 'shortlisted', 'decided', 'bought', 'rejected'], 'type': 'string', 'description': 'Filter by decision status (only when id is provided)'}, 'platform': {'type': 'string', 'description': 'Filter by platform domain name, e.g. "amazon", "ebay" (only when id is provided)'}, 'max_price': {'type': 'number', 'description': 'Maximum price filter (only when id is provided)'}, 'min_price': {'type': 'number', 'description': 'Minimum price filter (only when id is provided)'}, 'created_by': {'enum': ['user', 'ai', 'extension'], 'type': 'string', 'description': 'Filter by who added: "ai" for AI-added items (only when id is provided)'}}}
ping
Test connectivity to Grabblist and return service version.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'properties': {}}
remove_from_collection
Remove one or more items from a collection. Pass a single item_id or an array of item_ids for batch removal. Items are NOT deleted — they stay in the Grabblist.
Destructivo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['collection_id', 'item_ids'], 'properties': {'reason': {'type': 'string', 'description': 'Why this change was made (shown to user in change history)'}, 'item_ids': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Item ID or array of item IDs to remove'}, 'collection_id': {'type': 'string', 'description': 'The collection ID'}}}
restore_item
Restore one or more deleted (archived) items back to the Grabblist. Pass a single id or an array of ids for batch restore.
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Item ID or array of item IDs to restore'}, 'reason': {'type': 'string', 'maxLength': 1000, 'description': 'Why this change was made (shown to user in change history)'}}}
search_saved
Search within the user's saved items by keyword
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'number', 'maximum': 50, 'minimum': 1, 'description': 'Max results (default: 20)'}, 'query': {'type': 'string', 'maxLength': 500, 'description': 'Search query'}}}
send_feedback
Send feedback, a bug report or a feature request to the Grabblist team. Only call this when the user asks to report something, or agrees after you offer to report a problem (parsing failure, broken URL, missing feature); show them the message first. Be specific about what went wrong and where.
Destructivo
Esquema de entrada
{'type': 'object', 'required': ['type', 'message'], 'properties': {'url': {'type': 'string', 'format': 'uri', 'description': 'The URL where the issue occurred'}, 'tool': {'type': 'string', 'description': 'The tool you were using when the issue occurred (e.g. add_item, search_saved)'}, 'type': {'enum': ['bug', 'parsing_failure', 'feature_request', 'feedback'], 'type': 'string', 'description': 'Type: bug (something broken), parsing_failure (price/title/image not extracted), feature_request (wishlist), feedback (general feedback)'}, 'error': {'type': 'string', 'description': 'Error message you received, if any'}, 'message': {'type': 'string', 'maxLength': 2000, 'minLength': 1, 'description': 'What happened or what you propose. Be specific — the team reads this.'}}}
set_pinned_items
Set the pinned "Top Picks" items for a collection (max 3). Pinned items are highlighted on the share page.
Destructivo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['collection_id', 'item_ids'], 'properties': {'reason': {'type': 'string', 'description': 'Why this change was made (shown to user in change history)'}, 'item_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Items to pin, in display order (1st = top)'}, 'collection_id': {'type': 'string', 'description': 'The collection ID'}}}
unlink_items
Remove a relation between two items.
Destructivo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['from_id', 'to_id', 'relation'], 'properties': {'to_id': {'type': 'string', 'description': 'Second item ID'}, 'reason': {'type': 'string', 'description': 'Why this change was made (shown to user in change history)'}, 'from_id': {'type': 'string', 'description': 'First item ID'}, 'relation': {'enum': ['alternative', 'complement', 'upgrade', 'duplicate', 'same_seller'], 'type': 'string', 'description': 'The relation type to remove'}}}
update_collection
Update a collection's name, icon, description, budget, or sharing status. Only provide the fields you want to change — omitted fields stay unchanged. Set is_public=true to share (returns public URL), is_public=false to unshare.
Destructivo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The collection ID to update'}, 'icon': {'type': 'string', 'description': 'Material Symbols icon name (e.g. "devices", "home", "shopping_bag")'}, 'name': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'New collection name'}, 'color': {'type': 'string', 'description': 'Hex color (e.g. "#3B82F6", "#22C55E", "#EF4444")'}, 'budget': {'type': 'number', 'description': 'New budget amount'}, 'reason': {'type': 'string', 'description': 'Why this change was made (shown to user in change history)'}, 'is_public': {'type': 'boolean', 'description': 'Set true to share (generates public URL), false to unshare'}, 'description': {'type': 'string', 'maxLength': 500, 'description': 'New description'}, 'budget_currency': {'type': 'string', 'description': 'New budget currency'}}}
update_item
Edit fields on one or more saved items. Pass a single id or an array of ids for batch updates (same fields applied to all). For batch: attributes are REPLACED not merged, og:image fallback is skipped.
Destructivo Idempotente
Esquema de entrada
{'type': 'object', 'required': ['id'], 'properties': {'id': {'oneOf': [{'type': 'string'}, {'type': 'array', 'items': {'type': 'string'}}], 'description': 'Item ID or array of item IDs to update'}, 'tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 100}, 'description': 'Replace all tags with this list'}, 'notes': {'type': 'string', 'maxLength': 2000, 'description': 'User or AI notes — personal comments, thoughts, comparisons'}, 'title': {'type': 'string', 'maxLength': 500, 'description': 'Item title'}, 'images': {'type': 'array', 'items': {'type': 'string', 'format': 'uri', 'maxLength': 2000}, 'description': 'All image URLs — replaces the entire images array'}, 'reason': {'type': 'string', 'maxLength': 1000, 'description': 'Why this change was made (shown to user in change history)'}, 'status': {'enum': ['considering', 'shortlisted', 'decided', 'bought', 'rejected'], 'type': 'string', 'description': 'Decision status: considering, shortlisted, decided, bought, rejected'}, 'category': {'enum': ['electronics', 'furniture', 'home', 'clothing', 'vehicles', 'kids', 'sports', 'collectibles', 'tools', 'other'], 'type': 'string', 'description': 'Item category'}, 'quantity': {'type': 'integer', 'maximum': 1000000, 'minimum': 1, 'description': 'How many of this item'}, 'image_url': {'type': 'string', 'format': 'uri', 'maxLength': 2000, 'description': 'Main image URL'}, 'item_type': {'enum': ['product', 'rental', 'service', 'course', 'listing', 'event', 'other'], 'type': 'string', 'description': 'What kind of item this is'}, 'attributes': {'type': 'object', 'description': 'Merge into existing attributes', 'additionalProperties': {'oneOf': [{'type': 'string', 'maxLength': 500}, {'type': 'number'}, {'type': 'boolean'}]}}, 'description': {'type': 'string', 'maxLength': 2000, 'description': 'Item description (max 2000 chars)'}, 'is_favorite': {'type': 'boolean', 'description': 'Set true to favorite, false to unfavorite'}, 'target_price': {'type': 'number', 'maximum': 1000000000000, 'minimum': 0, 'description': 'What the user wants to pay — not the actual price, but the goal price'}}}
update_price
Manually update the price on a saved item. Records old and new price for comparison. This is a manual correction, not automatic price tracking.
Destructivo
Esquema de entrada
{'type': 'object', 'required': ['id', 'price'], 'properties': {'id': {'type': 'string', 'description': 'The item ID'}, 'price': {'type': 'number', 'maximum': 1000000000000, 'minimum': 0, 'description': 'New current price'}, 'reason': {'type': 'string', 'description': 'Why this change was made (shown to user in change history)'}, 'source': {'enum': ['ai_check', 'manual'], 'type': 'string', 'description': 'Price update source'}}}
Eliminado
ask_agent
5 de October de 2026 a las 02:54
Modificado
send_feedback
5 de October de 2026 a las 02:54
Modificado
set_pinned_items
5 de October de 2026 a las 02:54
Modificado
update_collection
5 de October de 2026 a las 02:54
Modificado
remove_from_collection
5 de October de 2026 a las 02:54
Modificado
update_item
5 de October de 2026 a las 02:54
Modificado
update_price
5 de October de 2026 a las 02:54
Modificado
add_item
5 de October de 2026 a las 02:54
Añadido
ask_agent
17 de September de 2026 a las 12:35
Añadido
send_feedback
17 de September de 2026 a las 12:35
Añadido
set_pinned_items
17 de September de 2026 a las 12:35
Añadido
get_collection_activity
17 de September de 2026 a las 12:35
Añadido
get_item_history
17 de September de 2026 a las 12:35
Añadido
unlink_items
17 de September de 2026 a las 12:35
Añadido
get_item_graph
17 de September de 2026 a las 12:35
Añadido
link_items
17 de September de 2026 a las 12:35
Añadido
update_collection
17 de September de 2026 a las 12:35
Añadido
delete_collection
17 de September de 2026 a las 12:35
Añadido
remove_from_collection
17 de September de 2026 a las 12:35
Añadido
add_to_collection
17 de September de 2026 a las 12:35
Añadido
create_collection
17 de September de 2026 a las 12:35
Añadido
list_collections
17 de September de 2026 a las 12:35
Añadido
update_item
17 de September de 2026 a las 12:35
Añadido
update_price
17 de September de 2026 a las 12:35
Añadido
search_saved
17 de September de 2026 a las 12:35
Añadido
restore_item
17 de September de 2026 a las 12:35
Añadido
delete_item
17 de September de 2026 a las 12:35
Añadido
add_item
17 de September de 2026 a las 12:35
Añadido
get_item
17 de September de 2026 a las 12:35
Añadido
get_wishlist
17 de September de 2026 a las 12:35