atly_places_search_intent $0.001 per call

Find places that match intents near a location. Find places for an intent near a location (Atly · Places (local search))

For AI agents: call atly_places_search_intent
POST https://toll402.dev/v1/p/atly.places.search.intent
{
 "categories": [
  "69e178c3-14be-11ee-a9cb-614c6a0a867a"
 ],
 "area_id": "canonical-area::c790a21e-65a4-5e5c-8061-64900cd3fd0e",
 "limit": 1
}
Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp) or send a prepaid-credits key as x-toll402-key (https://toll402.dev/credits). Paid per call via x402 (USDC on Base) or with a prepaid-credits key (x-toll402-key, card at /credits); charged only on success. Start at /llms.txt or connect the MCP server: npx -y toll402-mcp · remote https://toll402.dev/mcp.

Input schema

{
 "type": "object",
 "properties": {
  "categories": {
   "type": "string",
   "description": "1-5 category names or ids from atly.places.categories, most important first. A name must be exact; a near miss is refused with the close matches. Every result matches all of them; if none does, trailing ones are dropped (never the first) an",
   "examples": [
    [
     "Cappuccino"
    ]
   ]
  },
  "area_id": {
   "type": "string",
   "description": "Up to 120 characters. An area id from atly.places.areas, or a city name such as \"Austin\" or \"Boise, ID\". Give this or lat and lon, not both.",
   "examples": [
    "New York"
   ]
  },
  "lat": {
   "type": "number",
   "description": "With lon (and optionally radius_km) instead of area_id."
  },
  "lon": {
   "type": "number"
  },
  "radius_km": {
   "type": "number",
   "description": "Search radius around lat/lon in km, held to 0.2-50.",
   "default": 5
  },
  "limit": {
   "type": "integer",
   "description": "Places to return.",
   "default": 10,
   "examples": [
    3
   ]
  },
  "place_type": {
   "type": "string",
   "description": "Words matched as whole words against each place's Google place types, e.g. [\"restaurant\"]. Google's types are literal: for cafes pass [\"cafe\", \"coffee\"]. Use it for a kind of venue, not a dish or a feature."
  }
 },
 "additionalProperties": true,
 "required": [
  "categories"
 ],
 "description": "Ranked by Atly's 0-10 score for the requested categories, relative to other places in the same country; a place with no score is unmeasured, not bad. Each place carries quotable reasons from reviews, the Atly url to cite, a Google Maps link, and open_now when its hours are known. The first three results also carry hours, contact and good-to-know facts."
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI