Capzy Platforms / google
google toolset
61 tools. Mount this server and your agent gets every google endpoint, fully typed.
claude mcp add capzy-google --transport http https://mcp.capzy.ai/google/mcp \ --header "Authorization: Bearer YOUR_KEY"
Ads
google_ads
1 credit
Ads
The sponsored results shown on a Google search page for a query: the top-of-page and bottom-of-page ad blocks, each with headline, destination and displayed link, description, and sitelinks.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search query the ads are shown for (parameter q). |
gl |
string | optional | Two-letter country code for the search origin, e.g. us, gb, de. Default: us |
hl |
string | optional | Two-letter UI language code, e.g. en, es, fr. Default: en |
location |
string | optional | Location to search from as free text, e.g. 'Austin, Texas'. |
device |
string | optional | Device to emulate: desktop, mobile, or tablet. Default: desktop |
google_domain |
string | optional | Google domain to use, e.g. google.com, google.co.uk. Default: google.com |
google_ads_transparency
1 credit
not yet verified
Ads Transparency
Ad creatives a verified advertiser has run, from the Google Ads Transparency Center: the creative id, advertiser, format (text, image, or video), target domain, and first/last-shown dates.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | optional | Advertiser name or target domain to search for, e.g. 'tesla.com'. Provide this or advertiser_id. |
advertiser_id |
string | optional | Advertiser id to list creatives for, e.g. AR17828074650563772417. |
creative_id |
string | optional | Look up a single creative by id, e.g. CR06172042294124871681. |
region |
string | optional | Region filter, e.g. US, GB, anywhere. Default: anywhere |
format |
string | optional | Creative format filter: text, image, or video. |
platform |
string | optional | Surface filter: search, display, maps, shopping, play, youtube. |
gl |
string | optional | Two-letter country code for the request origin. Default: us |
Books
google_book
1 credit
Book Detail
Full volume detail by Google Books id.
| Param | Type | Required | Description |
|---|---|---|---|
volume_id |
string | required | Google Books volume id. |
google_books
1 credit
Books Search
Search Google Books volumes (official API).
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search text; supports isbn:, intitle:, inauthor:. |
page |
integer | optional | Page number (20 per page). Default: 1 |
lang |
string | optional | Restrict to a language, e.g. en. |
Finance
google_finance
1 credit
Finance Quote
Stock, index, crypto, currency quotes.
| Param | Type | Required | Description |
|---|---|---|---|
symbol |
string | required | e.g. AAPL:NASDAQ, BTC-USD. A bare ticker (AAPL) defaults to :NASDAQ. |
google_finance_markets
1 credit
Finance Markets
Market movers and indexes: index list, top gainers, losers, most active, climate leaders, cryptocurrencies.
| Param | Type | Required | Description |
|---|---|---|---|
market |
string | optional | Which board to pull. Default: indexes |
Hotels
google_hotels_details
1 credit
not yet verified
Hotel Details
Detailed property information: rating, reviews, address, class, price and amenities.
| Param | Type | Required | Description |
|---|---|---|---|
hotel_id |
string | required | Google Travel hotel entity id/slug. |
check_in |
string | optional | Check-in date, YYYY-MM-DD. |
check_out |
string | optional | Check-out date, YYYY-MM-DD. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_hotels_search
1 credit
Hotels Search
Hotel search for a destination (Google Travel): price, rating, reviews, class, thumbnail.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Destination, e.g. 'New York'. |
check_in |
string | optional | Check-in date, YYYY-MM-DD. |
check_out |
string | optional | Check-out date, YYYY-MM-DD. |
adults |
integer | optional | Number of adult guests. Default: 2 |
currency |
string | optional | Currency code for prices, e.g. USD, EUR. Default: USD |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
page |
integer | optional | Page number. Default: 1 |
Jobs
google_jobs
1 credit
Jobs Search
Job listings aggregated across the web with company, location and source.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Job title / keywords, e.g. 'software engineer'. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
location |
string | optional | Location to search from, e.g. 'Austin, Texas'. |
uds |
string | optional | Google Jobs filter chip token (uds), passed straight through. |
page |
integer | optional | Page number. Default: 1 |
Local
google_local
1 credit
Local Results
Google local business pack (tbm=lcl).
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search text, e.g. coffee shops chicago. |
gl |
string | optional | Country, e.g. us. |
hl |
string | optional | Language. |
page |
integer | optional | Page number (20 per page). Default: 1 |
google_local_services
1 credit
Local Services
Local Services provider ads for a service category (the screened / guaranteed provider pack): business name, rating, reviews, category, phone, service area and years in business.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Service query, e.g. 'plumbers austin' or 'house cleaning'. |
job_type |
string | optional | Service subcategory to refine by, e.g. 'Drain cleaning'. |
data_cid |
string | optional | Google CID that scopes the search to a specific city / area. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
page |
integer | optional | Page number (20 per page). Default: 1 |
Maps
google_maps_autocomplete
1 credit
Maps Autocomplete
Place and query suggestions for a prefix typed into the Maps search box.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Prefix to complete, e.g. 'coffee'. |
ll |
string | optional | Latitude,longitude to bias suggestions, e.g. '@40.7455,-74.0083,14z'. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_maps_contributor_reviews
1 credit
not yet verified
Contributor Reviews
Reviews written by a single Maps contributor, with the place each review is for and the contributor's own stats (points, level, local guide).
| Param | Type | Required | Description |
|---|---|---|---|
contributor_id |
string | required | Google Maps contributor id, e.g. '110382514725174877672'. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
page |
integer | optional | Page number (the profile loads more reviews as it scrolls). Default: 1 |
google_maps_directions
1 credit
Maps Directions
Route options between a start and end place: distance, duration, via road and travel mode. Supports driving, walking, cycling and transit.
| Param | Type | Required | Description |
|---|---|---|---|
start_addr |
string | required | Start address or place name, e.g. 'Space Needle, Seattle'. |
end_addr |
string | required | Destination address or place name. |
travel_mode |
string | optional | Travel mode. Default: driving |
distance_unit |
string | optional | Distance unit. Default: imperial |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_maps_photos
1 credit
not yet verified
Place Photos
Photos for a place from Google Maps.
| Param | Type | Required | Description |
|---|---|---|---|
place_id |
string | required | Google place_id / data_id. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
num |
integer | optional | Max photos to return. Default: 50 |
google_maps_place
1 credit
Place Details
Full place details by place_id (or a name query): rating, reviews, address, phone, website, category, hours.
| Param | Type | Required | Description |
|---|---|---|---|
place_id |
string | optional | Google place_id / data_id. |
query |
string | optional | Place name (used when place_id is not supplied). |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_maps_posts
1 credit
not yet verified
Business Posts
Business 'updates' posts published by a place on its Google Business Profile.
| Param | Type | Required | Description |
|---|---|---|---|
place_id |
string | required | Google place_id / data_id. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_maps_reviews
1 credit
not yet verified
Place Reviews
Reviews for a place. Paginate through ALL reviews with `page` (the render scrolls the reviews panel to load more); `sort` orders them.
| Param | Type | Required | Description |
|---|---|---|---|
place_id |
string | required | Google place_id / data_id. |
sort |
string | optional | Review ordering. Default: most_relevant |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
page |
integer | optional | Page number (each page loads ~10 more reviews as the panel scrolls). Default: 1 |
google_maps_search
1 credit
Maps Search
Search places by query with name, coordinates, rating, reviews and address.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Place / business query, e.g. 'coffee shops seattle'. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
ll |
string | optional | Latitude,longitude to center the search, e.g. '@47.6,-122.3,14z'. |
num |
integer | optional | Max places to return. Default: 40 |
page |
integer | optional | Page number (20 per page). Default: 1 |
Media
google_short_videos
1 credit
Short Videos
Short-form video results for a query (title, source, channel, views, duration).
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search query (parameter q). |
gl |
string | optional | Two-letter country code for the search origin, e.g. us, gb, de. Default: us |
hl |
string | optional | Two-letter UI language code, e.g. en, es, fr. Default: en |
google_domain |
string | optional | Google domain to use, e.g. google.com, google.co.uk, google.de. Default: google.com |
location |
string | optional | Location to search from as free text. Encoded to uule. |
uule |
string | optional | Pre-encoded Google location (uule). Overrides location. |
lr |
string | optional | Language restrict, e.g. lang_en. |
tbs |
string | optional | Advanced filters passed straight to Google. |
safe |
string | optional | Safe search: active or off. |
nfpr |
integer | optional | 1 to disable auto-correction of the spelling. |
filter |
integer | optional | 1 (default) enables Similar/Omitted filters, 0 disables. |
device |
string | optional | Device to emulate: desktop, mobile, or tablet. Default: desktop |
start |
integer | optional | Result offset for pagination. Default: 0 |
page |
integer | optional | Page number. Default: 1 |
News
google_news_search
1 credit
News
Google News articles. Search a query (mode=search), read a section feed (mode=topic), or pull the current top stories (mode=trending).
| Param | Type | Required | Description |
|---|---|---|---|
mode |
string | optional | Surface to read. Default: search |
query |
string | optional | Search query. Required when mode=search. |
topic |
string | optional | For mode=topic: a named section (WORLD, BUSINESS, TECHNOLOGY, SPORTS, SCIENCE, HEALTH, ENTERTAINMENT, NATION) or a raw Google News topic token. Default: WORLD |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_news_topics
1 credit
News Topics
News organized by a section/topic. Accepts a named section (WORLD, BUSINESS, TECHNOLOGY, SPORTS, …) or a raw Google News topic token.
| Param | Type | Required | Description |
|---|---|---|---|
topic |
string | required | Named section (WORLD, BUSINESS, …) or topic token. |
gl |
string | optional | Country code. Default: us |
google_news_trending
1 credit
News Trending
Trending stories from Google News.
| Param | Type | Required | Description |
|---|---|---|---|
gl |
string | optional | Country code. Default: us |
Patents
google_patents_detail
1 credit
not yet verified
Patent Detail
Full patent detail retrieval.
| Param | Type | Required | Description |
|---|---|---|---|
patent_id |
string | required | e.g. US1234567B2, CA3104644C. |
google_patents_search
1 credit
Patents Search
Patent document search (Google Patents JSON API): title, snippet, assignee, inventor, dates and PDF link.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search query. Supports Patents operators (assignee:, inventor:, before:, after:). |
page |
integer | optional | Page number (results per page ~10). Default: 1 |
country |
string | optional | Restrict to a patent office, e.g. US, EP, WO, CN. |
language |
string | optional | Document language, e.g. ENGLISH. |
Play Store
google_play_app
1 credit
Play App Detail
Google Play app detail by package id.
| Param | Type | Required | Description |
|---|---|---|---|
app_id |
string | required | App package id, e.g. com.spotify.music. |
gl |
string | optional | Country, e.g. us. |
hl |
string | optional | Language, e.g. en. |
google_play_books
1 credit
Play Books Search
Search Google Play Books by keyword.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search keywords. |
page |
integer | optional | Page number. Default: 1 |
gl |
string | optional | Country, e.g. us. |
hl |
string | optional | Language, e.g. en. |
google_play_games
1 credit
Play Games
Browse the Google Play Games store: the game titles listed on the games home or a category grid, with title, developer, rating, and store link for each game.
| Param | Type | Required | Description |
|---|---|---|---|
category |
string | optional | Games category id, e.g. GAME_ACTION, GAME_PUZZLE, GAME_ROLE_PLAYING. Omit for the games home listing. |
chart |
string | optional | Top chart to request, e.g. topselling_free, topgrossing, topselling_new_free, movers_shakers. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | Two-letter language code, e.g. en, es, fr. Default: en |
google_play_movies
1 credit
Play Movies Search
Search Google Play Movies and TV by keyword.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search keywords. |
page |
integer | optional | Page number. Default: 1 |
gl |
string | optional | Country, e.g. us. |
hl |
string | optional | Language, e.g. en. |
google_play_search
1 credit
Play App Search
Search Google Play apps by keyword.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search keywords. |
gl |
string | optional | Country, e.g. us. |
hl |
string | optional | Language, e.g. en. |
Scholar
google_scholar
1 credit
Scholar Search
Academic paper search.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search query. Supports Scholar operators (author:, source:, intitle:). |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
as_ylo |
integer | optional | Only results from this year onward (>=). |
as_yhi |
integer | optional | Only results up to this year (<=). |
scisbd |
integer | optional | 1 to sort by date (newest first). |
num |
integer | optional | Results per page (max 20). Default: 10 |
page |
integer | optional | Page number (each page is `num`). Default: 1 |
google_scholar_author
1 credit
Scholar Author
A Google Scholar author profile: metrics (citations, h-index, i10-index) + their papers.
| Param | Type | Required | Description |
|---|---|---|---|
author_id |
string | required | Scholar author id — the `user=` value in a profile URL, e.g. JicYPdAAAAAJ. |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
page |
integer | optional | Page of publications (20 per page). Default: 1 |
google_scholar_case_law
1 credit
Scholar Case Law
Search court opinions and case law on Google Scholar.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Case name or legal query. |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
as_ylo |
integer | optional | Only opinions from this year onward (>=). |
as_yhi |
integer | optional | Only opinions up to this year (<=). |
page |
integer | optional | Page number. Default: 1 |
Search
google_events
1 credit
Events
Google events results for a query: title, date, venue address, ticket links and thumbnail.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Events query, e.g. 'concerts in austin' or 'events near me'. |
location |
string | optional | Free-text location to search from, e.g. 'Austin, TX'. |
htichips |
string | optional | Filter chips, e.g. 'date:week' or 'event_type:Virtual-Event'. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
page |
integer | optional | Page number (10 per page). Default: 1 |
google_forums
1 credit
Forums
Forum and discussion threads for a query (Reddit, Quora, and similar).
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search query (parameter q). |
gl |
string | optional | Two-letter country code for the search origin, e.g. us, gb, de. Default: us |
hl |
string | optional | Two-letter UI language code, e.g. en, es, fr. Default: en |
google_domain |
string | optional | Google domain to use, e.g. google.com, google.co.uk, google.de. Default: google.com |
location |
string | optional | Location to search from as free text. Encoded to uule. |
uule |
string | optional | Pre-encoded Google location (uule). Overrides location. |
period_unit |
string | optional | Time period unit for a recency filter: s, n, h, d, w, m, or y. |
period_value |
integer | optional | Numeric value paired with period_unit. |
start_date |
string | optional | Start date for a custom range, YYYYMMDD. |
end_date |
string | optional | End date for a custom range, YYYYMMDD. |
tbs |
string | optional | Advanced filters passed straight to Google. |
nfpr |
integer | optional | 1 to disable auto-correction of the spelling. |
filter |
integer | optional | 1 (default) enables Similar/Omitted filters, 0 disables. |
device |
string | optional | Device to emulate: desktop, mobile, or tablet. Default: desktop |
start |
integer | optional | Result offset for pagination. Default: 0 |
page |
integer | optional | Page number. Default: 1 |
google_related_questions
1 credit
not yet verified
Related Questions
People also ask questions and their inline answers for a query.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search query (parameter q) whose People also ask block to return. |
next_page_token |
string | optional | Token from a prior response to expand a specific question's nested questions. Best-effort: nested expansion is behavior-gated. |
gl |
string | optional | Two-letter country code for the search origin, e.g. us, gb, de. Default: us |
hl |
string | optional | Two-letter UI language code, e.g. en, es, fr. Default: en |
google_domain |
string | optional | Google domain to use, e.g. google.com, google.co.uk, google.de. Default: google.com |
location |
string | optional | Location to search from as free text. Encoded to uule. |
uule |
string | optional | Pre-encoded Google location (uule). Overrides location. |
device |
string | optional | Device to emulate: desktop, mobile, or tablet. Default: desktop |
google_reverse_image
1 credit
Reverse Image Search
Find the pages that host or reference an image by its URL.
| Param | Type | Required | Description |
|---|---|---|---|
image_url |
string | required | URL of the image to run the reverse search on. |
gl |
string | optional | Two-letter country code for the search origin, e.g. us, gb, de. Default: us |
hl |
string | optional | Two-letter UI language code, e.g. en, es, fr. Default: en |
google_domain |
string | optional | Google domain to use, e.g. google.com, google.co.uk, google.de. Default: google.com |
location |
string | optional | Location to search from as free text, e.g. 'Austin, Texas'. Encoded to uule. |
uule |
string | optional | Pre-encoded Google location (uule). Overrides location. |
lr |
string | optional | Language restrict, e.g. lang_en. Limits results to given languages. |
safe |
string | optional | Safe search: active or off. |
tbs |
string | optional | Advanced filters passed straight to Google. |
device |
string | optional | Device to emulate: desktop, mobile, or tablet. Default: desktop |
start |
integer | optional | Result offset for pagination (0, 10, 20, ...). Default: 0 |
page |
integer | optional | Page number (each page is ~10 results). Default: 1 |
google_sports
1 credit
Sports
Live scores panel Google shows above the results for a team, league, or fixture query: the game spotlight, recent and upcoming games, and (for a league) the standings table.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Team, league, or fixture, e.g. 'real madrid', 'nba standings', 'lakers vs celtics'. |
gl |
string | optional | Two-letter country code for the search origin, e.g. us, gb, de. Default: us |
hl |
string | optional | Two-letter UI language code, e.g. en, es, fr. Default: en |
google_domain |
string | optional | Google domain to use, e.g. google.com, google.co.uk. Default: google.com |
Shopping
google_immersive_product
1 credit
not yet verified
Immersive Product
Rich product popup: brand, rating, price range, highlights, stores and user reviews.
| Param | Type | Required | Description |
|---|---|---|---|
page_token |
string | required | Token that identifies the product's immersive popup (from a shopping or search result). |
more_stores |
integer | optional | Set to 1 to fetch the extended stores list instead of the default few. |
next_page_token |
string | optional | Token to fetch the next page of stores for this product. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | Two-letter UI language code, e.g. en, es, fr. Default: en |
google_domain |
string | optional | Google domain to use, e.g. google.com, google.co.uk. Default: google.com |
google_products_detail
1 credit
Immersive Product
Immersive product detail pages.
| Param | Type | Required | Description |
|---|---|---|---|
product_id |
string | required | Google product id (numeric). |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_shopping_click
1 credit
Merchant URL
Resolve a product's merchant URL.
| Param | Type | Required | Description |
|---|---|---|---|
product_id |
string | required | Google product id. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
google_shopping_offers
1 credit
not yet verified
Barcode Offers
Resolve a barcode (GTIN/UPC/EAN) to a product, then return its Shopping seller offers.
| Param | Type | Required | Description |
|---|---|---|---|
barcode |
string | required | GTIN-8 / UPC-A / EAN-13 / GTIN-14. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_shopping_product
1 credit
Shopping Product
Product detail with the seller/offer list, rating, reviews and description.
| Param | Type | Required | Description |
|---|---|---|---|
product_id |
string | required | Google product id (numeric). |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_shopping_search
1 credit
Shopping Search
Product listings with prices, merchants, ratings, reviews and thumbnails.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search query (parameter q). |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
tbs |
string | optional | Shopping filters (price range, condition), passed to Google. |
device |
string | optional | Device to emulate: desktop, mobile, or tablet. Default: desktop |
num |
integer | optional | Number of results per page. Default: 40 |
page |
integer | optional | Page number. Default: 1 |
Travel
google_flights
1 credit
not yet verified
Flights
Flight itineraries for a route: best and other options with airline, times, duration, layovers, carbon estimate and price.
| Param | Type | Required | Description |
|---|---|---|---|
departure_id |
string | required | Departure airport code or location id, e.g. 'JFK' or 'CDG'. |
arrival_id |
string | required | Arrival airport code or location id, e.g. 'AUS' or 'LAX'. |
outbound_date |
string | optional | Outbound date, YYYY-MM-DD. |
return_date |
string | optional | Return date, YYYY-MM-DD (round trips). |
type |
integer | optional | Trip type: 1 round trip, 2 one way, 3 multi-city. Default: 1 |
travel_class |
integer | optional | Cabin: 1 economy, 2 premium economy, 3 business, 4 first. Default: 1 |
adults |
integer | optional | Number of adult passengers. Default: 1 |
children |
integer | optional | Number of children. Default: 0 |
infants_in_seat |
integer | optional | Infants in seat. Default: 0 |
infants_on_lap |
integer | optional | Infants on lap. Default: 0 |
stops |
integer | optional | Max stops: 0 any, 1 nonstop, 2 up to 1, 3 up to 2. |
max_price |
integer | optional | Maximum ticket price. |
currency |
string | optional | Currency code for prices, e.g. USD, EUR. Default: USD |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_flights_autocomplete
1 credit
Flights Autocomplete
Airport and city suggestions for a partial Flights query, with the airports that back each suggested location.
| Param | Type | Required | Description |
|---|---|---|---|
q |
string | required | Partial query to complete, e.g. 'new yor'. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
exclude_regions |
boolean | optional | Set true to drop region-level locations from the results. Default: False |
google_flights_deals
1 credit
not yet verified
Flights Deals
Cheapest flight options for a route ranked by price, with airline, times, duration, stops and price context.
| Param | Type | Required | Description |
|---|---|---|---|
departure_id |
string | required | Departure airport code or location id, e.g. 'JFK' or 'CDG'. |
arrival_id |
string | required | Arrival airport code or location id, e.g. 'AUS' or 'LAX'. |
outbound_date |
string | optional | Outbound date, YYYY-MM-DD. |
return_date |
string | optional | Return date, YYYY-MM-DD (round trips). |
type |
integer | optional | Trip type: 1 round trip, 2 one way, 3 multi-city. Default: 1 |
travel_class |
integer | optional | Cabin: 1 economy, 2 premium economy, 3 business, 4 first. Default: 1 |
adults |
integer | optional | Number of adult passengers. Default: 1 |
children |
integer | optional | Number of children. Default: 0 |
stops |
integer | optional | Max stops: 0 any, 1 nonstop, 2 up to 1, 3 up to 2. |
max_price |
integer | optional | Maximum ticket price. |
currency |
string | optional | Currency code for prices, e.g. USD, EUR. Default: USD |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_hotels_autocomplete
1 credit
Hotels Autocomplete
Destination and property suggestions for a partial Hotels query, with the location and identifiers for each suggestion.
| Param | Type | Required | Description |
|---|---|---|---|
q |
string | required | Partial query to complete, e.g. 'new york hot'. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
currency |
string | optional | Currency code, e.g. USD, EUR. Default: USD |
google_hotels_photos
1 credit
not yet verified
Hotels Photos
Photos for a hotel property with a thumbnail, the full-size image and a category for each shot.
| Param | Type | Required | Description |
|---|---|---|---|
property_token |
string | required | Property token that identifies the hotel (from Hotels Search). |
category_id |
string | optional | Filter photos to a single category id. |
next_page_token |
string | optional | Page cursor returned by a previous call. |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
google_hotels_reviews
1 credit
not yet verified
Hotels Reviews
Guest reviews for a hotel property with author, rating, date, title, text, likes and the property response, under a place header.
| Param | Type | Required | Description |
|---|---|---|---|
property_token |
string | required | Property token that identifies the hotel (from Hotels Search). |
sort_by |
integer | optional | Sort: 1 most helpful, 2 most recent, 3 highest, 4 lowest. |
rating |
integer | optional | Filter to reviews with this star rating, 1-5. |
category_token |
string | optional | Filter reviews by a review category token. |
source_number |
integer | optional | Filter by review source: 0 all, -1 Google, or a source id. |
next_page_token |
string | optional | Page cursor returned by a previous call. |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
google_travel_explore
1 credit
Travel Explore
Destination ideas from a departure airport with a sample fare, flight time, stops and airline for each place.
| Param | Type | Required | Description |
|---|---|---|---|
departure_id |
string | required | Departure airport code or location id, e.g. 'CDG' or 'JFK'. |
arrival_id |
string | optional | Optional arrival area or location id to narrow the map. |
outbound_date |
string | optional | Outbound date, YYYY-MM-DD. |
return_date |
string | optional | Return date, YYYY-MM-DD. |
type |
integer | optional | Trip type: 1 round trip, 2 one way, 3 multi-city. Default: 1 |
month |
integer | optional | Month of travel 1-12, or 0 for any. |
travel_duration |
integer | optional | Trip length: 1 weekend, 2 one week, 3 two weeks. |
travel_class |
integer | optional | Cabin: 1 economy, 2 premium economy, 3 business, 4 first. Default: 1 |
adults |
integer | optional | Number of adult passengers. Default: 1 |
children |
integer | optional | Number of children. Default: 0 |
stops |
integer | optional | Max stops: 0 any, 1 nonstop, 2 up to 1, 3 up to 2. |
max_price |
integer | optional | Maximum ticket price. |
currency |
string | optional | Currency code for prices, e.g. USD, EUR. Default: USD |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
Trends
google_trending_now
1 credit
Trending Now
Real-time trending searches for a locale: the queries trending right now with their approximate search volume, the news headlines behind each trend, and any category tags.
| Param | Type | Required | Description |
|---|---|---|---|
geo |
string | optional | Two-letter country code for the locale, e.g. US, GB, DE, IN. Default: US |
hours |
integer | optional | Trailing window in hours to consider a trend active: 4, 24, 48, or 168. Default: 24 |
category_id |
integer | optional | Filter to a Trends category id (e.g. 17 sports, 18 technology, 3 entertainment). Omit for all categories. |
only_active |
boolean | optional | Return only trends still rising (true) or include ended trends (false). Default: True |
google_trends
1 credit
Trends
Google Trends. data_type=interest_over_time (default) returns the interest series plus related queries & topics for `query`; data_type=trending_now returns the current daily trending searches for a locale (no query needed).
| Param | Type | Required | Description |
|---|---|---|---|
data_type |
string | optional | What to pull. Default: interest_over_time |
query |
string | optional | Search term (required for data_type=interest_over_time). |
gl |
string | optional | Geo (country code, e.g. US, GB, DE). Default: US |
timeframe |
string | optional | Range for interest_over_time, e.g. 'today 12-m', 'today 5-y', 'now 7-d'. Default: today 12-m |
google_trends_autocomplete
1 credit
Trends Autocomplete
Knowledge Graph topic autocomplete.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Term. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_trends_now
1 credit
Trending Now
Current daily trending searches with approximate traffic and a top related news story (Google Trends RSS feed).
| Param | Type | Required | Description |
|---|---|---|---|
gl |
string | optional | Geo (country code). Default: US |
Web
google_ai_mode
1 credit
AI Mode
Google's generative AI answer (udm=50): the answer text blocks, the cited source links, and the follow-up question chips.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Question / query (parameter q). |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_domain |
string | optional | Google domain to use, e.g. google.com, google.co.uk, google.de. Default: google.com |
device |
string | optional | Device to emulate: desktop, mobile, or tablet. Default: desktop |
google_autocomplete
1 credit
Autocomplete
Query suggestions for a prefix.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Prefix to complete. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_images
1 credit
Image Search
Image search results with source page + title.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search query (parameter q). |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_domain |
string | optional | Google domain to use, e.g. google.com, google.co.uk, google.de. Default: google.com |
tbs |
string | optional | Image filters, e.g. isz:l (large), ic:trans, itp:photo. |
safe |
string | optional | Safe search: active or off. |
num |
integer | optional | Max images to return. Default: 100 |
page |
integer | optional | Page number (each page ~100 images). Default: 1 |
google_lens
1 credit
Lens Search
Visual search: find visual matches and similar products/pages for an image URL.
| Param | Type | Required | Description |
|---|---|---|---|
url |
string | required | Image URL to search by. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
google_videos
1 credit
Video Search
Video search across Google's video index (platform, channel, duration, date).
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search query. |
gl |
string | optional | Two-letter country code, e.g. us, gb, de. Default: us |
hl |
string | optional | UI language, e.g. en, es, fr. Default: en |
tbs |
string | optional | Filters, e.g. dur:l (long), qdr:w (past week). |
safe |
string | optional | Safe search: active or off. |
num |
integer | optional | Number of results per page. Default: 10 |
page |
integer | optional | Page number. Default: 1 |
google_web_search
1 credit
Web Search
Web SERP with organic results.
| Param | Type | Required | Description |
|---|---|---|---|
query |
string | required | Search query (parameter q). |
gl |
string | optional | Two-letter country code for the search origin, e.g. us, gb, de. Default: us |
hl |
string | optional | Two-letter UI language code, e.g. en, es, fr. Default: en |
google_domain |
string | optional | Google domain to use, e.g. google.com, google.co.uk, google.de. Default: google.com |
location |
string | optional | Location to search from as free text, e.g. 'Austin, Texas'. Encoded to uule. |
uule |
string | optional | Pre-encoded Google location (uule). Overrides location. |
lr |
string | optional | Language restrict, e.g. lang_en. Limits results to given languages. |
cr |
string | optional | Country restrict, e.g. countryUS. Limits results to given countries. |
tbs |
string | optional | Advanced filters (time range, verbatim), passed straight to Google. |
safe |
string | optional | Safe search: active or off. |
nfpr |
integer | optional | 1 to disable auto-correction of the spelling. |
filter |
integer | optional | 1 (default) enables 'Similar/Omitted' filters, 0 disables them. |
num |
integer | optional | Number of results to return (max 100). Default: 10 |
device |
string | optional | Device to emulate: desktop, mobile, or tablet. Default: desktop |
page |
integer | optional | Page number (each page is `num` results). Default: 1 |
output |
string | optional | Response format: json (default), html (raw page), or md (markdown for LLMs). Default: json |
json_restrictor |
string | optional | Comma-separated fields to keep in the response, e.g. 'organic_results,pagination'. |
Fewer tools?
The aggregate server at https://mcp.capzy.ai/mcp reaches this platform through 5 discovery meta-tools, and https://mcp.capzy.ai/search/mcp carries just each platform's primary search.