Tmp.RxWQKc0Dbd

Find free and cheap things to do in a US city — daily event listings with times, prices and venues, plus searchable deals, festivals, kids activities and local guides from the On the Cheap network (Charlotte, Denver, Atlanta, Chicago, Columbus, Seattle, Kansas City, South Florida, Orlando, Portland, Richmond, Southern Maine, the Triangle). Use when the user asks what's happening locally, wants free or cheap things to do on a date or weekend, or asks about local deals, festivals, or family activities.

On the Cheap

Reads the On the Cheap network — local guides to free and cheap things to do across ~14 US cities. Everything is read-only and needs no credentials.

Always name the city

Every tool except otc_list_sites takes a required site argument, and there is no default. Pick the key that matches the city the user means; if you're not sure one exists, call otc_list_sites first. Common aliases work (milehigh, raleigh, rva, kc, southflorida).

An unknown key is refused with the valid ones listed, so you'll never silently read the wrong city — but do check that the key you picked is the city the user actually asked about. Every result echoes back site and site_name.

Because the whole network is reachable, you can answer across cities in one go — comparing a weekend in Denver and Portland is just two calls.

Category and location ids are per-site. Each site is a separate WordPress install, so an id from otc_list_categories is only meaningful against that same site. Reusing one across cities filters to something unrelated rather than erroring.

The national site (Living On The Cheap) covers US-wide deals and has no local events calendar. The event tools reject it with an explanatory error; use otc_search_posts with site: "national" for national deals.

Picking the right tool

• What's on for a date → otc_list_events with an ISO date (defaults to today). Each listing has its time, price and venue. Add free_only: true for no-cost listings only.
• Scan or compare a whole month → otc_events_month_overview.
• Find articles by topic, place or text → otc_search_posts (query, category, location, after/before).
• Read one article in full → otc_get_post with an id, slug, or URL.
• Discover filter ids → otc_list_categories, otc_list_locations.
• Find which cities exist → otc_list_sites (the only tool with no site).

Typical flow

Pass site on every one of these calls.

For "what's free this weekend?", call otc_list_events once per date with free_only: true — the events calendar is per-day, so a weekend is two calls (three over a long weekend). Give the user the title, time and venue, and offer otc_get_post on anything they want details for.

For a topic ("free museum days", "kids stuff in Lake Norman"), search instead: resolve the category or location id first if you need to filter — against the same site — then otc_search_posts.

Two behaviours to get right

Month overviews are previews. The calendar renders at most four listings per day. In otc_events_month_overview, each day's events is a preview while total is the day's real count — for one August that was 124 previewed against 510 actual. Use total when telling the user how much is on, and call otc_list_events for a date to get that day's full schedule. Never present the preview as the complete list.

Expired deals are hidden by default. Retired offers are parked in an expired category and excluded from searches, so results reflect things still available. Only pass include_expired: true when the user is explicitly researching past deals or history — and say so when those results are shown, since the offers no longer stand.

Dates

Pass dates as ISO YYYY-MM-DD (and months as YYYY-MM). The tools convert to whatever the site expects and reject a malformed date rather than guessing. Resolve relative dates ("this Saturday") against today before calling.