Tools
MCP GClimb tools, their parameters and their credit cost. Your assistant only sees the tools open to your account: a closed tool does not show up.
lookup
Cost: FreeResolves a brand name, a domain or a page URL into stores of the GClimb index (shop_id, domain, name, country). Call it first when the user names a store: the other tools take a shop_id. Searches every country; at most 5 results.
| Parameter | Type | Required | Description |
|---|---|---|---|
| q | string | yes | Brand, domain (store.com) or URL (https://…). |
search_shops
Cost: 1 credit per row returned (at most 25 per call)Lists the e-commerce stores of the GClimb index for a country, with estimated visits, Google ads (active, launched over 7 and 30 days) and niche. Filters: niche, name or domain, thresholds. Sort “new_30d” = stores that launched the most ads over 30 days.
| Parameter | Type | Required | Description |
|---|---|---|---|
| country | string | yes | Country code.FR, US, UK, DE, ES, IT, NL, BE, CA |
| query | string | no | Store name or domain (searches every country). |
| niche | string | no | Niche slug (list_niches). |
| sort | string | no | Sort order.active, new_30d, visits, growth, niche_volume, traffic_value, avg_cpc, main_keyword_volume, products, created |
| min_visits | integer | no | Minimum estimated monthly visits. |
| min_new_30d | integer | no | Minimum ads launched over 30 days. |
| min_active | integer | no | Minimum active ads. |
| page | integer | no | Page (default 1).1–40 |
| per_page | integer | no | Rows per page.1–25 |
get_shop
Cost: 5 credits per callFull profile of a store: products, best sellers, apps and pixels, social networks, customer reviews, visits and Google ads by country (launch pace over 12 weeks), niche and main keywords (when country is given).
| Parameter | Type | Required | Description |
|---|---|---|---|
| shop_id | string | yes | Store identifier (lookup or search_shops). |
| country | string | no | Country code.FR, US, UK, DE, ES, IT, NL, BE, CA |
get_shop_ads
Cost: 1 credit per row returned (at most 36 per call)Google ads of a store, most recently shown first: format, type (Shopping, Search…), title, price, first and last seen dates, estimated impressions by EU country when measured. 36 ads per page; next_cursor gives the next page.
| Parameter | Type | Required | Description |
|---|---|---|---|
| shop_id | string | yes | Store identifier (lookup or search_shops). |
| country | string | no | Country code.FR, US, UK, DE, ES, IT, NL, BE, CA |
| cursor | string | no | next_cursor from the previous page. |
search_ads
Cost: 1 credit per row returned (at most 36 per call)Library of Google ads shown in an EU country (FR, DE, ES, IT, NL, BE), all stores together. Sort: last, first, shown, running. Filters: niche, format, active ads, minimum running time. 36 per page.
| Parameter | Type | Required | Description |
|---|---|---|---|
| country | string | yes | Country code.FR, DE, ES, IT, NL, BE |
| sort | string | no | Sort order.last, first, shown, running |
| niche | string | no | Niche slug (list_niches). |
| format | string | no | Ad format.text, image, video |
| active_only | boolean | no | Only ads shown in the last few days. |
| min_days | integer | no | Minimum running time, in days.1–3650 |
| cursor | string | no | next_cursor from the previous page. |
list_niches
Cost: FreeLists the e-commerce niches GClimb follows in a country, with total monthly search volume, median CPC and number of keywords. The slug filters search_shops, search_ads and get_niche.
| Parameter | Type | Required | Description |
|---|---|---|---|
| country | string | yes | Country code.FR, US, UK, DE, ES, IT, NL, BE, CA |
get_niche
Cost: 5 credits per callProfile of a niche in a country: search volume, median CPC and bids, competition, purchase intent share, trend and seasonality, measured keywords and the stores that capture the most traffic. Amounts in the country’s currency.
| Parameter | Type | Required | Description |
|---|---|---|---|
| slug | string | yes | Niche slug (list_niches). |
| country | string | yes | Country code.FR, US, UK, DE, ES, IT, NL, BE, CA |
get_shop_keywords
Cost: 1 credit per row returned (at most 100 per call)Google keywords that bring organic traffic to a store in a country: volume, CPC, position, estimated traffic. measured = false: not measured yet for this country. Paginated with page and per_page.
| Parameter | Type | Required | Description |
|---|---|---|---|
| shop_id | string | yes | Store identifier (lookup or search_shops). |
| country | string | yes | Country code.FR, US, UK, DE, ES, IT, NL, BE, CA |
| page | integer | no | Page (default 1).1–100 |
| per_page | integer | no | Rows per page.1–100 |
get_shop_ad_keywords
Cost: 1 credit per row returned (at most 25 per call)Google searches where a store was seen, by family: organic results, Search ads, Shopping ads (best position, first and last seen), with each search’s volume and CPC.
| Parameter | Type | Required | Description |
|---|---|---|---|
| shop_id | string | yes | Store identifier (lookup or search_shops). |
| country | string | yes | Country code.FR, US, UK, DE, ES, IT, NL, BE, CA |
similar_shops
Cost: 1 credit per row returned (at most 25 per call)Stores close to a store of the index (neighbouring catalogue and positioning, every country), with estimated visits, active ads and main keyword.
| Parameter | Type | Required | Description |
|---|---|---|---|
| shop_id | string | yes | Store identifier (lookup or search_shops). |
my_watchlist
Cost: 1 credit per row returned (at most 100 per call)The competitors your account follows: active ads, ads launched over 30 days (by week), estimated traffic and trend, Shopping / Search share, number of products.
No parameters.
compare_competitors
Cost: 1 credit per row returned (at most 5 per call)Compares 2 to 5 followed competitors side by side (by shop_id or domain): active ads, ads launched over 30 days, estimated traffic and trend, Shopping / Search share, number of products.
| Parameter | Type | Required | Description |
|---|---|---|---|
| shops | array | yes | shop_id or domains of the followed competitors to compare.2 to 5 items |
watch_activity
Cost: 1 credit per row returned (at most 60 per call)What your followed competitors did over a period, day by day: ads launched (titles and prices), new products, price changes, estimated traffic changes.
| Parameter | Type | Required | Description |
|---|---|---|---|
| period | string | no | Period. Default: 7d.24h, 7d, 14d, 30d |
watch_products
Cost: 1 credit per row returned (at most 50 per call)Products your followed competitors push in Shopping ads: the most shown and the new ones over the period (title, price, number of ads, dates).
| Parameter | Type | Required | Description |
|---|---|---|---|
| days | integer | no | Period in days. Default: 7.7, 14, 30 |
my_markets
Cost: 1 credit per row returned (at most 25 per call)The niches your account follows, with their latest snapshot: stores in the niche, stores advertising, new stores, search volume, growing stores and most shown ads.
No parameters.
my_audits
Cost: 1 credit per row returned (at most 25 per call)Your latest Merchant Center audits: audited site, date, status, score out of 100, number of blocking issues.
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | no | Number of audits (default 10).1–20 |
get_quotas
Cost: FreeWhat your GClimb account has left this month: MCP credits (used, remaining, limit), audits, keyword searches, followed stores, followed niches, and the reset date.
No parameters.