REWALTO / DEVELOPERS / MCP PREVIEW
Rewalto's MCP server (preview) has 73 tools as of 1 November 2026, 7:32 pm IST, in 6 groups. 32 are free to call and 41 can spend credits, only for data delivered. This list is read live from Rewalto's public tool list.
| Tools listed | 73As of 1 November 2026, 7:32 pm IST |
|---|---|
| Free to call | 32 |
| Can spend credits | 41Only for data delivered |
| Open without sign-in | 5 |
The MCP server is in preview. Tools, inputs and access can change while it is in preview; this page reads the server's public tool list each time it is drawn, at most a few minutes old, so it shows what the server lists now.
Server address (preview): https://mcp.rewalto.com/mcp
Public tool list, free and with no key: GET https://api.rewalto.com/v1/mcp/tools
What Rewalto holds: categories, cards, entries and whether a product is already collected.
list_catalogue_categoriesList catalogue categories. Every category of the Rewalto data catalogue in page order, with how many cards and entries each has and how many are live, in preview, planned or degraded. Public and free to call.
list_catalogue_productsList or filter catalogue cards. Data-product cards: what you get, how many entries, coverage, freshness, keep/live and status. Filter by category id, text and status (live, preview, planned, degraded). Public and free to call. Each entry shows its own pricing from the catalogue: a published rate, "quote first", or "free tool".
search_catalogueSearch the catalogue. Search names, data types, sources and field names. A pasted product link or retailer product id also gets an intake answer (whether Rewalto already holds it). Pass the id of a result of type entry to get_catalogue_entry. A result of type product is a card, not an entry: its entry ids are the entryIds of that card in list_catalogue_products. Public and free to call. Each entry shows its own pricing from the catalogue: a published rate, "quote first", or "free tool".
get_catalogue_entryGet a catalogue entry. One dataset, recipe, workflow or tool in full: inputs and outputs (JSON Schema), sample rows, data dictionary, coverage with holes, freshness, rights, versions and, for a workflow, what it uses. Public and free to call. Each entry shows its own pricing from the catalogue: a published rate, "quote first", or "free tool".
check_intakeDo we already hold these products?. For up to 25 product links or retailer product ids: whether Rewalto already collects each, how it was linked (linkMethod), the product id it declares (declaredSku) and, per held listing, the canonical product it is linked to. Coverage facts only, never the data. Public and free to call.
create_data_requestAsk for data Rewalto does not hold. Records a request for data Rewalto does not offer yet: a catalogue search that found nothing, or a product link that is not held (send what found nothing as `query`). Staff count requests as demand for new datasets. No contact details in the text. Free. Needs an API key; answers for the key’s own organisation only.
Who is calling, the credit balance and what was spent.
whoamiWho am I. The organisation, role and plan the API key belongs to. Free. Needs an API key; answers for the key’s own organisation only.
get_credit_balanceCredit balance. Free and paid credits left this month. Free. Needs an API key; answers for the key’s own organisation only.
list_credit_usageCredit usage. What spent credits, newest first, with receipts. Free. Needs an API key; answers for the key’s own organisation only.
list_reportsReports. The organisation’s report editions, newest first: what each covers, its files and until when it can be downloaded. Free. Needs a signed-in dashboard session (admin and staff only for now); an API key is refused with forbidden.
get_reportA report. One report edition with its files. For a page "report:<id>", call this first. Free. Needs a signed-in dashboard session (admin and staff only for now); an API key is refused with forbidden.
refund_readAsk for a charge back. Asks for a charge’s credits back by its receipt (a `read` or `receipt` entry of list_credit_usage). A charged read is refunded, e.g. when its answer never arrived, unless the same data was read again after; a run only when it failed. Asking again returns the same refund. A refusal is `refund_refused` with the reason. Needs an API key; answers for the key’s own organisation only.
Reads of Rewalto's data. The ones marked as spending credits charge only for data delivered.
list_retailersRetailers with data. The retailers Rewalto holds commerce data for. Free. Needs an API key; answers for the key’s own organisation only.
get_pincodePin code lookup. One six-digit Indian pin code: its city, district and state, whether it is urban, every post office India Post lists for it, and which retailers Rewalto has read there (first and newest day, days, readings). Free. Needs an API key; answers for the key’s own organisation only.
interpret_queryRead a question into a request. Reads a typed question ("Amul butter price in Pune on Blinkit") into the request that answers it: the route (data, fresh, watch, finder or request), the operation to call (`target`) and its fields under that operation’s own names, each `stated` or `inferred`, plus what could not be mapped (`unresolved`). The same reading the website shows. Runs, quotes and charges nothing: call the target with the fields once the user confirms them. `route: null` means no reading; search the text as it is. Free. Needs an API key; answers for the key’s own organisation only.
get_brandA brand. One brand and where it is listed. Free. Needs an API key; answers for the key’s own organisation only.
list_listingsListings. Retailer listings (products as each retailer lists them), filtered. Spends credits at the published read rate, with no quote; the answer’s `meta.credits` says what was charged and gives the receipt. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
search_listingsSearch products by name. Retailer listings whose name, brand or retailer product id contain every word of q as the start of a word ("aashir atta" finds "Aashirvaad Atta"; Hindi words match as written), optionally one retailer, one exact brand, or listings read at one pin code in the last 30 days. Best match first: an exact retailer product id, then the words as a phrase in the name, then the rest, whole words before word starts ("atta" before "Attar"); when fewer than 10 match, likely misspellings follow ("ashirvad" finds "Aashirvaad"), those with the short typed words ("oil") first. Finding nothing costs nothing. Spends credits at the published read rate, with no quote; the answer’s `meta.credits` says what was charged and gives the receipt. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
get_availabilityIs it in stock at this pin code. For one six-digit pin code and one product (listingId: one retailer listing, such as a search_listings result; or productId: that Rewalto product’s listings read at this pin, across retailers): in_stock, out_of_stock or unknown per listing, from its newest kept reading there, with the reading time and, where recorded, the store. Never a guess: unknown says why (stale, no_reading_at_pin, stock_not_reported, excluded_pin_day). Unknown rows cost nothing. Spends credits at the published read rate, with no quote; the answer’s `meta.credits` says what was charged and gives the receipt. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
get_pin_availabilityShare in stock at a pin code. For one six-digit pin code (optionally one retailer), per retailer: how many listings read there are in stock and out of stock, by each listing’s newest kept reading, and the share in stock. Old, unreported and left-out readings are counted as unknown, by reason. Spends credits at the published read rate, with no quote; the answer’s `meta.credits` says what was charged and gives the receipt. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_observationsPrice and stock readings. Readings (price, MRP, stock, rank) by retailer, pin code, brand or product, over a time range. Spends credits at the published read rate, with no quote; the answer’s `meta.credits` says what was charged and gives the receipt. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_brand_mentionsYouTube brand mentions. For each brand and IST day: how many public YouTube videos published in India mention it, with their summed public views, likes and comments (atLeast: the page of 50 was full). Newest day first; optionally one brand and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_rating_changesRating changes. For one retailer: each product's rating, rating count and review count on every IST day one of them changed, per pin code (or national). Newest day first; optionally one product, one pin code and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_price_per_unitPrice per unit. For one retailer: each product's price per gram, millilitre or piece on each IST day at each pin code (or national), per pack, with the lowest, highest and mean in paise per unit and the selling prices; a pack that could not be read has an empty price per unit. Newest day first; optionally one product, one pin code and a day range. Charged per data point at its published rate; re-reading within 7 days is free. Needs an API key; answers for the key’s own organisation only.
list_stock_statesStock states. For one retailer: each product's stock state at the close of each IST day at each pin code (in, low, out, delisted or unknown), whether out at that pin only or everywhere, the stock count where shown, and the days in a row out or gone. Newest day first; optionally one product, one pin code, one state and a day range. Charged per stock state at its published rate; re-reading within 7 days is free. Needs an API key; answers for the key’s own organisation only.
list_banner_placementsBanner ads in search. For one app (zepto or instamart): each brand banner ad seen on a search term at a pin code on an IST day, with the keyword bought and billing model where stated, replies, stores, best position and linked products; the creative is a fingerprint only. Newest day first; optionally one brand, search term, pin code and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_storefront_promosD2C promo calendar. For each watched brand store and IST day: variants seen and on sale, the median and deepest discount (basis points), and how many went on sale, ended a sale, were cut in price or discounted deeper. Newest day first; optionally one brand, one store and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_search_ranksSearch rank history. For one retailer: per IST day, search term, pin code (or national) and listing, its best place in the whole result list (null where the reply does not state its page start), the first page and slot it was seen at, and how many replies showed it, placed it in the top 10 and marked it sponsored. Newest day first; optionally one product (retailerSku), search term, pin code and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_share_of_searchShare of search. For one retailer: per IST day, search term, pin code (or national) and brand, the brand's share of the first ten places (organic and sponsored together) over every reply read that day, how much of it was sponsored, and how many of its listings reached the top 10. Newest day first; optionally one brand, search term, pin code and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_promo_emailsBrand promo emails. Each promotion a brand emailed to subscribers, as recorded by Rewalto: send day, brand, offer, sale dates and discount code if stated, and the brand's linked page; never the email itself. Newest send day first; optionally one brand and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_ad_creativesAd creatives (Google Ads Transparency Center). Each ad creative a watched brand's advertiser ran in India, as Google's Ads Transparency Center lists it, read weekly: advertiser and creative ids, format (text, image or video), first and last day shown, a fingerprint and the creative's public page on the centre; never the ad itself. readVia: the brand's own advertiser account or its website (which also finds agency-placed ads). Newest day last shown first; optionally one brand, one advertiser id and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_storefrontsStorefront platforms. D2C online stores in Rewalto's storefront index with the platform that runs each (shopify, woocommerce, magento, fynd, unicommerce and others): platform confidence, market, when Rewalto first and last read the store, and how many products and variants Rewalto holds from its catalogue. In host order; optionally one store, one platform and one market. Charged per store at the listings rate. Needs an API key; answers for the key’s own organisation only.
list_sponsored_shareSponsored share in search. For one retailer: per IST day, search term, pin code and brand, the product cards the brand held in search, how many were marked sponsored (all and in places 1 to 10), its sponsored rate and its share of all sponsored cards of that term, pin and day. Ads are counted only where the reading can see the retailer's ad marker (Blinkit, Zepto, Nykaa, Tata 1mg); elsewhere shares are null. Newest day first; optionally one brand, search term, pin code and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_dark_storesDark stores and catchments. Each quick-commerce dark store Rewalto holds (Blinkit, Zepto, Instamart, BigBasket, Flipkart Minutes, JioMart, DMart), one record per store with every source merged: store id and name, pin code, area, address, point, city and state, the pin codes it serves, first and last seen, status (open, opened, closed) and its sources (old_sweep, core_sweep, app_reading, store_list). Send pincode for the stores that serve that pin. Newest last-seen day first; optionally one platform, city, status and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_regulatory_noticesRegulatory notices (CDSCO, FSSAI). Public notices from India's drug regulator (CDSCO public notices) and food regulator (FSSAI notifications), read weekly: title, release day, the document's link and size, and for FSSAI its category (draft, gazette, notice, sps, tbt, ordinary), comments link and further documents; never the document itself. Newest release day first; optionally one regulator, a day range and words in the title. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_launchesLaunches. Each listing that appeared on a retailer's shelf at a pin code on an IST day where it was not before: class (new_product, new_pack, new_seller, relisting), brand, title, pack, first-seen price and MRP, and the reading it was first seen in; detectedBy says previous_system (2 to 6 Sep 2026, history) or core (the daily roll). Newest day first; optionally one retailer, pin code, brand, class and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_product_listingsOne product across retailers. One product (product id, or retailer with retailerSku to start from one listing): every retailer listing Rewalto's matcher matched to it, with each listing's newest price, MRP and stock per pin code (or national) in a window of IST days (default 7, at most 31). Ordered by retailer, listing and pin code. Charged per record at the listings rate. Needs an API key; answers for the key’s own organisation only.
list_price_parityPrice parity across retailers. One product (product id, or retailer with retailerSku): for each IST day it was priced, every matched listing's newest price per pin code, the lowest and highest, and the gap in paise and basis points. Newest day first (default the last 30 days, at most 92), optionally one pin code. Charged per day at the history rate. Needs an API key; answers for the key’s own organisation only.
list_brand_directoryBrands and aliases. Canonical brands in name order: every spelling retailers and titles use for each, how many listings carry it, and its owning company where known, with the basis. Refreshed daily. Charged per brand at the company record rate. Needs an API key; answers for the key’s own organisation only.
list_brand_ownersBrand to company. The brands Rewalto can link to an owning company, with the basis for each link (a person named it, a company record's name or website matches the brand) and the company record when there is one. Charged per brand at the company record rate. Needs an API key; answers for the key’s own organisation only.
list_company_recordsCompany and brand records. Companies and brands Rewalto holds, one record per company: name, kind (brand, agency, startup, company), website and web host, place, industry and sectors, description, size and revenue bands, founded year, store platform, the company's own social accounts with follower counts, a revenue estimate in rupees and monthly site visits where measured, and its company email and phone where public. Most recently added first; optionally a name fragment, one web host, kind, startup, state, city or store platform. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_backer_recordsInvestor records (firms and angels). Investors Rewalto holds, one record per investor: venture funds, accelerators, incubators, family offices, corporate venture arms, private equity, angel networks and individual angels (investorKind), with type, headquarters, the geographies, stages and sectors they state, cheque size, thesis, website, LinkedIn and public email. Most recently added first; optionally a name fragment, kind, type, sector, stage or India focus. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_storefront_productsStorefront catalogue and prices. Product variants on D2C stores' own catalogues as Rewalto last read them: name, variant, brand, SKU, barcode, price and struck-through price in minor units (paise for INR), in stock or not, tags, image addresses, first and last seen. Filter by one store (host), a name search (q), a brand or a barcode; sku needs host. Charged per variant at the listings rate. Needs an API key; answers for the key’s own organisation only.
list_storefront_changesStorefront changes. What D2C stores changed between reads: products launched or delisted, variant price changes (old and new price and struck-through price, minor units), promotions (struck-through price moved, price held) and stock changes. Newest first; optionally one store (host), one kind of change and an IST day range. Charged per change at the listings rate. Needs an API key; answers for the key’s own organisation only.
list_d2c_brandsD2C brand directory. Indian D2C brands in Rewalto's brand directory: store host, brand name, platform, categories, city and state, employees and size band, estimated monthly visits and sales with bands (estimates; sales in US cents), products sold, sales channels, technologies, public social pages, and the platform Rewalto detected when the store is in the storefront index. Brand level only, no personal contact data. Host order; optionally one store, one platform, a category, a state or a city. Needs an API key; answers for the key’s own organisation only.
list_brand_shelfBrand share of shelf by pin code. For one retailer: each brand's distinct listings read at a pin code on an IST day against all distinct listings read there, as a share in basis points (shareBp, 10000 is the whole shelf). Rolled up daily from Rewalto's own readings from 25 Aug 2026. Newest day first; optionally one pin code, one brand and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_oos_rateOut-of-stock rate by brand and city. For one retailer: for each brand and city on an IST day, the readings that stated stock and how many were out of stock (oosBp is null when none stated stock; Flipkart states none). The city is the pin code's city in the India Post directory, or national. Rolled up daily from Rewalto's own readings from 25 Aug 2026. Newest day first; optionally one city, one brand and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_discountsDiscount depth by brand and category. For one retailer: for each brand and category on an IST day, the readings with a selling price and an MRP, how many were priced below MRP, and the average, median and deepest discount in basis points of MRP. Rolled up daily from Rewalto's own readings from 25 Aug 2026, so a festive season can be read day by day. Newest day first; optionally one brand, one category and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_delivery_etaDelivery time by pin. The delivery time quick-commerce apps stated at each pin code on each IST day: readings, the share that stated a time, least, median, 90th percentile and greatest minutes, with the source labelled (search, partner or sweep). Newest day first; optionally one retailer, pin code, source and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_unitsUnits left and units gone. For one retailer: each product's units per pin code and IST day: units left at the last reading, first, fewest and most, and units gone between readings (a lower bound on units sold; rises count as restocks). unitsFrom: the app's counter (Blinkit, Zepto, Myntra, Nykaa) or Flipkart's "Only N left". Newest day first; optionally one product, one pin code and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
list_badgesProduct badges. For one retailer: each product that showed a badge (bestseller, assured, only few left, deal tags) per pin code and IST day, with the distinct badges as written. Newest day first; optionally one product, one pin code and a day range. Spends credits at this dataset’s published rate, with no quote; `meta.credits` shows the rate, says what was charged and gives the receipt. Re-reading the same records within 7 days is free. With too few credits the API refuses with `credits_exhausted`, returns no data and charges nothing. Needs an API key; answers for the key’s own organisation only.
count_seriesCount a price series. Before get_series: the days, gap days, points with readings and readings a series read of this scope would deliver. Free: no prices, nothing charged. Needs an API key; answers for the key’s own organisation only.
get_seriesDaily price and stock series. Daily series for one product, brand, retailer or location, for charts: lowest, middle and highest price, stock readings in, out and unknown, and search position. A day with no reading is a gap, never filled. Charged at the published history rate per day with readings; gaps cost nothing; re-reading identical data within 7 days is free. Count it first with count_series. With too few credits the API refuses with `credits_exhausted` and charges nothing. Needs an API key; answers for the key’s own organisation only.
discover_listingsPreview matching listings. The preview before a paid fetch: up to 25 matching listings with their newest kept price, MRP and stock, exact match counts by retailer and brand, and what fetching every match would cost. Each organisation has free previews per IST day (`allowance`); past them a preview is charged at the listings rate for the rows shown, like search_listings, and `meta.credits` says what it cost. Nothing found costs nothing. Needs an API key; answers for the key’s own organisation only.
list_location_citiesCities. Cities by the start of their name, each with a stable location id, its pin codes, kept coverage (pins read in the last 30 days) and, with a retailer, how many of its pins a new collection could serve. Free. Needs an API key; answers for the key’s own organisation only.
list_location_storesDark stores in a city. One quick-commerce retailer’s dark stores in a city as Rewalto’s sweeps found them: a stable location id, label, open or closed, first and last seen, the pin codes each serves and kept coverage there. Free. Needs an API key; answers for the key’s own organisation only.
get_location_filterWhat a place covers. Resolves a location id (a pin, city, area or dark store) to its full list of pin codes, what is kept there per retailer, where a fresh collection could run, and exactly what a paid read of it would cover: its pin count is the confirmPins a multi-pin read needs. Free. Needs an API key; answers for the key’s own organisation only.
Quotes, approval and the runs they start. A run that costs credits starts only after approval.
create_quoteQuote a run. Price a recipe run before anything runs: units, extras, the rate version and the ceiling. Creating a quote spends nothing. Needs an API key; answers for the key’s own organisation only.
get_quoteRead a quote. One quote of the key’s organisation: its total, rate version, status and expiry. Free. Needs an API key; answers for the key’s own organisation only.
fresh_read_quoteQuote a fresh read. Price reading a recipe fresh now, at one or more pin codes: what the recipe’s collector would read for the query at each pin, one job per pin. Creating the quote spends nothing and runs nothing. Show the user the quote’s `ceiling` (the most it can cost, in credits) and ask them to approve it; only then call approve_quote with that ceiling. Once approved, the quote id is the run id for get_run and get_run_rows. A recipe no collector runs on demand is refused (unknown_capability). Needs an API key; answers for the key’s own organisation only.
approve_quoteApprove a quote. Approve one open quote: this is the user’s consent to spend up to its ceiling. Only call it after the user has seen the quote’s ceiling (the most it can cost, in credits) and explicitly said yes; pass that number as confirmedCeiling. The API refuses (cost_changed) if it is not exactly the quote's ceiling, and nothing is held. For a fresh read, approving starts the run: follow it with get_run. Needs an API key; answers for the key’s own organisation only.
list_runsList fresh reads. The organisation’s fresh-read runs, newest first, a page at a time (pass page.nextCursor back as cursor): each run’s recipe, query, pins, status, rows delivered and credits charged. Listing costs nothing; a run whose pins have all finished is settled on its first read, as with get_run. Follow one with get_run or get_run_rows. Needs an API key; answers for the key’s own organisation only.
get_runFollow a fresh read. One fresh-read run (its id is the approved quote’s id): its status, each pin’s progress, the rows delivered and, once every pin has finished, the credits charged: for the rows delivered, never above the approved ceiling, nothing when nothing was delivered. Reading it costs nothing; the first read after the run finishes settles the charge the user already approved. Read the rows with get_run_rows. Needs an API key; answers for the key’s own organisation only.
get_run_rowsRead a fresh read’s rows. The rows a fresh-read run delivered, pin by pin, a page at a time (pass nextCursor back as cursor). Free. Needs an API key; answers for the key’s own organisation only.
Watches that run on a schedule within a spending limit you set.
list_watchesSaved searches and watches. The organisation’s saved searches and watches, newest first: each one’s state (draft, active, paused, cancelled), cost ceilings, next refresh and last refresh with what changed. Free. Needs an API key; answers for the key’s own organisation only.
get_watchA saved search or watch. One saved search or watch: its targets, frequency, caps, state, cost and its last refresh with the change summary. For a page "watch:<id>", call this first. Free. Needs an API key; answers for the key’s own organisation only.
list_watch_runsA watch’s refreshes. One saved search’s refreshes, newest first: each one’s state (or why it was skipped), what it charged and what changed since the one before. Use it to explain a watch's last check. Free. Needs an API key; answers for the key’s own organisation only.
create_watchDraft a watch. Saves a watch (kind watch, with a frequency) or a saved search (kind search, none) as a DRAFT and estimates its cost. It spends nothing and reads nothing: the user activates it, confirming its cost ceilings once, on the watch's page. Needs an API key; answers for the key’s own organisation only.
update_watchChange a watch. Changes a saved search or watch. Changing its targets, rows per target, frequency or caps returns an active one to draft (the user confirms the new cost on its page); a name or notify change does not. Spends nothing. Needs an API key; answers for the key’s own organisation only.
refresh_watchRefresh a watch now. Refreshes one ACTIVE saved search or watch now: reads each target and is charged like a listings read, never above its per-refresh cap or what is left of its monthly cap (rows are cut to fit). A draft or paused one is recorded as skipped and charges nothing. Needs an API key; answers for the key’s own organisation only.
Where alerts are sent.
list_notification_destinationsAlert destinations. Where the organisation’s watch alerts can go: each email, Slack, Telegram or webhook destination with its id (for a watch's notify), status and last error. Free. Needs an API key; answers for the key’s own organisation only.
create_notification_destinationAdd an alert destination. Adds a place watch alerts can go. slack: an incoming webhook URL (https://hooks.slack.com/services/...). webhook: an https URL; the answer carries its signing secret once. telegram: no URL; the answer has the link to press Start with. email: no URL, the signed-in user’s own verified address (a session only). Free. Needs an API key; answers for the key’s own organisation only.
test_notification_destinationSend a test alert. Sends a short test message to one destination and answers its new status (working, or failing with lastError). A Telegram chat not linked yet is linked first. Free. Needs an API key; answers for the key’s own organisation only.
Each tool is one call to the Rewalto API, with the same permissions, credit rates and quote and approval steps as the API, the CLI and the dashboard. Calling the tool list is free and needs no key. A tool marked as spending credits charges only for data delivered, at the published rate, and each answer says what it charged. A run that delivers nothing costs nothing. See pricing and credits and receipts.