Free web search, 130M+ business records, local search, weather and travel data for AI agents.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Get a free API key at https://agentweb.live/#signup. No credit card required.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Get this agent's implicit favorites: businesses it interacted with more than once, by frequency.
Max favorites (default: 20, max: 100)
Get this agent's implicit favorites: businesses it interacted with more than once, by frequency.
| Argument | Type | Description |
|---|---|---|
| limit | number | Max favorites (default: 20, max: 100) |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 20,
"description": "Max favorites (default: 20, max: 100)"
}
}
}Retrieve this agent's interaction history: every business it searched for, viewed, or contributed to. Persists 90 days, up to 500 interactions. Recall past lookups without re-searching.
| Argument | Type | Description |
|---|---|---|
| limit | number | Max entries (default: 50, max: 500) |
| offset | number | Skip N entries (default: 0) |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 50,
"description": "Max entries (default: 50, max: 500)"
},
"offset": {
"type": "number",
"default": 0,
"description": "Skip N entries (default: 0)"
}
}
}Get this agent's identity and stats: API key info, tier, contribution count, request totals, remembered interactions.
No arguments.
{
"type": "object",
"properties": {}
}Get the machine-readable description of the entire AgentWeb API: every endpoint, tool, data source, and current live counts. Use to discover what AgentWeb can do.
No arguments.
{
"type": "object",
"properties": {}
}Fetch a business in the AgentWeb compact shorthand format (~320 bytes vs 3-5 KB). Single-letter keys (n=name, p=phone, e=email, w=website, h=hours, g=[lat,lng]…). ~80% fewer tokens. Use when you just need contact info. Schema: https://api.agentweb.live/v1/schema/short
| Argument | Type | Description |
|---|---|---|
| id* | string | The unique business ID from AgentWeb |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The unique business ID from AgentWeb"
}
}
}Check the health status of the AgentWeb API, including total businesses and countries available.
No arguments.
{
"type": "object",
"properties": {}
}Get the public leaderboard of top contributing AI agents (most creates, enrichments, reports).
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of top contributors (default: 10, max: 50) |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"default": 10,
"description": "Number of top contributors (default: 10, max: 50)"
}
}
}Fetch up to 50 businesses in a single call by IDs or slugs. Saves N round-trips. Supports prose (markdown), JSON, and shorthand formats.
| Argument | Type | Description |
|---|---|---|
| ids* | string | Comma-separated business IDs or slugs (max 50) |
| format | string | 'text' (default) markdown; 'json' structured; 'short' compact shorthand. |
{
"type": "object",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "string",
"description": "Comma-separated business IDs or slugs (max 50)"
},
"format": {
"enum": [
"text",
"json",
"short"
],
"type": "string",
"default": "text",
"description": "'text' (default) markdown; 'json' structured; 'short' compact shorthand."
}
}
}Contribute a new business to AgentWeb, OR enrich an existing one with missing data (phone, email, website, hours, address). Deduplicates automatically: same name within 100m, or a matching phone, merges into the existing record. Use whenever you find structured business data AgentWeb doesn't have yet.
| Argument | Type | Description |
|---|---|---|
| lat | number | Latitude (recommended for accurate dedup) |
| lng | number | Longitude (recommended for accurate dedup) |
| name* | string | Business name (required, min 2 chars) |
| string | Business email address | |
| hours | object | Opening hours (e.g. { monday: '09:00-17:00', ... }) |
| phone | string | Phone number (any format; will be cleaned) |
| address | object | Address fields: { street, city, postcode, country, full } |
| website | string | Business website URL |
| category | string | Business category, e.g. 'restaurant', 'dentist', 'hotel' |
| country_code | string | ISO 3166-1 alpha-2 country code, e.g. 'US', 'DE' |
{
"type": "object",
"required": [
"name"
],
"properties": {
"lat": {
"type": "number",
"description": "Latitude (recommended for accurate dedup)"
},
"lng": {
"type": "number",
"description": "Longitude (recommended for accurate dedup)"
},
"name": {
"type": "string",
"description": "Business name (required, min 2 chars)"
},
"email": {
"type": "string",
"description": "Business email address"
},
"hours": {
"type": "object",
"description": "Opening hours (e.g. { monday: '09:00-17:00', ... })"
},
"phone": {
"type": "string",
"description": "Phone number (any format; will be cleaned)"
},
"address": {
"type": "object",
"properties": {
"city": {
"type": "string"
},
"full": {
"type": "string"
},
"street": {
"type": "string"
},
"country": {
"type": "string"
},
"postcode": {
"type": "string"
}
},
"description": "Address fields: { street, city, postcode, country, full }"
},
"website": {
"type": "string",
"description": "Business website URL"
},
"category": {
"type": "string",
"description": "Business category, e.g. 'restaurant', 'dentist', 'hotel'"
},
"country_code": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code, e.g. 'US', 'DE'"
}
}
}Convert between currencies using live ECB exchange rates. 30+ currencies. Returns converted amount and rate. ~0.5s.
| Argument | Type | Description |
|---|---|---|
| to* | string | Target currency code (e.g. 'EUR', 'JPY') |
| from* | string | Source currency code (e.g. 'USD', 'EUR') |
| amount* | number | Amount to convert |
{
"type": "object",
"required": [
"amount",
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"description": "Target currency code (e.g. 'EUR', 'JPY')"
},
"from": {
"type": "string",
"description": "Source currency code (e.g. 'USD', 'EUR')"
},
"amount": {
"type": "number",
"description": "Amount to convert"
}
}
}Retrieve an exact evidence passage and its immutable capture metadata. Evidence is scoped to this application's user/workspace and retained for seven days.
| Argument | Type | Description |
|---|---|---|
| evidence_id* | string |
{
"type": "object",
"required": [
"evidence_id"
],
"properties": {
"evidence_id": {
"type": "string"
}
}
}Execute a public recipe discovered with list_recipes. Pass its exact domain, recipe_name and named params. Covers all public recipes, including those without a dedicated tool. Upstream errors are returned as tool errors. Authentication follows the selected recipe.
| Argument | Type | Description |
|---|---|---|
| domain* | string | Catalog key, e.g. news, holidays, wikipedia.org or amazon.com |
| params* | object | Named parameters from list_recipes. Do not include authentication credentials. |
| recipe_name* | string | Recipe name, e.g. search, list or search_products |
{
"type": "object",
"required": [
"domain",
"recipe_name",
"params"
],
"properties": {
"domain": {
"type": "string",
"description": "Catalog key, e.g. news, holidays, wikipedia.org or amazon.com"
},
"params": {
"type": "object",
"description": "Named parameters from list_recipes. Do not include authentication credentials.",
"additionalProperties": {
"type": [
"string",
"number",
"boolean"
]
}
},
"recipe_name": {
"type": "string",
"description": "Recipe name, e.g. search, list or search_products"
}
}
}Search FlixBus bus and train routes between cities in Europe. Returns prices, times, duration, transfers, booking links. ~1s.
| Argument | Type | Description |
|---|---|---|
| to* | string | Destination city (e.g. 'Berlin', 'Rome') |
| date* | string | Travel date YYYY-MM-DD |
| from* | string | Origin city (e.g. 'Copenhagen', 'Berlin') |
| sort | string | Sort (default: cheapest) |
| limit | number | Max results (default: 10) |
| adults | number | Passengers (default: 1) |
{
"type": "object",
"required": [
"from",
"to",
"date"
],
"properties": {
"to": {
"type": "string",
"description": "Destination city (e.g. 'Berlin', 'Rome')"
},
"date": {
"type": "string",
"description": "Travel date YYYY-MM-DD"
},
"from": {
"type": "string",
"description": "Origin city (e.g. 'Copenhagen', 'Berlin')"
},
"sort": {
"enum": [
"cheapest",
"fastest",
"earliest"
],
"type": "string",
"default": "cheapest",
"description": "Sort (default: cheapest)"
},
"limit": {
"type": "number",
"default": 10,
"description": "Max results (default: 10)"
},
"adults": {
"type": "number",
"default": 1,
"description": "Passengers (default: 1)"
}
}
}Fetch a single business by slug or UUID. Returns markdown prose by default (~60% fewer tokens than JSON). Slugs look like 'noma-copenhagen-abc12345'. Use when you already have an identifier from a previous search. Set format='json' for structured data.
| Argument | Type | Description |
|---|---|---|
| id* | string | Business slug (e.g. 'noma-copenhagen-abc12345') or UUID. Slugs preferred. |
| format | string | 'text' (default) markdown prose; 'json' structured JSON. |
{
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "Business slug (e.g. 'noma-copenhagen-abc12345') or UUID. Slugs preferred."
},
"format": {
"enum": [
"text",
"json"
],
"type": "string",
"default": "text",
"description": "'text' (default) markdown prose; 'json' structured JSON."
}
}
}Search flights on Kiwi.com: aggregates all airlines, often cheaper than airline sites. Returns prices, airlines, times, stops, duration, booking links. ~1.5s.
| Argument | Type | Description |
|---|---|---|
| to* | string | Destination airport IATA code |
| from* | string | Origin airport IATA code |
| sort | string | Sort (default: price) |
| cabin | string | Cabin class (default: ECONOMY) |
| limit | number | Max results (default: 10) |
| adults | number | Adult passengers (default: 1) |
| depart* | string | Departure date YYYY-MM-DD |
| return | string | Return date YYYY-MM-DD (omit for one-way) |
{
"type": "object",
"required": [
"from",
"to",
"depart"
],
"properties": {
"to": {
"type": "string",
"description": "Destination airport IATA code"
},
"from": {
"type": "string",
"description": "Origin airport IATA code"
},
"sort": {
"enum": [
"price",
"duration",
"quality"
],
"type": "string",
"default": "price",
"description": "Sort (default: price)"
},
"cabin": {
"enum": [
"ECONOMY",
"BUSINESS",
"FIRST"
],
"type": "string",
"default": "ECONOMY",
"description": "Cabin class (default: ECONOMY)"
},
"limit": {
"type": "number",
"default": 10,
"description": "Max results (default: 10)"
},
"adults": {
"type": "number",
"default": 1,
"description": "Adult passengers (default: 1)"
},
"depart": {
"type": "string",
"description": "Departure date YYYY-MM-DD"
},
"return": {
"type": "string",
"description": "Return date YYYY-MM-DD (omit for one-way)"
}
}
}Discover every public recipe and its parameters, authentication and cache policy. Includes news, holidays, Wikipedia, Amazon products and provider-specific travel. A listed recipe is not a guarantee of upstream availability.
No arguments.
{
"type": "object",
"properties": {}
}Search local businesses from external sources; availability and freshness vary. Returns name, star rating, review count, phone, today's opening hours, website, full address, category, and geo coordinates for each result. Use when you need CURRENT info (today's hours, latest ratings) or when search_businesses doesn't have the business yet. Use for location-based business queries. Results may be cached.
| Argument | Type | Description |
|---|---|---|
| limit | number | Maximum number of results (default: 15) |
| query* | string | What to look for, e.g. 'coffee shops', 'dentist', 'thai restaurant' |
| location | string | City, area, or 'near me': e.g. 'Copenhagen', 'Shibuya Tokyo' |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "number",
"default": 15,
"description": "Maximum number of results (default: 15)"
},
"query": {
"type": "string",
"description": "What to look for, e.g. 'coffee shops', 'dentist', 'thai restaurant'"
},
"location": {
"type": "string",
"description": "City, area, or 'near me': e.g. 'Copenhagen', 'Shibuya Tokyo'"
}
}
}Report a business as closed, having wrong info, or being spam. Three or more 'closed' reports automatically lower its confidence score. Use when you discover a business is permanently closed, has wrong phone/address/hours, is spam, or is a duplicate.
| Argument | Type | Description |
|---|---|---|
| details | string | Optional free-text explanation, max 500 chars |
| business_id* | string | The unique business ID from AgentWeb (required) |
| report_type* | string | Type of issue |
{
"type": "object",
"required": [
"business_id",
"report_type"
],
"properties": {
"details": {
"type": "string",
"description": "Optional free-text explanation, max 500 chars"
},
"business_id": {
"type": "string",
"description": "The unique business ID from AgentWeb (required)"
},
"report_type": {
"enum": [
"closed",
"wrong_phone",
"wrong_address",
"wrong_hours",
"spam",
"duplicate",
"other"
],
"type": "string",
"description": "Type of issue"
}
}
}Request cancellation of an accepted research execution. In-flight usage can remain pending; retrying cancellation does not start new work.
| Argument | Type | Description |
|---|---|---|
| request_id* | string |
{
"type": "object",
"required": [
"request_id"
],
"properties": {
"request_id": {
"type": "string",
"format": "uuid"
}
}
}Get the status, evidence and usage receipt of an accepted research request.
| Argument | Type | Description |
|---|---|---|
| request_id* | string |
{
"type": "object",
"required": [
"request_id"
],
"properties": {
"request_id": {
"type": "string",
"format": "uuid"
}
}
}Search real-time attractions, tours, and activities on booking.com via AgentWeb. Returns name, price, description, rating, duration, free-cancellation, discounts, booking links. ~2s.
| Argument | Type | Description |
|---|---|---|
| date* | string | Date YYYY-MM-DD |
| sort | string | Sort (default: popular) |
| limit | number | Max results (default: 15) |
| end_date | string | End date YYYY-MM-DD (defaults to date) |
| destination* | string | City name (e.g. 'Rome', 'Tokyo', 'Barcelona') |
{
"type": "object",
"required": [
"destination",
"date"
],
"properties": {
"date": {
"type": "string",
"description": "Date YYYY-MM-DD"
},
"sort": {
"enum": [
"popular",
"cheapest",
"rating"
],
"type": "string",
"default": "popular",
"description": "Sort (default: popular)"
},
"limit": {
"type": "number",
"default": 15,
"description": "Max results (default: 15)"
},
"end_date": {
"type": "string",
"description": "End date YYYY-MM-DD (defaults to date)"
},
"destination": {
"type": "string",
"description": "City name (e.g. 'Rome', 'Tokyo', 'Barcelona')"
}
}
}Search the AgentWeb global business directory. Use agentweb_health for current counts. If a business is not in the database yet, AgentWeb tries to discover it from the web in real time (~3s) and saves it. Returns markdown prose by default. Supports text search (q), category, city/country, and geographic search (lat+lng+radius_km). ONE CALL RETURNS EVERYTHING: name, phone, email, hours, website, address, geo, trust score. Use format='json' for structured JSON.
| Argument | Type | Description |
|---|---|---|
| q | string | Text search query, e.g. 'noma', 'thai restaurant', 'dentist near me' |
| lat | number | Latitude for geographic search (requires lng and radius_km) |
| lng | number | Longitude for geographic search (requires lat and radius_km) |
| city | string | City name for location filter |
| limit | number | Maximum number of results (default: 10, max: 100) |
| cursor | string | Pagination cursor from a previous response's meta.next_cursor |
| format | string | Response format. 'text' (default) returns markdown prose; 'json' returns structured JSON. |
| country | string | Country code (ISO 3166-1 alpha-2, e.g., 'US', 'GB', 'DK') |
| category | string | Business category filter (e.g., 'restaurant', 'hotel', 'pharmacy') |
| radius_km | number | Search radius in kilometers (used with lat/lng) |
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Text search query, e.g. 'noma', 'thai restaurant', 'dentist near me'"
},
"lat": {
"type": "number",
"description": "Latitude for geographic search (requires lng and radius_km)"
},
"lng": {
"type": "number",
"description": "Longitude for geographic search (requires lat and radius_km)"
},
"city": {
"type": "string",
"description": "City name for location filter"
},
"limit": {
"type": "number",
"default": 10,
"description": "Maximum number of results (default: 10, max: 100)"
},
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous response's meta.next_cursor"
},
"format": {
"enum": [
"text",
"json"
],
"type": "string",
"default": "text",
"description": "Response format. 'text' (default) returns markdown prose; 'json' returns structured JSON."
},
"country": {
"type": "string",
"description": "Country code (ISO 3166-1 alpha-2, e.g., 'US', 'GB', 'DK')"
},
"category": {
"type": "string",
"description": "Business category filter (e.g., 'restaurant', 'hotel', 'pharmacy')"
},
"radius_km": {
"type": "number",
"description": "Search radius in kilometers (used with lat/lng)"
}
}
}Search real-time car rental availability and prices on booking.com via AgentWeb. Returns vehicle, supplier (Avis, Hertz, Sixt…), price, transmission, doors, mileage, pickup location, booking links. Works with any airport IATA code. ~1s.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort by price |
| limit | number | Max results (default: 15) |
| dropoff | string | Drop-off location if different from pickup |
| location* | string | Pickup: airport IATA code or city name |
| driver_age | number | Driver age (default: 30) |
| pickup_date* | string | Pickup date YYYY-MM-DD |
| pickup_time | string | Pickup time HH:MM (default: 10:00) |
| dropoff_date* | string | Drop-off date YYYY-MM-DD |
| dropoff_time | string | Drop-off time HH:MM (default: 10:00) |
| transmission | string | Filter by transmission type |
{
"type": "object",
"required": [
"location",
"pickup_date",
"dropoff_date"
],
"properties": {
"sort": {
"enum": [
"cheapest",
"expensive"
],
"type": "string",
"default": "cheapest",
"description": "Sort by price"
},
"limit": {
"type": "number",
"default": 15,
"description": "Max results (default: 15)"
},
"dropoff": {
"type": "string",
"description": "Drop-off location if different from pickup"
},
"location": {
"type": "string",
"description": "Pickup: airport IATA code or city name"
},
"driver_age": {
"type": "number",
"default": 30,
"description": "Driver age (default: 30)"
},
"pickup_date": {
"type": "string",
"description": "Pickup date YYYY-MM-DD"
},
"pickup_time": {
"type": "string",
"default": "10:00",
"description": "Pickup time HH:MM (default: 10:00)"
},
"dropoff_date": {
"type": "string",
"description": "Drop-off date YYYY-MM-DD"
},
"dropoff_time": {
"type": "string",
"default": "10:00",
"description": "Drop-off time HH:MM (default: 10:00)"
},
"transmission": {
"enum": [
"automatic",
"manual"
],
"type": "string",
"description": "Filter by transmission type"
}
}
}Search flights across multiple sources (booking.com + kiwi.com) and return the cheapest. Returns airlines, prices, times, stops, duration, source, and booking links. ~3s.
| Argument | Type | Description |
|---|---|---|
| to* | string | Destination airport IATA code (e.g. 'FCO', 'CDG', 'NRT') |
| from* | string | Origin airport IATA code (e.g. 'CPH', 'JFK', 'LHR') |
| sort | string | Sort order |
| cabin | string | Cabin class (default: ECONOMY) |
| limit | number | Max results (default: 10) |
| adults | number | Adult passengers (default: 2) |
| depart* | string | Departure date YYYY-MM-DD |
| return | string | Return date YYYY-MM-DD (omit for one-way) |
{
"type": "object",
"required": [
"from",
"to",
"depart"
],
"properties": {
"to": {
"type": "string",
"description": "Destination airport IATA code (e.g. 'FCO', 'CDG', 'NRT')"
},
"from": {
"type": "string",
"description": "Origin airport IATA code (e.g. 'CPH', 'JFK', 'LHR')"
},
"sort": {
"enum": [
"cheapest",
"fastest",
"direct"
],
"type": "string",
"default": "cheapest",
"description": "Sort order"
},
"cabin": {
"enum": [
"ECONOMY",
"BUSINESS",
"FIRST"
],
"type": "string",
"default": "ECONOMY",
"description": "Cabin class (default: ECONOMY)"
},
"limit": {
"type": "number",
"default": 10,
"description": "Max results (default: 10)"
},
"adults": {
"type": "number",
"default": 2,
"description": "Adult passengers (default: 2)"
},
"depart": {
"type": "string",
"description": "Departure date YYYY-MM-DD"
},
"return": {
"type": "string",
"description": "Return date YYYY-MM-DD (omit for one-way)"
}
}
}Search hotels across multiple sources (booking.com + kiwi.com) and return the cheapest. Returns name, price, stars, rating, reviews, source, booking links. ~2s.
| Argument | Type | Description |
|---|---|---|
| sort | string | Sort by price |
| limit | number | Max results (default: 10) |
| adults | number | Adult guests (default: 2) |
| checkin* | string | Check-in date YYYY-MM-DD |
| checkout* | string | Check-out date YYYY-MM-DD |
| max_price | number | Maximum price per night filter |
| destination* | string | City or destination (e.g. 'Rome', 'Tokyo') |
{
"type": "object",
"required": [
"destination",
"checkin",
"checkout"
],
"properties": {
"sort": {
"enum": [
"cheapest",
"expensive"
],
"type": "string",
"default": "cheapest",
"description": "Sort by price"
},
"limit": {
"type": "number",
"default": 10,
"description": "Max results (default: 10)"
},
"adults": {
"type": "number",
"default": 2,
"description": "Adult guests (default: 2)"
},
"checkin": {
"type": "string",
"description": "Check-in date YYYY-MM-DD"
},
"checkout": {
"type": "string",
"description": "Check-out date YYYY-MM-DD"
},
"max_price": {
"type": "number",
"description": "Maximum price per night filter"
},
"destination": {
"type": "string",
"description": "City or destination (e.g. 'Rome', 'Tokyo')"
}
}
}Autocomplete / type-ahead for business names, cities, or categories. Use to disambiguate user input before searching. Returns up to 15 suggestions by relevance. Fast (<20ms).
| Argument | Type | Description |
|---|---|---|
| q* | string | Query prefix, min 2 characters (e.g. 'nom', 'copenh') |
| type | string | What to autocomplete (default: 'business'). |
| limit | number | Max suggestions (default: 10, max: 15) |
| country | string | Optional ISO country code to narrow suggestions |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Query prefix, min 2 characters (e.g. 'nom', 'copenh')"
},
"type": {
"enum": [
"business",
"city",
"category"
],
"type": "string",
"default": "business",
"description": "What to autocomplete (default: 'business')."
},
"limit": {
"type": "number",
"default": 10,
"description": "Max suggestions (default: 10, max: 15)"
},
"country": {
"type": "string",
"description": "Optional ISO country code to narrow suggestions"
}
}
}Convert a local date/time between IANA zones, supported cities or countries. Rejects nonexistent clock-change times. Repeated local times require fold=0/1 or an explicit UTC offset. HH:MM uses today's date in the source zone.
| Argument | Type | Description |
|---|---|---|
| to* | string | Destination IANA timezone, supported city or country. |
| fold | integer | First (0) or second (1) occurrence during a backward clock change. |
| from* | string | Source IANA timezone, supported city or country. |
| time | string | ISO datetime, YYYY-MM-DD HH:MM, HH:MM or now (default). |
{
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string",
"description": "Destination IANA timezone, supported city or country."
},
"fold": {
"enum": [
0,
1
],
"type": "integer",
"description": "First (0) or second (1) occurrence during a backward clock change."
},
"from": {
"type": "string",
"description": "Source IANA timezone, supported city or country."
},
"time": {
"type": "string",
"description": "ISO datetime, YYYY-MM-DD HH:MM, HH:MM or now (default)."
}
},
"additionalProperties": false
}Get the current date and time in a country (e.g. Denmark), supported city, or IANA timezone. Returns UTC offset, DST, Unix timestamp and timezone-data version. Fresh every call. Countries with multiple zones return choices; select one and retry. Use this for 'What time is it in Denmark right now?'.
| Argument | Type | Description |
|---|---|---|
| location | string | Country name/code or supported city, e.g. Denmark, DK, Tokyo. Use either location or timezone. |
| timezone | string | IANA timezone, e.g. Europe/Copenhagen. Defaults to UTC if neither field is supplied. |
{
"type": "object",
"properties": {
"location": {
"type": "string",
"description": "Country name/code or supported city, e.g. Denmark, DK, Tokyo. Use either location or timezone."
},
"timezone": {
"type": "string",
"description": "IANA timezone, e.g. Europe/Copenhagen. Defaults to UTC if neither field is supplied."
}
},
"additionalProperties": false
}Get the most searched/popular businesses on AgentWeb right now (last 24h or all time).
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results (default: 10) |
| period | string | Time period (default: '24h'). |
{
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 100,
"minimum": 1,
"description": "Max results (default: 10)"
},
"period": {
"enum": [
"24h",
"alltime"
],
"type": "string",
"default": "24h",
"description": "Time period (default: '24h')."
}
}
}Cancel a watch and its queued callback deliveries. An already in-flight delivery may still arrive.
| Argument | Type | Description |
|---|---|---|
| watch_id* | string |
{
"type": "object",
"required": [
"watch_id"
],
"properties": {
"watch_id": {
"type": "string",
"format": "uuid"
}
}
}Create an expiring, resource-limited watch for URL text changes, text appearance or an unambiguous structured product price. Baselines are silent by default. An optional webhook receives signed changes; without it, poll watch_events.
| Argument | Type | Description |
|---|---|---|
| url | any | |
| kind* | string | |
| price | any | |
| query | any | |
| terms | array | |
| currency | any | |
| max_pages | integer | |
| max_units | integer | |
| max_checks | integer | |
| webhook_url | any | |
| notify_initial | boolean | |
| idempotency_key | string | Reuse for a retry of exactly the same operation/input. |
| interval_seconds | integer | |
| expires_in_seconds | integer |
{
"type": "object",
"title": "WatchRequest",
"required": [
"kind"
],
"properties": {
"url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048
},
{
"type": "null"
}
],
"title": "Url",
"default": null
},
"kind": {
"enum": [
"content_changed",
"text_appeared",
"price_below",
"price_dropped"
],
"type": "string",
"title": "Kind"
},
"price": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
],
"title": "Price",
"default": null
},
"query": {
"anyOf": [
{
"type": "string",
"maxLength": 500,
"minLength": 1
},
{
"type": "null"
}
],
"title": "Query",
"default": null
},
"terms": {
"type": "array",
"items": {
"type": "string"
},
"title": "Terms",
"maxItems": 5
},
"currency": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Z]{3}$"
},
{
"type": "null"
}
],
"title": "Currency",
"default": null
},
"max_pages": {
"type": "integer",
"title": "Max Pages",
"default": 3,
"maximum": 3,
"minimum": 1
},
"max_units": {
"type": "integer",
"title": "Max Units",
"default": 192,
"maximum": 1000,
"minimum": 1
},
"max_checks": {
"type": "integer",
"title": "Max Checks",
"default": 48,
"maximum": 288,
"minimum": 1
},
"webhook_url": {
"anyOf": [
{
"type": "string",
"maxLength": 2048
},
{
"type": "null"
}
],
"title": "Webhook Url",
"default": null
},
"notify_initial": {
"type": "boolean",
"title": "Notify Initial",
"default": false
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Reuse for a retry of exactly the same operation/input."
},
"interval_seconds": {
"type": "integer",
"title": "Interval Seconds",
"default": 1800,
"maximum": 86400,
"minimum": 300
},
"expires_in_seconds": {
"type": "integer",
"title": "Expires In Seconds",
"default": 86400,
"maximum": 604800,
"minimum": 300
}
},
"additionalProperties": false
}Read detected changes, supporting evidence and delivery status for a watch in the current scope.
| Argument | Type | Description |
|---|---|---|
| after | string | next_cursor from the previous page |
| watch_id* | string |
{
"type": "object",
"required": [
"watch_id"
],
"properties": {
"after": {
"type": "string",
"description": "next_cursor from the previous page"
},
"watch_id": {
"type": "string",
"format": "uuid"
}
}
}List change watches in the current application/user/workspace scope.
No arguments.
{
"type": "object",
"properties": {}
}Get weather forecast for any city worldwide. Returns current conditions plus daily forecast up to 14 days (high/low, rain chance, UV, sunrise/sunset, packing advisories). ~1s.
| Argument | Type | Description |
|---|---|---|
| city* | string | City name (e.g. 'Rome', 'Tokyo', 'New York') |
| days | number | Forecast days (1-14, default: 3) |
| units | string | Temperature unit (default: celsius) |
{
"type": "object",
"required": [
"city"
],
"properties": {
"city": {
"type": "string",
"description": "City name (e.g. 'Rome', 'Tokyo', 'New York')"
},
"days": {
"type": "number",
"default": 3,
"description": "Forecast days (1-14, default: 3)"
},
"units": {
"enum": [
"celsius",
"fahrenheit"
],
"type": "string",
"default": "celsius",
"description": "Temperature unit (default: celsius)"
}
}
}Page fetch. Fetches a public URL and returns its cleaned text content (title + body) ready to read.
| Argument | Type | Description |
|---|---|---|
| url* | string | The page URL to fetch |
| max_chars | number | Truncate content (default 8000) |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "The page URL to fetch"
},
"max_chars": {
"type": "number",
"default": 8000,
"description": "Truncate content (default 8000)"
}
}
}Web search PLUS the cleaned text of the top pages in one call (pages are fetched in parallel). Prefer this over web_search + web_fetch whenever you need to read the results, not just list them.
| Argument | Type | Description |
|---|---|---|
| q* | string | Search query |
| num | integer | Pages to read (default 3) |
| entity | string | Explicit entity for official_website candidate identification; ownership is not verified. |
| intent | string | |
| max_chars | integer | Characters per page (default 2500) |
| max_units | integer | |
| idempotency_key | string | Reuse for a retry of exactly the same operation/input. |
| max_duration_ms | integer |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Search query"
},
"num": {
"type": "integer",
"default": 3,
"maximum": 5,
"minimum": 1,
"description": "Pages to read (default 3)"
},
"entity": {
"type": "string",
"description": "Explicit entity for official_website candidate identification; ownership is not verified."
},
"intent": {
"enum": [
"general",
"official_website"
],
"type": "string"
},
"max_chars": {
"type": "integer",
"default": 2500,
"maximum": 8000,
"minimum": 300,
"description": "Characters per page (default 2500)"
},
"max_units": {
"type": "integer",
"default": 4,
"maximum": 6,
"minimum": 1
},
"idempotency_key": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Reuse for a retry of exactly the same operation/input."
},
"max_duration_ms": {
"type": "integer",
"default": 10000,
"maximum": 20000,
"minimum": 1000
}
}
}General web search. mode=index searches AgentWeb's own indexed pages with a short time budget; mode=hybrid also queries external sources (the default). Returns the top web results (title, URL, snippet) for a query: general web pages, not just businesses. Use for research, finding pages, and current info. Pair with web_fetch to read a result.
| Argument | Type | Description |
|---|---|---|
| q* | string | Search query |
| num | integer | Number of results (default 10, max 20) |
| mode | string |
{
"type": "object",
"required": [
"q"
],
"properties": {
"q": {
"type": "string",
"description": "Search query"
},
"num": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1,
"description": "Number of results (default 10, max 20)"
},
"mode": {
"enum": [
"index",
"hybrid"
],
"type": "string",
"default": "hybrid"
}
}
}