AI connector
Cuestio connector tools
This page documents the 17 tools of the Cuestio connector to the Price Radar. It is for organizations that connect Claude or another AI assistant to the Price Radar and for reviewers of AI assistant directories. The connection steps are on the page Connect your AI assistant to Cuestio's Price Radar. These are online prices and listings of Panama's stores, never sales or market shares.
How to read the classes
- Read. The tool only reads.
- Write. The tool adds or changes data.
- Sensitive write. The tool removes, replaces or moves something. Assistants usually ask before running one.
Each tool carries the MCP annotations readOnlyHint and destructiveHint, and these are what the assistant reads to decide when to ask. A Read tool has readOnlyHint true. A Sensitive write tool has destructiveHint true. Every other tool that changes data is a Write tool. price_watch changes a list the whole organization shares, so it is a Sensitive write.
Rules common to every tool
- Status. Every tool returns an MCP tool result with structured content (
structuredContent) and a JSON text copy. A refusal is a tool result withisError: trueand a text in Spanish and English, never an HTTP error. - Organization refusals. Your access to Cuestio in that organization has ended and an administrator has to invite you again ("Your access to Cuestio in this organization has ended. Ask an administrator to invite you again."). The organization has no active Price Radar and an administrator has to activate it ("Your organization has no active Price Radar in Cuestio. Ask an administrator to activate it."). The connector is not available at the moment and trying again in a few minutes is the answer ("The Cuestio connector is not currently available. Try again in a few minutes.").
- Rate limit. Too many requests in a row: "Too many requests in a row, wait a moment and retry."
- Refused arguments. An unknown or invalid argument is refused with the reason, before the tool runs.
- Write tools and read-only tokens. A Write tool called on a read-only token meets the MCP SDK's "Tool not found" error. A token with
prices:writelists all 17 tools. - Limits. The price tools on the Cuestio plan share a burst limit, with a capacity and a refill per second. The exact figure is not given on this page. There is no daily cap on price calls on the Cuestio plan. Exports have a daily limit: by default 50 exports and 2,000,000 rows a day. The live configuration can change these figures.
Account
whoami Read
- Returns: The account id and its tier (free or paid). On a free plan it adds one line on what the plan includes.
- Inputs: none
- Output fields:
uid,tier,message - Who may call it: An active member of an organization whose Price Radar is active, with the
prices:readscope. - What it changes: None, it only reads.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), refused input
- Annotations:
readOnlyHinttrue,destructiveHintfalse
Online prices
price_search Read
- Returns: The matching products, each with its store count and the cheapest and the dearest store and price, paged by cursor.
- Inputs:
query*,limit,cursor - Output fields:
products,total,relaxed,cursor,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with the
prices:readscope. - What it changes: None, it only reads.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), refused input
- Annotations:
readOnlyHinttrue,destructiveHintfalse
price_offers Read
- Returns: Every current online offer for one product, cheapest first: store, branch, price, previous price, product page, the day read and the day changed, and stock flags on request.
- Inputs:
product*,includeOutOfStock,stock,include_hidden - Output fields:
product,offers,notes,storeCount,offerCount,hidden_count,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with the
prices:readscope. - What it changes: None, it only reads.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), refused input
- Annotations:
readOnlyHinttrue,destructiveHintfalse
price_history Read
- Returns: One product's online price per store as runs of a constant price or one point per day. It covers the last 30 days by default and at most 400 days.
- Inputs:
product*,stores,from,to,granularity - Output fields:
product,from,to,granularity,series,clampedTo,sparseBefore,note,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with the
prices:readscope. - What it changes: None, it only reads.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), refused input
- Annotations:
readOnlyHinttrue,destructiveHintfalse
price_basket Read
- Returns: Each store's total over the products it prices, the products it misses, the cheapest store and a paged price matrix.
- Inputs:
products,basketId,watchList,stores,inStockOnly,limit,cursor - Output fields:
scope,stores,cheapestStore,matrix,total,cursor,unmatched,unmatchedCount,unpriced,unpricedCount,notes,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with the
prices:readscope. - What it changes: None, it only reads.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), refused input
- Annotations:
readOnlyHinttrue,destructiveHintfalse
price_changes Read
- Returns: Price cuts, rises, new offers and delistings over one scope, each with the price before and after, the change in percent and its day.
- Inputs:
scope*,from,to,kinds,limit,cursor - Output fields:
changes,counts,window,total,cursor,scope,scopeKind,notes,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with the
prices:readscope. - What it changes: None, it only reads.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), refused input
- Annotations:
readOnlyHinttrue,destructiveHintfalse
price_watch Sensitive write
- Returns: The watch list's items (action
list), or the list after aset,addorremoveaction. - Inputs:
action*,items,limit,cursor - Output fields:
action,items,total,cursor,count,removed,watchMax,used,unresolved,notes,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with a token of scope
prices:write. The list is the organization's, shared by its members. - What it changes:
setreplaces the whole list,addmerges items in,removetakes items out andlistchanges nothing. - Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), refused input
- Annotations:
readOnlyHintfalse,destructiveHinttrue
price_index Read
- Returns: Per competitor, the matched products, the median and mean price ratio, the shares cheaper, dearer and equal, and the ten biggest gaps each way.
- Inputs:
reference*,competitors,scope,inStockOnly - Output fields:
reference,competitors,inStockOnly,scope,scopeKind,notes,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with the
prices:readscope. - What it changes: None, it only reads.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), refused input
- Annotations:
readOnlyHinttrue,destructiveHintfalse
price_promotions Read
- Returns: The live promotions of the online supermarkets, each with its depth in percent, its start day and its store.
- Inputs:
stores,scope,from,to,rule,includeEnded,limit,cursor - Output fields:
promotions,counts,byStore,suspectPromotions,window,rule,includeEnded,total,cursor,scope,scopeKind,notes,quota,asOf,sources,partial - Who may call it: An active member of an organization whose Price Radar is active, with the
prices:readscope. - What it changes: None, it only reads.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), refused input
- Annotations:
readOnlyHinttrue,destructiveHintfalse
price_availability Read
- Returns: Per product and store, whether it is listed, its online stock flag, its price and day, plus a summary per store.
- Inputs:
brand,basketId,watchList,products,stores,limit,cursor - Output fields:
products,summary,total,cursor,scope,notes,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with the
prices:readscope. - What it changes: None, it only reads.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), refused input
- Annotations:
readOnlyHinttrue,destructiveHintfalse
price_export Write
- Returns: A private download link to a CSV file of one price report, valid for 15 minutes, in parts above 200,000 rows.
- Inputs:
report*,args,format,part - Output fields:
report,part,parts,rows,bytes,url,expiresAt,exportBudget,quota,asOf,sources,partial - Who may call it: An active member of an organization whose Price Radar is active, with a token of scope
prices:write. - What it changes: Writes a CSV file on facturillo's server behind a private link that expires after 15 minutes, deletes the file after a day, and counts against the plan's export budget.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), export budget, refused input
- Annotations:
readOnlyHintfalse,destructiveHintfalse
price_stores Read
- Returns: The online stores covered, with banners, branches, offer and product counts, main categories and whether each publishes stock.
- Inputs: none
- Output fields:
stores,total,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with the
prices:readscope. - What it changes: None, it only reads.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), refused input
- Annotations:
readOnlyHinttrue,destructiveHintfalse
Baskets
basket_list Read
- Returns: The account's baskets (name, icon, color, line count, last refresh, best buy), or one basket with its products.
- Inputs:
basketId,limit,cursor - Output fields:
baskets,total,cursor,basket,lines,caps,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with the
prices:readscope. Baskets live in the person's own facturillo account. - What it changes: None, it only reads.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), refused input
- Annotations:
readOnlyHinttrue,destructiveHintfalse
basket_create Write
- Returns: The new basket, each product's result (
added,duplicate,capReached,notFound) and the plan's caps. - Inputs:
name*,icon,color,products - Output fields:
basketId,name,lines,linesAdded,notes,caps,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with a token of scope
prices:write. Baskets live in the person's own facturillo account. - What it changes: Creates a basket in the account, shown in the facturillo app at once.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), basket caps, refused input
- Annotations:
readOnlyHintfalse,destructiveHintfalse
basket_add_products Write
- Returns: Each product's result (
added,duplicate,capReached,notFoundorerror) and the basket after the change. - Inputs:
basketId*,products* - Output fields:
basketId,results,lineCount,linesMax,notes,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with a token of scope
prices:write. Baskets live in the person's own facturillo account. - What it changes: Adds product lines to one basket, shown in the app.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), basket caps, refused input
- Annotations:
readOnlyHintfalse,destructiveHintfalse
basket_remove_product Sensitive write
- Returns: The basket's line count after the change.
- Inputs:
basketId*,product* - Output fields:
basketId,removed,lineCount,notes,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with a token of scope
prices:write. Baskets live in the person's own facturillo account. - What it changes: Removes one product line from one basket.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), basket caps, refused input
- Annotations:
readOnlyHintfalse,destructiveHinttrue
basket_delete Sensitive write
- Returns: The plan's caps after the change.
- Inputs:
basketId* - Output fields:
basketId,deleted,caps,quota,asOf,sources - Who may call it: An active member of an organization whose Price Radar is active, with a token of scope
prices:write. Baskets live in the person's own facturillo account. - What it changes: Deletes one basket from the account and the app.
- Errors: rate limit, organization refusal (access ended, Price Radar not active, connector unavailable), basket caps, refused input
- Annotations:
readOnlyHintfalse,destructiveHinttrue
Privacy and support
What the assistant can do with your account, what it receives and how to revoke the connection is in facturillo's privacy policy, in the section "AI Assistant Connections (facturillo AI Connector)" and its part "Cuestio: the organization dashboard and its Price Radar connection". Cuestio is a product of facturillo Inc.
Support: info@facturillo.com