dogpolicies-mcp 0.6.0 → 0.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -10,6 +10,42 @@ The data inside the package has its own date (`as_of` in every result). A
10
10
  new package version ships a new snapshot; the server also refreshes from the
11
11
  site on its own when the network allows.
12
12
 
13
+ ## 0.6.1 - 2026-11-21
14
+
15
+ The trip card gets a real map, and the data grows by 350 places: chain hotels read one by one from their own pages,
16
+ and restaurants, cafes, breweries and wineries in the top travel towns.
17
+
18
+ Changed
19
+
20
+ - The card's map is a map: land, the coast, lakes, reservoirs and bays, state lines and the highway network
21
+ (interstates, US highways and state routes, with route and lake names) under the places, drawn from U.S. Census
22
+ Bureau TIGERweb data (public domain) embedded in the card, so it still makes no outside request. The frame shows at
23
+ least about 9 km of ground, so places in one town sit in their surroundings. `scripts/fetch-card-basemap.mjs` in the
24
+ data repository rebuilds the data.
25
+ - A call that arrives without what the tool needs is still an answer (`outcome: bad_input`, never `isError`), and now
26
+ carries one working example call: `Example: dogpolicies_get_place {"id":"carmel-beach"}`. `dogpolicies_search_places`
27
+ and `dogpolicies_find_hotels` called with no arguments at all say what they need instead of listing the whole data
28
+ set; a call with `limit`, `offset` or any filter searches as before.
29
+ - Three descriptions say what the tool is not for, without naming another tool (`search_places`, `find_hotels`,
30
+ `plan_trip`).
31
+
32
+ Data
33
+
34
+ - 4,612 places (was 4,262). 317 chain hotels read from their own page on the chain's site: 232 new, 84 that carried
35
+ only their brand's policy now carry their own, and 80 say on their own page that they do not take pets (a brand
36
+ policy no longer stands in for them). 54 new restaurants, cafes, breweries and wineries and 14 enriched with meals,
37
+ hours or holiday hours, each from the business's own page.
38
+ - 16 hotel chains in `dogpolicies_get_brand_policy` (was 6): Hilton, Marriott Bonvoy, Hyatt, Wyndham, Staybridge
39
+ Suites, Candlewood Suites, Comfort, Sleep Inn, Econo Lodge and Quality Inn, each quoting its own page that pet rules
40
+ are set hotel by hotel, with the hotels read listed under it.
41
+ - A place that does not allow dogs no longer inherits its brand's fee or weight limit.
42
+
43
+ Package
44
+
45
+ - `LICENSE` is the plain MIT text under the DogPolicies name, so GitHub and npm detect it; the CC BY 4.0 and ODbL
46
+ terms for the data are in `data/LICENSE.md` beside the data file.
47
+ - The README opens with the card as Claude draws it; `homepage` is https://dogpolicies.com/mcp/about/.
48
+
13
49
  ## 0.6.0 - 2026-11-20
14
50
 
15
51
  The winter release (`docs/RELEASE-0.6.md` in the data repository: R-27, R-28, R-29). A trip comes back as a card in
@@ -33,7 +69,10 @@ Added
33
69
  - `also_types` and `geo` (rounded to 4 decimals) on place summaries: a campground that also rents cabins is found
34
70
  by a cabins search (decision 130).
35
71
  - `dogpolicies_road_conditions` covers US-395 in California (Caltrans districts 8, 9 and 2: Hesperia past Bishop and
36
- Mammoth Lakes to the Nevada line, and the north end to Oregon).
72
+ Mammoth Lakes to the Nevada line, and the north end to Oregon), and the Lake Tahoe highways SR-89 (Monitor Pass,
73
+ Luther Pass, Emerald Bay, Tahoe City, Truckee), SR-28, SR-267 and SR-88 (Carson Pass), read from the same Caltrans
74
+ pass; a stretch name ("Emerald Bay", "Brockway") finds its route. A Nevada road (SR-207, SR-431) is a `no_match`
75
+ that links Nevada 511, whose data feed needs a registered key (decision 145).
37
76
 
38
77
  Data
39
78
 
package/LICENSE CHANGED
@@ -1,6 +1,6 @@
1
1
  MIT License
2
2
 
3
- Copyright (c) 2026 Dog Rulebook
3
+ Copyright (c) 2026 DogPolicies
4
4
 
5
5
  Permission is hereby granted, free of charge, to any person obtaining a copy
6
6
  of this software and associated documentation files (the "Software"), to deal
@@ -19,18 +19,3 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
19
  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
20
  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
21
  SOFTWARE.
22
-
23
- ---
24
-
25
- The MIT license above covers the code in this package. The data file
26
- (data/snapshot.json.gz) is a separate work:
27
-
28
- - Dog rules, sources, verification dates and answers are licensed under the
29
- Creative Commons Attribution 4.0 International License (CC BY 4.0),
30
- https://creativecommons.org/licenses/by/4.0/. Attribute "DogPolicies"
31
- with a link to https://dogpolicies.com/ and cite each record with its URL
32
- and verified date.
33
- - Chain-hotel names and locations derived from OpenStreetMap are
34
- © OpenStreetMap contributors, available under the Open Database License
35
- (ODbL), https://www.openstreetmap.org/copyright. Records carrying them say
36
- so in their record_license field.
package/README.md CHANGED
@@ -1,7 +1,12 @@
1
+ <a href="https://dogpolicies.com/mcp/about/"><img src="https://dogpolicies.com/brand/readme-banner.png" alt="DogPolicies, MCP server for AI assistants" width="100%"></a>
2
+
1
3
  # DogPolicies MCP server
2
4
 
3
5
  **[dogpolicies.com](https://dogpolicies.com/)** · Verified dog rules for California and Nevada travel: hotel pet fees, trip plans, highway stops. [Install guide and example](https://dogpolicies.com/mcp/about/) · [Status](https://dogpolicies.com/status/)
4
6
 
7
+ <p align="center"><img src="https://dogpolicies.com/brand/readme-card-in-claude.png" width="640" alt="The DogPolicies trip card in Claude: a map of South Lake Tahoe with the lake, US-50, SR-89 and the state line, each dog-friendly place as a dot, then day one: Campground by the Lake (dogs welcome, $2 per pet per night), the Tallac Historic Site shoreline (with limits) and K-9 Korral Dog Park"></p>
8
+ <p align="center"><sub>In Claude: “Use DogPolicies: plan two nights in South Lake Tahoe with our dog.” Every stop links to its source and the date it was checked.</sub></p>
9
+
5
10
  DogPolicies answers dog-travel questions for California and Nevada, and every fact it returns carries its official source (an agency page or the business's own published policy) and the date it was checked; Nevada coverage is still thin. It does the work a web page cannot: the pet-fee arithmetic for a specific dog, day-by-day trip plans, highway stops in driving order with Caltrans conditions right now, the nearest 24-hour emergency vet on the way, what changed since a date, and corrections a person checks. In Claude and ChatGPT a trip, a town or a drive also comes back as a card in the chat.
6
11
 
7
12
  **Listed in Claude's connector directory** since November 4, 2026: [add DogPolicies in Claude](https://claude.ai/directory/dogpolicies) with nothing to install. Also on npm and in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.xultrax-web/dogpolicies-mcp). DogPolicies is independent and not affiliated with Anthropic.
@@ -70,7 +75,7 @@ The tools, by the job they do. Every one except `dogpolicies_report_correction`
70
75
 
71
76
  A rest area Caltrans reports closed right now carries `closed_now` (Caltrans' reason and end time) in `route_stops`, `i5_corridor` and `plan_trip`, and is never offered as the next stop.
72
77
 
73
- - `dogpolicies_road_conditions`: Caltrans chain controls, lane and ramp closures, road weather and sign messages right now on I-80, US-50, I-15, I-5 and US-395 in California (Donner Summit, Echo Summit, Cajon Pass, the Grapevine, the Eastern Sierra past Mammoth Lakes), by route, town or named stretch, each at its route mile beside the nearest dog stop. Live state, not rules; Nevada roads are not covered; it needs the network.
78
+ - `dogpolicies_road_conditions`: Caltrans chain controls, lane and ramp closures, road weather and sign messages right now on I-80, US-50, I-15, I-5 and US-395 in California (Donner Summit, Echo Summit, Cajon Pass, the Grapevine, the Eastern Sierra past Mammoth Lakes) and the Lake Tahoe highways SR-89 (Emerald Bay, Luther Pass), SR-28, SR-267 and SR-88 (Carson Pass), by route, town or named stretch, each at its route mile beside the nearest dog stop. Live state, not rules; Nevada roads are not covered (the answer links Nevada 511); it needs the network.
74
79
 
75
80
  ### Emergency
76
81
 
@@ -101,7 +106,7 @@ A rest area Caltrans reports closed right now carries `closed_now` (Caltrans' re
101
106
  - Starts with a citation sentence and ends with `DogPolicies, dogpolicies.com, CC BY 4.0, verified {date}`. Every record carries `confidence` (stated, inferred_from_agency, inherited_brand), `freshness` (fresh, due, stale, unreadable), `verified_at`, `url` and `source_urls`. A fact the source does not state is listed as not stated, never filled in.
102
107
  - Plain words work as arguments: "hotel", "NB", "Motel 6" or "yes" are read as the value the schema wants and labeled `resolved_from`. An argument that still does not fit comes back as `outcome: "bad_input"` with what is accepted, not a protocol error; a question the data cannot answer is `no_match` with `did_you_mean`, `nearest` and `next`. `isError` means the server itself failed or refused a write (`rate_limited`).
103
108
  - Markdown by default, structured JSON with `response_format: "json"`, and an output schema on every tool. The full reference, generated from the code: [docs/tools.md](docs/tools.md).
104
- - A card in the chat: `dogpolicies_plan_trip`, `dogpolicies_near`, `dogpolicies_route_stops` and `dogpolicies_emergency_vet` declare an MCP Apps view, `ui://dogpolicies/trip-card` (`_meta.ui.resourceUri`). Claude and ChatGPT draw the result as a card with a dot map from the records' own coordinates, each stop's dog rule in one line and links to each place's page. The card is one HTML file with no outside requests; the data comes in the tool result. Other clients get the same text answer as before.
109
+ - A card in the chat: `dogpolicies_plan_trip`, `dogpolicies_near`, `dogpolicies_route_stops` and `dogpolicies_emergency_vet` declare an MCP Apps view, `ui://dogpolicies/trip-card` (`_meta.ui.resourceUri`). Claude and ChatGPT draw the result as a card: a map of the places with the coast, lakes, state lines and highways, each stop's dog rule in one line and links to each place's page. The card is one HTML file with no outside requests: the map (U.S. Census Bureau TIGERweb, public domain) is drawn from data inside it, and the places come in the tool result. Other clients get the same text answer as before.
105
110
  - Resources attach a record without a tool call: `dogpolicies://place/{id}`, `brand/{id}`, `answer/{slug}`, `route/{id}` and `area/{id}` (with completion), plus `dogpolicies://about`, `answers`, `status` and `corridor/i-5`. Prompts for the slash menu: `plan_dog_trip`, `check_hotel_for_dog`, `road_trip_with_dog`, `drive_i5_with_dog`, `what_can_my_dog_do_here`, `cite_a_rule`.
106
111
 
107
112
  ## Not using MCP?
@@ -149,8 +154,8 @@ The `demo` output is the exact text an assistant receives:
149
154
 
150
155
  ## License and attribution
151
156
 
152
- - **Code:** MIT.
153
- - **Data:** [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). Attribute "DogPolicies" with a link to https://dogpolicies.com/ and cite each record with its URL and verified date; every result includes a ready-made citation line. Chain-hotel names and locations come from OpenStreetMap under the [ODbL](https://www.openstreetmap.org/copyright) and say so in `record_license`.
157
+ - **Code:** MIT ([LICENSE](LICENSE)).
158
+ - **Data:** [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) ([data/LICENSE.md](data/LICENSE.md)). Attribute "DogPolicies" with a link to https://dogpolicies.com/ and cite each record with its URL and verified date; every result includes a ready-made citation line. Chain-hotel names and locations come from OpenStreetMap under the [ODbL](https://www.openstreetmap.org/copyright) and say so in `record_license`.
154
159
  - The rules are a sourced, dated summary, not legal advice. Confirm with the agency or the business before you go, especially when a record says `stale`, `unreadable` or `inherited_brand`. Service animals are governed by the ADA, not these pet rules. Terms: https://dogpolicies.com/terms/
155
160
 
156
161
  ## For developers
@@ -0,0 +1,14 @@
1
+ # Data license
2
+
3
+ The MIT license in the package root covers the code. The data file in this
4
+ folder (`snapshot.json.gz`) is a separate work:
5
+
6
+ - **Dog rules, sources, verification dates and answers** are licensed under the
7
+ Creative Commons Attribution 4.0 International License (CC BY 4.0),
8
+ https://creativecommons.org/licenses/by/4.0/. Attribute "DogPolicies" with a
9
+ link to https://dogpolicies.com/ and cite each record with its URL and
10
+ verified date; every result includes a ready-made citation line.
11
+ - **Chain-hotel names and locations** derived from OpenStreetMap are
12
+ © OpenStreetMap contributors, available under the Open Database License
13
+ (ODbL), https://www.openstreetmap.org/copyright. Records carrying them say so
14
+ in their `record_license` field.
Binary file
package/docs/tools.md CHANGED
@@ -1,14 +1,14 @@
1
1
  # Tool reference
2
2
 
3
- dogpolicies-mcp 0.6.0, generated by `node scripts/docs.mjs` from the live definitions. Every tool returns readable markdown by default and structured JSON with `response_format: "json"`; every result starts with a citation and ends with the attribution line.
3
+ dogpolicies-mcp 0.6.1, generated by `node scripts/docs.mjs` from the live definitions. Every tool returns readable markdown by default and structured JSON with `response_format: "json"`; every result starts with a citation and ends with the attribution line.
4
4
 
5
5
  ## `dogpolicies_search_places`
6
6
 
7
7
  **Search places** · since 0.1.0
8
8
 
9
9
  Can my dog go to this place, or which parks, beaches, trails, campgrounds or patios allow dogs: "Can I bring my dog to Point Lobos?", "state parks in Marin that allow dogs", "off-leash beaches near San Diego"?
10
- Answers for one named place or a filtered list of one kind; each result's id names the place's full record, with every rule and source.
11
- Inputs: query (name, city or brand; words like "cabins", "hikes", "wineries" or "dog friendly hotels in Carmel" are read as the kind and the place), type (lodging, campground incl. RV parks, cabins, beach, park, trail, restaurant, rest_area, stop; "hotel", "dog park" or "hike" are read as these), dogs_allowed, off_leash, state "CA" or "NV", county without "County", area (lake-tahoe, big-sur, east-bay), or near={lat, lon}.
10
+ Answers for one named place or a filtered list of one kind; each result's id names the place's full record, with every rule and source. It is not a roundup of everything dog-friendly in a town, a hotel fee calculation, or a road report.
11
+ Inputs: query (name, city or brand; words like "cabins", "hikes", "wineries" or "dog friendly hotels in Carmel" are read as the kind and the place), type (lodging, campground incl. RV parks, cabins, beach, park, trail, restaurant, rest_area, stop; "hotel", "dog park" or "hike" are read as these), dogs_allowed, off_leash, meal (breakfast, brunch, lunch or dinner: restaurants that state they serve it), open_on (a date, YYYY-MM-DD: restaurants whose own page says they are open that day, such as Thanksgiving), state "CA" or "NV", county without "County", area (lake-tahoe, big-sur, east-bay), or near={lat, lon}.
12
12
  Each result: yes, yes_restricted, no or varies, the rule in a sentence, verified date, URL and id. No match is an answer (outcome no_match) with did_you_mean, nearest and next. Nevada coverage is thin.
13
13
 
14
14
  Examples:
@@ -20,6 +20,8 @@ Examples:
20
20
  - "RV parks in Fresno County that take dogs" -> type="campground", county="Fresno", dogs_allowed=true
21
21
  - "Dog-friendly cabins in June Lake" -> type="cabins", query="June Lake", dogs_allowed=true (query="June Lake cabins" works too)
22
22
  - "Restaurants with a dog-friendly patio in Alameda" -> type="restaurant", query="Alameda"
23
+ - "Where can I take my dog to breakfast at Lake Tahoe?" -> type="restaurant", meal="breakfast", area="lake-tahoe", dogs_allowed=true
24
+ - "Lake Tahoe restaurants open on Thanksgiving that allow dogs" -> type="restaurant", open_on="2026-11-26", area="lake-tahoe", dogs_allowed=true
23
25
 
24
26
  Annotations: read-only true, destructive false, idempotent true, open-world false.
25
27
 
@@ -29,6 +31,8 @@ Annotations: read-only true, destructive false, idempotent true, open-world fals
29
31
  | `type` | `lodging`, `campground`, `cabins`, `beach`, `park`, `trail`, `restaurant`, `rest_area`, `stop` | Kind of place; campground covers campgrounds and RV parks (some also rent cabins), cabins covers cabin resorts with no campground, restaurant covers restaurants, cafes, bars, breweries and tasting rooms (dogs on the patio, by the owner's published policy), rest_area and stop are the roadside kinds |
30
32
  | `dogs_allowed` | boolean | true: only places that allow dogs somewhere; false: only places that do not |
31
33
  | `off_leash` | boolean | true: only places where the managing agency allows dogs off leash, at least at some times |
34
+ | `meal` | `breakfast`, `brunch`, `lunch`, `dinner` | Only restaurants and cafes whose own page states they serve this meal |
35
+ | `open_on` | string | A day that has not passed (YYYY-MM-DD): only places whose own page gives hours for that day and says they are open |
32
36
  | `state` | `CA`, `NV` | "CA" or "NV". Also tells apart counties with the same name, such as Humboldt. |
33
37
  | `county` | string (min length 2, max length 40) | County name without "County", in California or Nevada, e.g. "Monterey" or "Washoe" |
34
38
  | `region` | `north-coast`, `shasta-cascade`, `gold-country`, `high-sierra`, `bay-area`, `central-coast`, `central-valley`, `inland-empire-deserts`, `los-angeles`, `orange-county`, `san-diego`, `reno-tahoe-nevada`, `las-vegas-southern-nevada`, `northern-central-nevada` | Region id, e.g. central-coast, san-diego or reno-tahoe-nevada |
@@ -85,7 +89,7 @@ Annotations: read-only true, destructive false, idempotent true, open-world fals
85
89
  | `id` (required) | string (min length 2, max length 120) | Place id, e.g. "fort-funston" |
86
90
  | `response_format` | `markdown`, `json` (default `"markdown"`) | 'markdown' for readable text, 'json' for structured data |
87
91
 
88
- Output fields: `id`, `uid`, `name`, `type`, `status`, `answer`, `today`, `citation`, `confidence`, `confirmed_by`, `freshness`, `verified_at`, `url`, `source_urls`, `record_license`, `closed_now`, `as_of`, `license`, `attribution_text`, `attribution_url`, `outcome`, `code`, `message`, `did_you_mean`, `nearest`, `next`, `accepted`, `resolved_from`, `facts`, `rule_records`, `not_stated`, `rules`, `sources`, `review_due`, `axis`, `paired_stop` (more may be added; none removed).
92
+ Output fields: `id`, `uid`, `name`, `type`, `status`, `answer`, `today`, `meals`, `holiday_hours`, `citation`, `confidence`, `confirmed_by`, `freshness`, `verified_at`, `url`, `source_urls`, `record_license`, `closed_now`, `as_of`, `license`, `attribution_text`, `attribution_url`, `outcome`, `code`, `message`, `did_you_mean`, `nearest`, `next`, `accepted`, `resolved_from`, `facts`, `rule_records`, `not_stated`, `rules`, `sources`, `review_due`, `axis`, `paired_stop` (more may be added; none removed).
89
93
 
90
94
  ## `dogpolicies_compare_places`
91
95
 
@@ -110,7 +114,7 @@ Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `outco
110
114
  **Plan a trip with a dog** · since 0.2.0
111
115
 
112
116
  Plan a dog trip to a town: where can we stay with this dog, what is the pet fee for all the nights, what can we do each day, where can we eat?
113
- One answer covers a whole stay, such as "three nights in Monterey with our 70 lb Lab, pet fees under $150" or "camping near Mammoth Lakes".
117
+ One answer covers a whole stay, such as "three nights in Monterey with our 70 lb Lab, pet fees under $150" or "camping near Mammoth Lakes". It plans a stay at one destination, not the stops along a drive.
114
118
  Inputs: place (a city, county, neighborhood, area or region, with small spelling slips corrected) or near={lat, lon}; dog_weight_lb, dogs, nights, max_total_fee, stay_types. Optional: start_date (dates each day), stay_id (build the plan on that stay), save=true (adds trip_url, a dogpolicies.com page showing the plan; the plan travels inside the link, nothing is stored).
115
119
  Returns stays that fit with the whole-stay pet fee worked out (a pet fee, never a room rate), stays that need a call to confirm, and "days": for each night the stay, a morning beach, trail or off-leash area, an afternoon park and a dinner patio, each a real record with source URL and verified date; a slot the data cannot fill is null with the reason (dinner often is). "plan_stay" shows the fee arithmetic and whether the dog's weight and number fit. Within 10 miles of I-5 in California it adds the drive leg: the town's mile and the next family stops each way. An unknown town is an answer with did_you_mean. The markdown answer is laid out as a trip document for the traveler.
116
120
 
@@ -146,7 +150,7 @@ Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `outco
146
150
  **Find hotels for a dog** · since 0.1.0
147
151
 
148
152
  Will a hotel take my dog, and what will the pet fee come to: a 70 lb Lab under $50, two dogs for three nights near Palm Springs, the Motel 6 in Fresno?
149
- Does the weight, dog-count and fee arithmetic for the stay, hotel by hotel, against each hotel's published pet policy.
153
+ Does the weight, dog-count and fee arithmetic for the stay, hotel by hotel, against each hotel's published pet policy. It answers for stays at specific hotels, not for a chain's policy in general, and it lists no other kind of place.
150
154
  Inputs: query (hotel name, city or brand), brand, county without "County", state "CA" or "NV", area (lake-tahoe, big-sur, east-bay), region, or near={lat, lon}; dog_weight_lb, dogs, nights, max_total_fee.
151
155
  Each hotel is a match, a possible (needs a call: case by case, weight unstated, "up to" fee) or excluded, with the arithmetic spelled out, the source URL and verified date. Amounts are pet fees, never room rates: there are no room prices here.
152
156
 
@@ -162,7 +166,7 @@ Annotations: read-only true, destructive false, idempotent true, open-world fals
162
166
  | Input | Type | Meaning |
163
167
  |---|---|---|
164
168
  | `query` | string (min length 2, max length 100) | Words in the hotel name, city or brand; or an airport code or name ("LAX", "Harry Reid") for hotels within 5 miles of it |
165
- | `brand` | `best-western`, `extended-stay-america`, `kimpton`, `la-quinta`, `motel-6`, `red-roof` | Only this hotel brand |
169
+ | `brand` | `best-western`, `candlewood-suites`, `comfort`, `econo-lodge`, `extended-stay-america`, `hilton`, `hyatt`, `kimpton`, `la-quinta`, `marriott`, `motel-6`, `quality-inn`, `red-roof`, `sleep-inn`, `staybridge-suites`, `wyndham` | Only this hotel brand |
166
170
  | `dog_weight_lb` | number (min 1, max 300) | The dog's weight in pounds |
167
171
  | `dogs` | integer (min 1, max 10, default `1`) | Number of dogs |
168
172
  | `nights` | integer (min 1, max 90, default `1`) | Nights of the stay |
@@ -236,7 +240,7 @@ Annotations: read-only true, destructive false, idempotent true, open-world fals
236
240
 
237
241
  | Input | Type | Meaning |
238
242
  |---|---|---|
239
- | `route` | `i-5`, `us-101`, `highway-1`, `i-15`, `i-80`, `us-50`, `us-395`, `i-15-nevada`, `i-80-nevada`, `us-50-nevada`, `us-95-nevada`, `us-93-nevada` (default `"i-5"`) | Route id. Miles: California follows the Caltrans odometer (I-5 from the Mexican border, US-101 from Los Angeles, Highway 1 from Dana Point, I-15 San Diego to Primm, I-80 San Francisco to the Nevada line, US-50 West Sacramento to Stateline); Nevada routes count mileposts from the California line, matching exit numbers. Routes: I-5 (i-5, 796 miles), US-101 (us-101, 809 miles), Highway 1 (highway-1, 736 miles), I-15 (i-15, 294 miles), I-80 (i-80, 204 miles), US-50 (us-50, 109 miles), US-395 (us-395, 629 miles), I-15 (i-15-nevada, 124 miles), I-80 (i-80-nevada, 410 miles), US-50 (us-50-nevada, 409 miles), US-95 (us-95-nevada, 664 miles), US-93 (us-93-nevada, 526 miles) |
243
+ | `route` | `i-5`, `us-101`, `highway-1`, `i-15`, `i-80`, `us-50`, `us-395`, `sr-89`, `sr-28`, `sr-267`, `sr-88`, `i-15-nevada`, `i-80-nevada`, `us-50-nevada`, `us-95-nevada`, `us-93-nevada` (default `"i-5"`) | Route id. Miles: California follows the Caltrans odometer (I-5 from the Mexican border, US-101 from Los Angeles, Highway 1 from Dana Point, I-15 San Diego to Primm, I-80 San Francisco to the Nevada line, US-50 West Sacramento to Stateline); Nevada routes count mileposts from the California line, matching exit numbers. Routes: I-5 (i-5, 796 miles), US-101 (us-101, 809 miles), Highway 1 (highway-1, 736 miles), I-15 (i-15, 294 miles), I-80 (i-80, 204 miles), US-50 (us-50, 109 miles), US-395 (us-395, 629 miles), SR-89 (sr-89, 317 miles), SR-28 (sr-28, 11 miles), SR-267 (sr-267, 12 miles), SR-88 (sr-88, 124 miles), I-15 (i-15-nevada, 124 miles), I-80 (i-80-nevada, 410 miles), US-50 (us-50-nevada, 409 miles), US-95 (us-95-nevada, 664 miles), US-93 (us-93-nevada, 526 miles) |
240
244
  | `near` | object | Start from the route mile nearest this point |
241
245
  | `from_mile` | number (min 0, max 1000) | Start at this route mile |
242
246
  | `to_mile` | number (min 0, max 1000) | Stop at this route mile |
@@ -320,9 +324,9 @@ Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `outco
320
324
 
321
325
  **Road conditions now: closures, chains, weather** · since 0.5.0
322
326
 
323
- Do I need chains on I-80 to Tahoe right now? Is US-50 open over Echo Summit? Caltrans chain controls, lane and ramp closures, road-weather stations and message-sign text on I-80 (San Francisco to the Nevada line), US-50 (West Sacramento to Stateline), I-15 (San Diego to Primm) and I-5 in California, each at its route mile with the nearest dog stop.
324
- Live state, not rules: Caltrans feed data fetched every 15 minutes (fetched_at in the result), never a verified fact. For the day of a mountain or desert drive: Donner Summit, Echo Summit, Cajon Pass, the Grapevine. It reports conditions, not places to stop: each condition carries only the nearest dog stop. Nevada roads and other highways are not covered.
325
- Inputs: route ("I-80", "80", "US 50", "Highway 50", "I-15", "I-5"); a window as from_mile and to_mile, or town (a town or named stretch on the route: Truckee, Donner Pass, South Lake Tahoe, Placerville, Cajon Pass, Barstow) with direction and ahead_miles; direction alone keeps that direction's closures, signs and chain controls. With no window, the whole route in California.
327
+ Do I need chains on I-80 to Tahoe right now? Is US-50 open over Echo Summit? Is Highway 89 closed at Emerald Bay? Caltrans chain controls, lane and ramp closures, road-weather stations and message-sign text on I-80, US-50, I-15, I-5, US-395 and the Lake Tahoe highways SR-89, SR-28, SR-267 and SR-88, in California, each at its route mile with the nearest dog stop.
328
+ Live state, not rules: Caltrans feed data fetched every 15 minutes (fetched_at in the result), never a verified fact. For the day of a mountain or desert drive: Donner Summit, Echo Summit, Cajon Pass, the Grapevine. It reports conditions, not places to stop: each condition carries only the nearest dog stop. Nevada roads (SR-207, SR-431) are not covered: the answer links Nevada 511.
329
+ Inputs: route ("I-80", "80", "US 50", "Highway 89", "SR 28", "I-5"); a window as from_mile and to_mile, or town (a town or named stretch on the route: Truckee, Donner Pass, Emerald Bay, Brockway, South Lake Tahoe, Cajon Pass, Barstow) with direction and ahead_miles; direction alone keeps that direction's closures, signs and chain controls. With no window, the whole route in California.
326
330
  chain_controls_in_effect is true when a Caltrans chain-control point in the window reports a control (any status but R-0), with Caltrans' own wording; a sign that mentions chains is listed under signs with its text. Each weather station says whether its reading is current (the feeds sometimes carry readings months old; those numbers are left out of the text). A document older than two hours is marked stale; when no document can be read the answer has outcome unavailable and the address of Caltrans QuickMap, the live map.
327
331
 
328
332
  Examples:
@@ -334,7 +338,7 @@ Annotations: read-only true, destructive false, idempotent true, open-world fals
334
338
 
335
339
  | Input | Type | Meaning |
336
340
  |---|---|---|
337
- | `route` (required) | string (min length 1, max length 60) | The highway in California: "I-80", "80", "US 50", "Highway 50", "I-15" or "I-5" |
341
+ | `route` (required) | string (min length 1, max length 60) | The highway in California: "I-80", "US 50", "Highway 89", "SR 28", "SR-267", "Highway 88", "I-15", "I-5" or "US 395"; a stretch name ("Emerald Bay") works too |
338
342
  | `from_mile` | number (min 0, max 1000) | Start of a mile range on the route (the road-trip guide's miles) |
339
343
  | `to_mile` | number (min 0, max 1000) | End of a mile range on the route |
340
344
  | `town` | string (min length 2, max length 80) | A town or named stretch on the route ("Truckee", "Donner Pass", "South Lake Tahoe", "Cajon Pass", "Barstow") |
@@ -349,7 +353,7 @@ Output fields: `as_of`, `license`, `attribution_text`, `attribution_url`, `outco
349
353
  **Nearest emergency vet** · since 0.6.0
350
354
 
351
355
  Where is the nearest 24-hour or emergency animal hospital to this town, landmark or point: "my dog ate something near Kettleman City", "emergency vet near South Lake Tahoe tonight"?
352
- Returns the nearest hospitals with address, phone number, whether they are open 24 hours every day or take emergencies in published hours, the straight-line distance, the hospital's own page and the date it was read. Mountain and desert stretches often have none close: the answer then names the nearest one anyway with its distance.
356
+ Returns the nearest hospitals with address, phone number, whether they are open 24 hours every day or take emergencies in published hours, any hours the hospital publishes for an upcoming holiday such as Thanksgiving, the straight-line distance, the hospital's own page and the date it was read. Mountain and desert stretches often have none close: the answer then names the nearest one anyway with its distance.
353
357
  It gives where, when and the phone number only: never medical advice. Tell the traveler to call ahead.
354
358
  Inputs: place as people say it (a city, county, neighborhood, airport) or near={lat, lon}; radius_miles (default 60, up to 200); open_24h_only (default false).
355
359
 
@@ -492,7 +496,7 @@ Output fields: `outcome`, `code`, `message`, `did_you_mean`, `nearest`, `next`,
492
496
 
493
497
  | URI | What | Type |
494
498
  |---|---|---|
495
- | `ui://dogpolicies/trip-card` | An interactive card for trip plans, nearby places, road-trip stops and emergency vets: each place's dog rule, a dot map from the records' own coordinates, and links to the pages. MCP Apps hosts draw it beside the answer. | text/html;profile=mcp-app |
499
+ | `ui://dogpolicies/trip-card` | An interactive card for trip plans, nearby places, road-trip stops and emergency vets: each place's dog rule, a map of the places with the coast, lakes and highways, and links to the pages. MCP Apps hosts draw it beside the answer. | text/html;profile=mcp-app |
496
500
  | `dogpolicies://about` | What the data is, how to cite it, the license and the tool list | text/markdown |
497
501
  | `dogpolicies://status` | Data version and origin, counts, and this process's call statistics (nothing leaves the machine) | application/json |
498
502
  | `dogpolicies://answers` | Every ready-made question with its slug and result count | text/markdown |
package/package.json CHANGED
@@ -1,12 +1,12 @@
1
1
  {
2
2
  "name": "dogpolicies-mcp",
3
- "version": "0.6.0",
3
+ "version": "0.6.1",
4
4
  "description": "MCP server for verified dog rules at California and Nevada parks, beaches, trails, hotels, campgrounds and restaurant patios: leash rules, pet fees, weight limits, trip planning, every fact with its official source and the date it was checked.",
5
5
  "mcpName": "io.github.xultrax-web/dogpolicies-mcp",
6
6
  "type": "module",
7
7
  "license": "MIT",
8
8
  "author": "DogPolicies (https://dogpolicies.com)",
9
- "homepage": "https://github.com/xultrax-web/dogpolicies-mcp#readme",
9
+ "homepage": "https://dogpolicies.com/mcp/about/",
10
10
  "repository": {
11
11
  "type": "git",
12
12
  "url": "git+https://github.com/xultrax-web/dogpolicies-mcp.git",
@@ -29,6 +29,7 @@
29
29
  "src/",
30
30
  "types/",
31
31
  "data/snapshot.json.gz",
32
+ "data/LICENSE.md",
32
33
  "server.json",
33
34
  "README.md",
34
35
  "CHANGELOG.md",
package/server.json CHANGED
@@ -17,13 +17,13 @@
17
17
  "url": "https://github.com/xultrax-web/dogpolicies-mcp",
18
18
  "source": "github"
19
19
  },
20
- "version": "0.6.0",
20
+ "version": "0.6.1",
21
21
  "packages": [
22
22
  {
23
23
  "registryType": "npm",
24
24
  "registryBaseUrl": "https://registry.npmjs.org",
25
25
  "identifier": "dogpolicies-mcp",
26
- "version": "0.6.0",
26
+ "version": "0.6.1",
27
27
  "runtimeHint": "npx",
28
28
  "transport": {
29
29
  "type": "stdio"
@@ -57,7 +57,7 @@
57
57
  "tool": "dogpolicies-release",
58
58
  "license": "code MIT; data CC BY 4.0 (chain-hotel names and locations ODbL)",
59
59
  "coverage": "California and Nevada",
60
- "tools": 17
60
+ "tools": 18
61
61
  }
62
62
  }
63
63
  }
@@ -217,6 +217,12 @@ export function createToolServer({
217
217
  async function runTool(tool, args, ctx) {
218
218
  if (!tool.invalidAnswer) return tool.handler(args, ctx);
219
219
  const raw = args && typeof args === "object" ? args : {};
220
+ // A tool with emptyAnswer says what it needs when called with nothing to go on (decision 136).
221
+ if (
222
+ tool.emptyAnswer &&
223
+ !Object.keys(raw).some((k) => k !== "response_format")
224
+ )
225
+ return tool.emptyAnswer(raw);
220
226
  const checked = await tool.inputSchema["~standard"].validate(raw);
221
227
  if (checked.issues?.length) return tool.invalidAnswer(checked.issues, raw, tool);
222
228
  return withResolved(
@@ -97,7 +97,7 @@ export function readConfig({ env = process.env, overrides = {} } = {}) {
97
97
  // Public correction tickets for changes_since / changes_near, read by the hosted
98
98
  // Worker from its database: `async ({since, limit}) => ({items, total})`.
99
99
  corrections: overrides.corrections ?? null,
100
- // The same for any route the conditions loop serves (I-5, I-80, US-50, I-15),
100
+ // The same for any route the conditions loop serves (I-5, I-80, US-50, I-15, US-395 and the Lake Tahoe highways),
101
101
  // for dogpolicies_road_conditions. `async (route) => doc | null`.
102
102
  roadConditions: overrides.roadConditions ?? null,
103
103
  };
@@ -98,9 +98,23 @@ function leadCitation(p, lead) {
98
98
  * sentence leads answer and citation while a seasonal rule applies or starts
99
99
  * within 14 days.
100
100
  */
101
+ /** A food business's holiday hours that have not passed on `today`, oldest first. */
102
+ export function upcomingHolidays(holidays, today) {
103
+ return (holidays ?? [])
104
+ .filter((h) => h.date >= today)
105
+ .sort((a, b) => a.date.localeCompare(b.date))
106
+ .map((h) => ({
107
+ date: h.date,
108
+ ...(h.holiday ? { holiday: h.holiday } : {}),
109
+ open: h.open,
110
+ ...(h.hours ? { hours: h.hours } : {}),
111
+ }));
112
+ }
113
+
101
114
  export function summary(p, today, extra = {}) {
102
115
  const seasonal = todayFor(p, today);
103
116
  const lead = seasonal?.sentence ?? null;
117
+ const holidays = upcomingHolidays(p.facts?.holidays?.value, today);
104
118
  return {
105
119
  id: p.id,
106
120
  uid: p.uid,
@@ -120,6 +134,10 @@ export function summary(p, today, extra = {}) {
120
134
  answer: lead ? `${lead} ${p.answer}` : p.answer,
121
135
  citation: lead ? leadCitation(p, lead) : p.citation,
122
136
  ...(seasonal ? { today: seasonal } : {}),
137
+ // Meals a food business says it serves, and its published hours on a named
138
+ // day that has not passed (decision 139).
139
+ ...(p.facts?.meals ? { meals: p.facts.meals.value } : {}),
140
+ ...(holidays.length ? { holiday_hours: holidays } : {}),
123
141
  brand_policy: p.brand_policy,
124
142
  confidence: p.confidence,
125
143
  confirmed_by: p.confirmed_by,
@@ -226,6 +244,12 @@ export const TodayBlock = z
226
244
  .describe(
227
245
  "Only for a place with seasonal dog rules (plover nesting season, summer beach hours): which applies on the server's date, until when, and which starts next, with the source. Repeat sentence with the answer.",
228
246
  );
247
+ export const HolidayHoursItem = z.looseObject({
248
+ date: z.string().describe("The day the hours are for (YYYY-MM-DD)"),
249
+ holiday: z.string().optional().describe("The day's name as published"),
250
+ open: z.boolean().describe("false: the business or hospital says it is closed that day"),
251
+ hours: z.string().optional().describe("The hours as published"),
252
+ });
229
253
  export const PlaceItem = z.looseObject({
230
254
  id: z.string(),
231
255
  uid: z.string().describe("Stable id that survives a rename"),
@@ -238,6 +262,14 @@ export const PlaceItem = z.looseObject({
238
262
  "The one-line answer; while a seasonal rule applies today it leads with it (see today)",
239
263
  ),
240
264
  today: TodayBlock.optional(),
265
+ meals: z
266
+ .array(z.enum(["breakfast", "brunch", "lunch", "dinner"]))
267
+ .optional()
268
+ .describe("Meals a restaurant or cafe says it serves"),
269
+ holiday_hours: z
270
+ .array(HolidayHoursItem)
271
+ .optional()
272
+ .describe("Hours the business publishes for a named day that has not passed"),
241
273
  citation: z
242
274
  .string()
243
275
  .describe(
@@ -4,7 +4,7 @@
4
4
  import * as z from "zod/v4";
5
5
  import { READ_ONLY } from "../../core/server.mjs";
6
6
  import { result } from "../../core/result.mjs";
7
- import { Envelope, OutcomeFields, formatSchema } from "./common.mjs";
7
+ import { Envelope, HolidayHoursItem, OutcomeFields, formatSchema } from "./common.mjs";
8
8
  import { resolveScope, scopeAnswer, scopeSchema } from "./scope.mjs";
9
9
  import { flag } from "./tolerant.mjs";
10
10
  import { CARD_URI } from "../ui/trip-card.mjs";
@@ -21,6 +21,10 @@ const VetItem = z.looseObject({
21
21
  website: z.string(),
22
22
  emergency: z.enum(["24_7", "emergency_hours"]),
23
23
  hours: z.string().optional(),
24
+ holiday_hours: z
25
+ .array(HolidayHoursItem)
26
+ .optional()
27
+ .describe("Hours on a named day that has not passed, from the hospital's own page"),
24
28
  distance_miles: z.number().optional(),
25
29
  verified_at: z.string(),
26
30
  source_url: z.string(),
@@ -33,7 +37,7 @@ export const emergencyVet = (ctx) => ({
33
37
  cache: true,
34
38
  ui: { resourceUri: CARD_URI },
35
39
  description: `Where is the nearest 24-hour or emergency animal hospital to this town, landmark or point: "my dog ate something near Kettleman City", "emergency vet near South Lake Tahoe tonight"?
36
- Returns the nearest hospitals with address, phone number, whether they are open 24 hours every day or take emergencies in published hours, the straight-line distance, the hospital's own page and the date it was read. Mountain and desert stretches often have none close: the answer then names the nearest one anyway with its distance.
40
+ Returns the nearest hospitals with address, phone number, whether they are open 24 hours every day or take emergencies in published hours, any hours the hospital publishes for an upcoming holiday such as Thanksgiving, the straight-line distance, the hospital's own page and the date it was read. Mountain and desert stretches often have none close: the answer then names the nearest one anyway with its distance.
37
41
  It gives where, when and the phone number only: never medical advice. Tell the traveler to call ahead.
38
42
  Inputs: place as people say it (a city, county, neighborhood, airport) or near={lat, lon}; radius_miles (default 60, up to 200); open_24h_only (default false).
39
43
 
@@ -0,0 +1,39 @@
1
+ // One working call per tool, shown in the answer to a call that came without what the tool needs (decision 136).
2
+ // A test runs every example through the tool's own schema, so an example cannot drift from the tool.
3
+
4
+ export const EXAMPLES = Object.freeze({
5
+ dogpolicies_search_places: { query: "Point Lobos" },
6
+ dogpolicies_near: { place: "Carmel" },
7
+ dogpolicies_get_place: { id: "carmel-beach" },
8
+ dogpolicies_compare_places: { ids: ["carmel-beach", "fiesta-island"] },
9
+ dogpolicies_plan_trip: { place: "Lake Tahoe", nights: 3, dogs: 2 },
10
+ dogpolicies_find_hotels: {
11
+ county: "Monterey",
12
+ dog_weight_lb: 70,
13
+ max_total_fee: 50,
14
+ },
15
+ dogpolicies_get_brand_policy: { brand: "motel-6" },
16
+ dogpolicies_browse_answers: { slug: "off-leash-dog-beaches-california" },
17
+ dogpolicies_route_stops: {
18
+ route: "I-5",
19
+ direction: "north",
20
+ from_mile: 200,
21
+ to_mile: 300,
22
+ },
23
+ dogpolicies_i5_corridor: { from_mile: 200, to_mile: 300 },
24
+ dogpolicies_i5_conditions: {},
25
+ dogpolicies_road_conditions: { route: "I-80" },
26
+ dogpolicies_emergency_vet: { place: "Kettleman City" },
27
+ dogpolicies_get_rule: { id: "carmel-beach" },
28
+ dogpolicies_changes_since: { since: "2026-10-01" },
29
+ dogpolicies_changes_near: { place: "Carmel", since: "2026-10-01" },
30
+ dogpolicies_subscribe_changes: { route: "I-80" },
31
+ dogpolicies_report_correction: {
32
+ place_id: "carmel-beach",
33
+ message: "The sign now says dogs must be on a 6 foot leash.",
34
+ },
35
+ });
36
+
37
+ /** The example as a call in words: `dogpolicies_get_place {"id":"carmel-beach"}`. */
38
+ export const exampleCall = (name) =>
39
+ EXAMPLES[name] ? `${name} ${JSON.stringify(EXAMPLES[name])}` : null;
@@ -43,7 +43,7 @@ export const findHotels = (ctx) => ({
43
43
  since: "0.1.0",
44
44
  cache: true,
45
45
  description: `Will a hotel take my dog, and what will the pet fee come to: a 70 lb Lab under $50, two dogs for three nights near Palm Springs, the Motel 6 in Fresno?
46
- Does the weight, dog-count and fee arithmetic for the stay, hotel by hotel, against each hotel's published pet policy.
46
+ Does the weight, dog-count and fee arithmetic for the stay, hotel by hotel, against each hotel's published pet policy. It answers for stays at specific hotels, not for a chain's policy in general, and it lists no other kind of place.
47
47
  Inputs: query (hotel name, city or brand), brand, county without "County", state "CA" or "NV", area (lake-tahoe, big-sur, east-bay), region, or near={lat, lon}; dog_weight_lb, dogs, nights, max_total_fee.
48
48
  Each hotel is a match, a possible (needs a call: case by case, weight unstated, "up to" fee) or excluded, with the arithmetic spelled out, the source URL and verified date. Amounts are pet fees, never room rates: there are no room prices here.
49
49
 
@@ -20,13 +20,25 @@ import { i5Corridor } from "./i5-corridor.mjs";
20
20
  import { i5Conditions } from "./i5-conditions.mjs";
21
21
  import { roadConditions } from "./road-conditions.mjs";
22
22
  import { emergencyVet } from "./emergency-vet.mjs";
23
- import { invalidInput } from "./invalid.mjs";
23
+ import { emptyCall, invalidInput } from "./invalid.mjs";
24
+
25
+ // A tool whose arguments are all optional, but whose call with none would only list the whole data set,
26
+ // answers what it needs instead (decision 136). Only a call with no arguments at all (response_format
27
+ // aside) gets it; a call that sends limit or offset alone still lists, as before.
28
+ const NEEDS_SOMETHING = {
29
+ dogpolicies_search_places:
30
+ "a query (a place name), a type, a county or area, or near={lat, lon}",
31
+ dogpolicies_find_hotels:
32
+ "a query (a hotel, city or airport), a brand, a county or area, near={lat, lon}, dog_weight_lb or max_total_fee",
33
+ };
24
34
 
25
35
  // Every tool answers arguments it cannot use instead of refusing them (decision 111).
26
- const tolerant = (make) => (ctx) => ({
27
- ...make(ctx),
28
- invalidAnswer: invalidInput(ctx),
29
- });
36
+ const tolerant = (make) => (ctx) => {
37
+ const tool = { ...make(ctx), invalidAnswer: invalidInput(ctx) };
38
+ const needs = NEEDS_SOMETHING[tool.name];
39
+ if (needs) tool.emptyAnswer = (args) => emptyCall(ctx, tool, args, needs);
40
+ return tool;
41
+ };
30
42
 
31
43
  export const tools = [
32
44
  searchPlaces,
@@ -6,6 +6,7 @@
6
6
  // satisfies the tool's output schema with empty lists and zero counts.
7
7
 
8
8
  import { answer } from "./common.mjs";
9
+ import { exampleCall } from "./examples.mjs";
9
10
 
10
11
  // Enum values that claim nothing, preferred when an empty answer must fill an enum field.
11
12
  const NEUTRAL_ENUM_VALUES = new Set(["unknown", "unspecified", "not_stated", "unstated", "none"]);
@@ -145,11 +146,13 @@ export function invalidInput(ctx) {
145
146
  problems.push(text);
146
147
  }
147
148
  }
149
+ const example = exampleCall(tool.name);
148
150
  const message = `These arguments cannot be used as given: ${problems.join(" ")}`;
149
151
  const next = [
150
152
  ...Object.entries(accepted).map(
151
153
  ([k, v]) => `${k} takes: ${v.join(", ")}`,
152
154
  ),
155
+ ...(example ? [`Example: ${example}`] : []),
153
156
  `Call ${tool.name} again with corrected arguments; nothing was searched`,
154
157
  ];
155
158
  const format = args?.response_format === "json" ? "json" : "markdown";
@@ -175,3 +178,29 @@ export function invalidInput(ctx) {
175
178
  });
176
179
  };
177
180
  }
181
+
182
+ /**
183
+ * The answer to a call that names nothing to look for (decision 136): what the tool needs, one example, and
184
+ * nothing searched. Used by the tools whose every argument is optional but whose empty call would only list
185
+ * the whole data set.
186
+ */
187
+ export function emptyCall(ctx, tool, args, needs) {
188
+ const example = exampleCall(tool.name);
189
+ const message = `${tool.name} needs something to look for: ${needs}.`;
190
+ const next = [
191
+ ...(example ? [`Example: ${example}`] : []),
192
+ `Call ${tool.name} again with at least one of these; nothing was searched`,
193
+ ];
194
+ return answer({
195
+ outcome: "bad_input",
196
+ code: "invalid",
197
+ message,
198
+ shape: {
199
+ ...emptyOf(tool.outputSchema),
200
+ ...ctx.citations.envelope(ctx.graph.as_of),
201
+ },
202
+ next,
203
+ format: args?.response_format === "json" ? "json" : "markdown",
204
+ text: ["# Nothing to look for yet", "", message, "", ...next.map((n) => `- ${n}`)].join("\n"),
205
+ });
206
+ }
@@ -77,7 +77,7 @@ export const planTrip = (ctx) => ({
77
77
  // The I-5 leg skips rest areas Caltrans reports closed (a live feed): an answer holds five minutes.
78
78
  cacheTtlMs: 5 * 60_000,
79
79
  description: `Plan a dog trip to a town: where can we stay with this dog, what is the pet fee for all the nights, what can we do each day, where can we eat?
80
- One answer covers a whole stay, such as "three nights in Monterey with our 70 lb Lab, pet fees under $150" or "camping near Mammoth Lakes".
80
+ One answer covers a whole stay, such as "three nights in Monterey with our 70 lb Lab, pet fees under $150" or "camping near Mammoth Lakes". It plans a stay at one destination, not the stops along a drive.
81
81
  Inputs: place (a city, county, neighborhood, area or region, with small spelling slips corrected) or near={lat, lon}; dog_weight_lb, dogs, nights, max_total_fee, stay_types. Optional: start_date (dates each day), stay_id (build the plan on that stay), save=true (adds trip_url, a dogpolicies.com page showing the plan; the plan travels inside the link, nothing is stored).
82
82
  Returns stays that fit with the whole-stay pet fee worked out (a pet fee, never a room rate), stays that need a call to confirm, and "days": for each night the stay, a morning beach, trail or off-leash area, an afternoon park and a dinner patio, each a real record with source URL and verified date; a slot the data cannot fill is null with the reason (dinner often is). "plan_stay" shows the fee arithmetic and whether the dog's weight and number fit. Within 10 miles of I-5 in California it adds the drive leg: the town's mile and the next family stops each way. An unknown town is an answer with did_you_mean. The markdown answer is laid out as a trip document for the traveler.
83
83