@oneshot-agent/mcp-server 0.36.0 → 0.38.0

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.
Files changed (18) hide show
  1. package/README.md +19 -15
  2. package/dist/index.js +1 -1
  3. package/dist/tools/annotations.js +12 -12
  4. package/dist/tools/commerce.d.ts +2 -2
  5. package/dist/tools/commerce.js +5 -5
  6. package/dist/tools/company.d.ts +4 -4
  7. package/dist/tools/company.js +8 -8
  8. package/dist/tools/enrichment.d.ts +6 -6
  9. package/dist/tools/enrichment.js +15 -13
  10. package/dist/tools/index.js +29 -29
  11. package/dist/tools/linkedin.js +2 -2
  12. package/dist/tools/local.js +1 -1
  13. package/dist/tools/lookup-manifest.generated.js +284 -96
  14. package/dist/tools/nyne.d.ts +11 -11
  15. package/dist/tools/nyne.js +25 -23
  16. package/dist/tools/people.d.ts +2 -2
  17. package/dist/tools/people.js +7 -5
  18. package/package.json +2 -2
package/dist/tools/lookup-manifest.generated.js CHANGED
@@ -12,15 +12,15 @@ export const LOOKUP_MANIFEST = [
12
12
  "properties": {
13
13
  "name": {
14
14
  "type": "string",
15
- "description": "The bank's name, 2 to 100 characters, for example Grasshopper Bank. A text match: similarly named banks are returned too"
15
+ "description": "The bank's name, for example Grasshopper Bank. A text match: similarly named banks are returned too. 2 to 100 characters."
16
16
  },
17
17
  "fdic_certificate": {
18
18
  "type": "integer",
19
- "description": "The FDIC certificate number, for example 59113. An exact match; preferred over a name"
19
+ "description": "The FDIC certificate number, for example 59113. An exact match; preferred over a name. At least 1."
20
20
  },
21
21
  "limit": {
22
22
  "type": "integer",
23
- "description": "Most banks to return (1 to 10, default 5)"
23
+ "description": "Most banks to return. From 1 to 10. Defaults to `5`."
24
24
  }
25
25
  },
26
26
  "required": []
@@ -39,11 +39,11 @@ export const LOOKUP_MANIFEST = [
39
39
  "properties": {
40
40
  "condition": {
41
41
  "type": "string",
42
- "description": "A condition or disease, for example psoriasis"
42
+ "description": "A condition or disease, for example psoriasis. 2 to 120 characters."
43
43
  },
44
44
  "query": {
45
45
  "type": "string",
46
- "description": "A treatment or other search words, for example secukinumab"
46
+ "description": "A treatment or other search words, for example secukinumab. 2 to 200 characters."
47
47
  },
48
48
  "status": {
49
49
  "type": "string",
@@ -56,11 +56,11 @@ export const LOOKUP_MANIFEST = [
56
56
  "withdrawn",
57
57
  "suspended"
58
58
  ],
59
- "description": "Only studies with this status: recruiting, not_yet_recruiting, active_not_recruiting, completed, terminated, withdrawn or suspended"
59
+ "description": "Only studies with this status"
60
60
  },
61
61
  "limit": {
62
62
  "type": "integer",
63
- "description": "The most studies to return. Default 10"
63
+ "description": "The most studies to return. From 1 to 20. Defaults to `10`."
64
64
  }
65
65
  },
66
66
  "required": []
@@ -82,23 +82,23 @@ export const LOOKUP_MANIFEST = [
82
82
  "properties": {
83
83
  "cik": {
84
84
  "type": "string",
85
- "description": "The 1 to 10 digit registry identifier (CIK), for example 320193. Shorter numbers are padded with zeros"
85
+ "description": "The registry identifier (CIK), for example 320193. Shorter numbers are padded with zeros. A CIK is 1 to 10 digits."
86
86
  },
87
87
  "form": {
88
88
  "type": "string",
89
- "description": "Only filings of this exact form type, for example 10-K"
89
+ "description": "Only filings of this exact form type, for example 10-K. 1 to 20 characters."
90
90
  },
91
91
  "filed_after": {
92
92
  "type": "string",
93
- "description": "Only filings made on or after this date, YYYY-MM-DD"
93
+ "description": "Only filings made on or after this date. Use YYYY-MM-DD."
94
94
  },
95
95
  "filed_before": {
96
96
  "type": "string",
97
- "description": "Only filings made on or before this date, YYYY-MM-DD"
97
+ "description": "Only filings made on or before this date. Use YYYY-MM-DD."
98
98
  },
99
99
  "limit": {
100
100
  "type": "integer",
101
- "description": "Most filings to return, newest first (1 to 50, default 10)"
101
+ "description": "Most filings to return, newest first. From 1 to 50. Defaults to `10`."
102
102
  }
103
103
  },
104
104
  "required": [
@@ -121,15 +121,15 @@ export const LOOKUP_MANIFEST = [
121
121
  "properties": {
122
122
  "company_name": {
123
123
  "type": "string",
124
- "description": "The financial company's name, 2 to 100 characters, for example Wells Fargo"
124
+ "description": "The financial company's name, for example Wells Fargo. 2 to 100 characters."
125
125
  },
126
126
  "since": {
127
127
  "type": "string",
128
- "description": "Count only complaints received on or after this date, YYYY-MM-DD; default all"
128
+ "description": "Count only complaints received on or after this date. Use YYYY-MM-DD."
129
129
  },
130
130
  "limit": {
131
131
  "type": "integer",
132
- "description": "Most complaints to return, newest first, 1 to 25; default 10"
132
+ "description": "Most complaints to return, newest first. From 1 to 25. Defaults to `10`."
133
133
  }
134
134
  },
135
135
  "required": [
@@ -141,6 +141,65 @@ export const LOOKUP_MANIFEST = [
141
141
  "limit": 1
142
142
  }
143
143
  },
144
+ {
145
+ "name": "record_court_cases_find",
146
+ "path": "find/record-court-cases",
147
+ "title": "Court Cases",
148
+ "description": "Search a public archive of published US federal and state court opinions, or choose kind=dockets to search federal cases and their filings. Returns case names, courts, filing dates, citations when available, docket numbers, short excerpts and links, ordered by relevance. For opinions, the filing date is the decision date; for dockets, it is when the case was filed. Coverage varies by court and does not include every case or filing. Only the first page is read, with at most limit matches returned. Docket totals above 2,000 are approximate, with up to 6% error. An excerpt is the start of an opinion or a matching filing, at most 500 characters; it is not a case summary. Open the URL for the source record. The source's terms prohibit using this data for credit, insurance, employment, housing or other eligibility decisions covered by the Fair Credit Reporting Act.",
149
+ "inputSchema": {
150
+ "type": "object",
151
+ "properties": {
152
+ "query": {
153
+ "type": "string",
154
+ "description": "Search words, with quotes for an exact phrase and AND, OR or NOT between terms, for example patent. 1 to 500 characters."
155
+ },
156
+ "kind": {
157
+ "type": "string",
158
+ "enum": [
159
+ "opinions",
160
+ "dockets"
161
+ ],
162
+ "description": "opinions searches published federal and state decisions; dockets searches federal cases and their filings. Default opinions. Defaults to `\"opinions\"`."
163
+ },
164
+ "court": {
165
+ "type": "string",
166
+ "description": "Only this court, by its short court ID, for example scotus, cafc or txed"
167
+ },
168
+ "filed_after": {
169
+ "type": "string",
170
+ "description": "Only cases filed on or after this date, YYYY-MM-DD; for opinions, this is the decision date"
171
+ },
172
+ "filed_before": {
173
+ "type": "string",
174
+ "description": "Only cases filed on or before this date, YYYY-MM-DD; for opinions, this is the decision date"
175
+ },
176
+ "case_name": {
177
+ "type": "string",
178
+ "description": "Search within case names, for example Merck. 1 to 200 characters."
179
+ },
180
+ "docket_number": {
181
+ "type": "string",
182
+ "description": "Search within docket numbers, for example 23-1027. 1 to 100 characters."
183
+ },
184
+ "limit": {
185
+ "type": "integer",
186
+ "description": "The most matches to return from the first page, from 1 to 20. Default 10. From 1 to 20. Defaults to `10`."
187
+ }
188
+ },
189
+ "required": [
190
+ "query"
191
+ ]
192
+ },
193
+ "example": {
194
+ "query": "patent",
195
+ "court": "cafc",
196
+ "case_name": "Merck",
197
+ "docket_number": "23-1027",
198
+ "filed_after": "2025-01-01",
199
+ "filed_before": "2025-12-31",
200
+ "limit": 1
201
+ }
202
+ },
144
203
  {
145
204
  "name": "place_disasters",
146
205
  "path": "lookup/place-disasters",
@@ -151,27 +210,27 @@ export const LOOKUP_MANIFEST = [
151
210
  "properties": {
152
211
  "state": {
153
212
  "type": "string",
154
- "description": "Two-letter state postal code, for example TX"
213
+ "description": "State postal code. A state is its two-letter postal code, for example TX."
155
214
  },
156
215
  "county": {
157
216
  "type": "string",
158
- "description": "County or parish name without the word County or Parish, for example Harris"
217
+ "description": "County or parish name without the word County or Parish, for example Harris. A county name has 2 to 40 letters, spaces, periods, apostrophes and hyphens, without \"County\" or \"Parish\"."
159
218
  },
160
219
  "incident_type": {
161
220
  "type": "string",
162
- "description": "Only declarations for this incident type, for example Flood, Hurricane, Fire, Tornado, Severe Storm"
221
+ "description": "Only declarations for this incident type. An incident type is words such as Flood, Hurricane or Fire."
163
222
  },
164
223
  "declared_after": {
165
224
  "type": "string",
166
- "description": "Only declarations made on or after this date (YYYY-MM-DD)"
225
+ "description": "Only declarations made on or after this date. Use YYYY-MM-DD."
167
226
  },
168
227
  "declared_before": {
169
228
  "type": "string",
170
- "description": "Only declarations made on or before this date (YYYY-MM-DD)"
229
+ "description": "Only declarations made on or before this date. Use YYYY-MM-DD."
171
230
  },
172
231
  "limit": {
173
232
  "type": "integer",
174
- "description": "Most declarations to return, newest first. Default 25"
233
+ "description": "Most declarations to return, newest first. Default 25. From 1 to 100."
175
234
  }
176
235
  },
177
236
  "required": [
@@ -198,11 +257,11 @@ export const LOOKUP_MANIFEST = [
198
257
  "properties": {
199
258
  "drug_name": {
200
259
  "type": "string",
201
- "description": "The drug's name as it appears on the reports, for example Ozempic or metformin"
260
+ "description": "The drug's name as it appears on the reports, for example Ozempic or metformin. 2 to 100 characters."
202
261
  },
203
262
  "limit": {
204
263
  "type": "integer",
205
- "description": "The most reactions to return. Default 10"
264
+ "description": "The most reactions to return. From 1 to 25. Defaults to `10`."
206
265
  }
207
266
  },
208
267
  "required": [
@@ -224,7 +283,7 @@ export const LOOKUP_MANIFEST = [
224
283
  "properties": {
225
284
  "drug_name": {
226
285
  "type": "string",
227
- "description": "The drug's generic or brand name, for example quinapril or sodium chloride"
286
+ "description": "The drug's generic or brand name, for example quinapril or sodium chloride. 2 to 100 characters."
228
287
  },
229
288
  "status": {
230
289
  "type": "string",
@@ -233,11 +292,11 @@ export const LOOKUP_MANIFEST = [
233
292
  "to_be_discontinued",
234
293
  "resolved"
235
294
  ],
236
- "description": "Only presentations with this status: current, to_be_discontinued or resolved. Default all three"
295
+ "description": "Only presentations with this status; all statuses when omitted"
237
296
  },
238
297
  "limit": {
239
298
  "type": "integer",
240
- "description": "The most presentations to return. Default 10"
299
+ "description": "The most presentations to return. From 1 to 25. Defaults to `10`."
241
300
  }
242
301
  },
243
302
  "required": [
@@ -260,11 +319,11 @@ export const LOOKUP_MANIFEST = [
260
319
  "properties": {
261
320
  "query": {
262
321
  "type": "string",
263
- "description": "A tariff heading such as 7408.11, or a keyword such as copper wire. Several words match any of them; wrap them in double quotes for the exact phrase"
322
+ "description": "A tariff heading such as 7408.11, or a keyword such as copper wire. Several words match any of them; wrap them in double quotes for the exact phrase. 2 to 80 characters."
264
323
  },
265
324
  "limit": {
266
325
  "type": "integer",
267
- "description": "Most lines to return, in schedule order. Default 20"
326
+ "description": "Most lines to return, in schedule order. From 1 to 50. Defaults to `20`."
268
327
  }
269
328
  },
270
329
  "required": [
@@ -286,31 +345,31 @@ export const LOOKUP_MANIFEST = [
286
345
  "properties": {
287
346
  "latitude": {
288
347
  "type": "number",
289
- "description": "Latitude in decimal degrees, -90 to 90, for example 37.77"
348
+ "description": "Latitude in decimal degrees, for example 37.77. From -90 to 90."
290
349
  },
291
350
  "longitude": {
292
351
  "type": "number",
293
- "description": "Longitude in decimal degrees, -180 to 180 (west is negative), for example -122.42"
352
+ "description": "Longitude in decimal degrees (west is negative), for example -122.42. From -180 to 180."
294
353
  },
295
354
  "radius_km": {
296
355
  "type": "number",
297
- "description": "Distance from the point in kilometres, 1 to 500; default 100"
356
+ "description": "Distance from the point in kilometres. From 1 to 500. Defaults to `100`."
298
357
  },
299
358
  "since": {
300
359
  "type": "string",
301
- "description": "Earliest date, YYYY-MM-DD (UTC); default 30 days before the call"
360
+ "description": "Earliest date (UTC); default 30 days before the call. Use YYYY-MM-DD."
302
361
  },
303
362
  "until": {
304
363
  "type": "string",
305
- "description": "Latest date, YYYY-MM-DD (UTC); default now"
364
+ "description": "Latest date (UTC); default now. Use YYYY-MM-DD."
306
365
  },
307
366
  "min_magnitude": {
308
367
  "type": "number",
309
- "description": "Smallest magnitude to return, 0 to 10; default 2.5"
368
+ "description": "Smallest magnitude to return. From 0 to 10. Defaults to `2.5`."
310
369
  },
311
370
  "limit": {
312
371
  "type": "integer",
313
- "description": "Most earthquakes to return, 1 to 50; default 10"
372
+ "description": "Most earthquakes to return. From 1 to 50. Defaults to `10`."
314
373
  }
315
374
  },
316
375
  "required": [
@@ -337,11 +396,11 @@ export const LOOKUP_MANIFEST = [
337
396
  "properties": {
338
397
  "recipient": {
339
398
  "type": "string",
340
- "description": "Recipient name, for example LOCKHEED MARTIN CORPORATION. A text match: similarly named recipients are returned too"
399
+ "description": "Recipient name, for example LOCKHEED MARTIN CORPORATION. A text match: similarly named recipients are returned too. 3 to 120 characters."
341
400
  },
342
401
  "uei": {
343
402
  "type": "string",
344
- "description": "The recipient's 12-character Unique Entity Identifier. Preferred over a name"
403
+ "description": "The recipient's Unique Entity Identifier. Preferred over a name. A UEI is 12 letters and digits."
345
404
  },
346
405
  "kind": {
347
406
  "type": "string",
@@ -349,19 +408,19 @@ export const LOOKUP_MANIFEST = [
349
408
  "contracts",
350
409
  "grants"
351
410
  ],
352
- "description": "Which group of awards to list: contracts, or grants"
411
+ "description": "Which group of awards to list"
353
412
  },
354
413
  "active_after": {
355
414
  "type": "string",
356
- "description": "Start of the period to search, YYYY-MM-DD, not before 2007-10-01. Default: three years before active_before"
415
+ "description": "Start of the period to search, not before 2007-10-01. Default: three years before active_before. Use YYYY-MM-DD."
357
416
  },
358
417
  "active_before": {
359
418
  "type": "string",
360
- "description": "End of the period to search, YYYY-MM-DD. Default: today"
419
+ "description": "End of the period to search. Default: today. Use YYYY-MM-DD."
361
420
  },
362
421
  "limit": {
363
422
  "type": "integer",
364
- "description": "Most awards to return, largest first (1 to 25, default 10)"
423
+ "description": "Most awards to return, largest first. From 1 to 25. Defaults to `10`."
365
424
  }
366
425
  },
367
426
  "required": [
@@ -384,11 +443,11 @@ export const LOOKUP_MANIFEST = [
384
443
  "properties": {
385
444
  "role": {
386
445
  "type": "string",
387
- "description": "Words to look up, for example software engineer. Matched as a keyword search across labor category, contractor name and contract number, so some rates may not be for that job title"
446
+ "description": "Words to look up, for example software engineer. Matched as a keyword search across labor category, contractor name and contract number, so some rates may not be for that job title. 2 to 80 characters."
388
447
  },
389
448
  "min_years_experience": {
390
449
  "type": "integer",
391
- "description": "Only rates for roles that ask for at least this many years of experience"
450
+ "description": "Only rates for roles that ask for at least this many years of experience. From 0 to 45."
392
451
  },
393
452
  "education": {
394
453
  "type": "string",
@@ -403,7 +462,7 @@ export const LOOKUP_MANIFEST = [
403
462
  },
404
463
  "limit": {
405
464
  "type": "integer",
406
- "description": "The most rates to list. Default 10. The summary always covers every match"
465
+ "description": "The most rates to list. The summary always covers every match. From 1 to 25. Defaults to `10`."
407
466
  }
408
467
  },
409
468
  "required": [
@@ -425,7 +484,7 @@ export const LOOKUP_MANIFEST = [
425
484
  "properties": {
426
485
  "query": {
427
486
  "type": "string",
428
- "description": "Search words, for example drone registration"
487
+ "description": "Search words, for example drone registration. 2 to 200 characters."
429
488
  },
430
489
  "type": {
431
490
  "type": "string",
@@ -435,23 +494,23 @@ export const LOOKUP_MANIFEST = [
435
494
  "notice",
436
495
  "presidential"
437
496
  ],
438
- "description": "Only this kind of document: rule, proposed_rule, notice or presidential"
497
+ "description": "Only this kind of document"
439
498
  },
440
499
  "agency": {
441
500
  "type": "string",
442
- "description": "Only documents from this agency, as its Federal Register slug, for example federal-aviation-administration"
501
+ "description": "Only documents from this agency, as its Federal Register slug, for example federal-aviation-administration. 2 to 80 characters."
443
502
  },
444
503
  "published_after": {
445
504
  "type": "string",
446
- "description": "Only documents published on or after this date, YYYY-MM-DD"
505
+ "description": "Only documents published on or after this date. Use YYYY-MM-DD."
447
506
  },
448
507
  "published_before": {
449
508
  "type": "string",
450
- "description": "Only documents published on or before this date, YYYY-MM-DD"
509
+ "description": "Only documents published on or before this date. Use YYYY-MM-DD."
451
510
  },
452
511
  "limit": {
453
512
  "type": "integer",
454
- "description": "The most documents to return. Default 10"
513
+ "description": "The most documents to return. From 1 to 20. Defaults to `10`."
455
514
  }
456
515
  },
457
516
  "required": [
@@ -474,11 +533,11 @@ export const LOOKUP_MANIFEST = [
474
533
  "properties": {
475
534
  "latitude": {
476
535
  "type": "number",
477
- "description": "Latitude in decimal degrees, 17 to 72"
536
+ "description": "Latitude in decimal degrees. From 17 to 72."
478
537
  },
479
538
  "longitude": {
480
539
  "type": "number",
481
- "description": "Longitude in decimal degrees, -180 to -64"
540
+ "description": "Longitude in decimal degrees. From -180 to -64."
482
541
  }
483
542
  },
484
543
  "required": [
@@ -491,6 +550,76 @@ export const LOOKUP_MANIFEST = [
491
550
  "longitude": -95.3698
492
551
  }
493
552
  },
553
+ {
554
+ "name": "market_freight_rate",
555
+ "path": "lookup/market-freight-rate",
556
+ "title": "Freight Rate Quote",
557
+ "description": "Quote the rate to move freight between two US ZIP codes on a pickup date, by mode: ltl shares a trailer by the pallet, ftl is a whole 53-foot dry van, van is a cargo van and box_truck is a 26-foot box truck. The answer is one carrier's quote for that lane: the rate for the whole shipment with every included service, the transit time, the pickup and delivery dates, when the quote lapses and whether it is firm or indicative. Use it to check a billed freight charge against the lane's going rate. For ltl give the pallets, the weight per pallet and the pallet dimensions; for van and box_truck give the pallets and the weight per pallet; for ftl the lane and date are enough. A lane the mode does not serve is refused as invalid input: try another mode. Covers US lanes. Nothing is booked.",
558
+ "inputSchema": {
559
+ "type": "object",
560
+ "properties": {
561
+ "origin_zip": {
562
+ "type": "string",
563
+ "description": "Where the freight is collected. 5-digit US ZIP code."
564
+ },
565
+ "destination_zip": {
566
+ "type": "string",
567
+ "description": "Where the freight is delivered. 5-digit US ZIP code."
568
+ },
569
+ "mode": {
570
+ "type": "string",
571
+ "enum": [
572
+ "ltl",
573
+ "ftl",
574
+ "van",
575
+ "box_truck"
576
+ ],
577
+ "description": "How the freight moves. Picks the quote asked for; there is no default"
578
+ },
579
+ "pickup_date": {
580
+ "type": "string",
581
+ "description": "The day the freight is collected: today (UTC) or later. YYYY-MM-DD."
582
+ },
583
+ "pallets": {
584
+ "type": "integer",
585
+ "description": "How many pallets. Required for ltl, van (up to 3) and box_truck (up to 12); not needed for ftl. At least 1."
586
+ },
587
+ "weight_lbs_per_pallet": {
588
+ "type": "integer",
589
+ "description": "The weight of each pallet in pounds. Required for ltl, van (3,500 lb in all) and box_truck (10,000 lb in all); not needed for ftl. At least 1."
590
+ },
591
+ "length_in": {
592
+ "type": "integer",
593
+ "description": "The length of each pallet in inches. Required for ltl; ignored for other modes. At least 1."
594
+ },
595
+ "width_in": {
596
+ "type": "integer",
597
+ "description": "The width of each pallet in inches. Required for ltl; ignored for other modes. At least 1."
598
+ },
599
+ "height_in": {
600
+ "type": "integer",
601
+ "description": "The height of each pallet in inches, up to 85. Required for ltl; ignored for other modes. At least 1."
602
+ }
603
+ },
604
+ "required": [
605
+ "origin_zip",
606
+ "destination_zip",
607
+ "mode",
608
+ "pickup_date"
609
+ ]
610
+ },
611
+ "example": {
612
+ "origin_zip": "90012",
613
+ "destination_zip": "94105",
614
+ "mode": "ltl",
615
+ "pickup_date": "2026-10-20",
616
+ "pallets": 2,
617
+ "weight_lbs_per_pallet": 800,
618
+ "length_in": 48,
619
+ "width_in": 40,
620
+ "height_in": 48
621
+ }
622
+ },
494
623
  {
495
624
  "name": "person_health_provider",
496
625
  "path": "lookup/person-health-provider",
@@ -501,27 +630,27 @@ export const LOOKUP_MANIFEST = [
501
630
  "properties": {
502
631
  "npi": {
503
632
  "type": "string",
504
- "description": "The 10-digit provider number. Give this, or a last name and state, never both"
633
+ "description": "The health provider number. Give this, or a last name and state, never both. A health provider number is exactly 10 digits."
505
634
  },
506
635
  "last_name": {
507
636
  "type": "string",
508
- "description": "Last name of the practitioner. Needs state"
637
+ "description": "Last name of the practitioner. Needs state. 1 to 100 characters."
509
638
  },
510
639
  "state": {
511
640
  "type": "string",
512
- "description": "Two-letter US state code, such as TX. Needs last name"
641
+ "description": "US state code. Needs last name. A state is two capital letters, such as TX."
513
642
  },
514
643
  "first_name": {
515
644
  "type": "string",
516
- "description": "First name of the practitioner, to narrow a name search"
645
+ "description": "First name of the practitioner, to narrow a name search. 1 to 100 characters."
517
646
  },
518
647
  "city": {
519
648
  "type": "string",
520
- "description": "A city, to narrow a name search"
649
+ "description": "A city, to narrow a name search. 1 to 100 characters."
521
650
  },
522
651
  "limit": {
523
652
  "type": "integer",
524
- "description": "Most providers to return from a name search, 1 to 20"
653
+ "description": "Most providers to return from a name search. From 1 to 20. Defaults to `5`."
525
654
  }
526
655
  },
527
656
  "required": []
@@ -540,11 +669,11 @@ export const LOOKUP_MANIFEST = [
540
669
  "properties": {
541
670
  "zip_code": {
542
671
  "type": "string",
543
- "description": "A five-digit US ZIP code, for example 45220"
672
+ "description": "A US ZIP code, for example 45220. zip_code must be five digits."
544
673
  },
545
674
  "limit": {
546
675
  "type": "integer",
547
- "description": "The most hospitals to return. Default 10"
676
+ "description": "The most hospitals to return. From 1 to 25. Defaults to `10`."
548
677
  }
549
678
  },
550
679
  "required": [
@@ -566,15 +695,15 @@ export const LOOKUP_MANIFEST = [
566
695
  "properties": {
567
696
  "lei": {
568
697
  "type": "string",
569
- "description": "The 20-character Legal Entity Identifier, for example DPRBOZP0K5RM2YE8UU08. An exact match; preferred over a name"
698
+ "description": "The Legal Entity Identifier, for example DPRBOZP0K5RM2YE8UU08. An exact match; preferred over a name. A Legal Entity Identifier is 20 letters and digits."
570
699
  },
571
700
  "name": {
572
701
  "type": "string",
573
- "description": "Legal name, for example Lockheed Martin Corporation. A text match: similarly named entities are returned too"
702
+ "description": "Legal name, for example Lockheed Martin Corporation. A text match: similarly named entities are returned too. 2 to 200 characters."
574
703
  },
575
704
  "limit": {
576
705
  "type": "integer",
577
- "description": "Most entities to return (1 to 10, default 5)"
706
+ "description": "Most entities to return. From 1 to 10. Defaults to `5`."
578
707
  }
579
708
  },
580
709
  "required": []
@@ -593,11 +722,11 @@ export const LOOKUP_MANIFEST = [
593
722
  "properties": {
594
723
  "dot_number": {
595
724
  "type": "string",
596
- "description": "The carrier's US Department of Transportation number, 1 to 8 digits, for example 44110"
725
+ "description": "The carrier's US Department of Transportation number, for example 44110. dot_number must be 1 to 8 digits."
597
726
  },
598
727
  "mc_number": {
599
728
  "type": "string",
600
- "description": "The carrier's motor carrier (MC) number, 1 to 8 digits, with an optional MC or MC- in front, for example MC-1515"
729
+ "description": "The carrier's motor carrier (MC) number, for example MC-1515. mc_number must be 1 to 8 digits, with an optional MC or MC- in front."
601
730
  }
602
731
  },
603
732
  "required": []
@@ -616,7 +745,7 @@ export const LOOKUP_MANIFEST = [
616
745
  "properties": {
617
746
  "address": {
618
747
  "type": "string",
619
- "description": "A US street address on one line, with city and state or ZIP, for example 1600 Pennsylvania Ave NW, Washington, DC"
748
+ "description": "A US street address on one line, with city and state or ZIP, for example 1600 Pennsylvania Ave NW, Washington, DC. 5 to 200 characters."
620
749
  }
621
750
  },
622
751
  "required": [
@@ -643,19 +772,19 @@ export const LOOKUP_MANIFEST = [
643
772
  "drug",
644
773
  "device"
645
774
  ],
646
- "description": "Which products and which regulator: consumer (Consumer Product Safety Commission), or food, drug or device (Food and Drug Administration). Required"
775
+ "description": "Which products and which regulator: consumer (Consumer Product Safety Commission), or food, drug or device (Food and Drug Administration)"
647
776
  },
648
777
  "product_name": {
649
778
  "type": "string",
650
- "description": "Words from the product name, for example attic stairway. For food, drug and device: letters, digits, spaces and . , ' & - only"
779
+ "description": "Words from the product name, for example attic stairway. For food, drug and device: letters, digits, spaces and . , ' & - only. 2 to 80 characters."
651
780
  },
652
781
  "title": {
653
782
  "type": "string",
654
- "description": "Words from the recall title, for example ladder. Category consumer only"
783
+ "description": "Words from the recall title, for example ladder. Category consumer only. 2 to 80 characters."
655
784
  },
656
785
  "manufacturer": {
657
786
  "type": "string",
658
- "description": "The manufacturer, importer, distributor or retailer, for example Louisville Ladder. For food, drug and device it is the recalling firm: letters, digits, spaces and . , ' & - only"
787
+ "description": "The manufacturer, importer, distributor or retailer, for example Louisville Ladder. For food, drug and device it is the recalling firm: letters, digits, spaces and . , ' & - only. 2 to 80 characters."
659
788
  },
660
789
  "classification": {
661
790
  "type": "string",
@@ -668,15 +797,15 @@ export const LOOKUP_MANIFEST = [
668
797
  },
669
798
  "recalled_after": {
670
799
  "type": "string",
671
- "description": "Only recalls announced on or after this date, YYYY-MM-DD. Needs a product name, title or manufacturer"
800
+ "description": "Only recalls announced on or after this date. Needs a product name, title or manufacturer. Use YYYY-MM-DD."
672
801
  },
673
802
  "recalled_before": {
674
803
  "type": "string",
675
- "description": "Only recalls announced on or before this date, YYYY-MM-DD. Needs a product name, title or manufacturer"
804
+ "description": "Only recalls announced on or before this date. Needs a product name, title or manufacturer. Use YYYY-MM-DD."
676
805
  },
677
806
  "limit": {
678
807
  "type": "integer",
679
- "description": "The most recalls to return. Default 10"
808
+ "description": "The most recalls to return. From 1 to 25. Defaults to `10`."
680
809
  }
681
810
  },
682
811
  "required": [
@@ -733,7 +862,7 @@ export const LOOKUP_MANIFEST = [
733
862
  },
734
863
  "vat_number": {
735
864
  "type": "string",
736
- "description": "The VAT number, 2 to 14 letters and digits once spaces, dots and dashes are removed; a leading country code equal to country is removed"
865
+ "description": "The VAT number, 2 to 14 letters and digits once spaces, dots and dashes are removed; a leading country code equal to country is removed. 2 to 40 characters. letters, digits, spaces, dots and dashes only."
737
866
  }
738
867
  },
739
868
  "required": [
@@ -756,19 +885,19 @@ export const LOOKUP_MANIFEST = [
756
885
  "properties": {
757
886
  "make": {
758
887
  "type": "string",
759
- "description": "The vehicle make, for example Honda"
888
+ "description": "The vehicle make, for example Honda. 2 to 40 characters. Letters, digits, spaces and hyphens only."
760
889
  },
761
890
  "model": {
762
891
  "type": "string",
763
- "description": "The vehicle model, for example CR-V"
892
+ "description": "The vehicle model, for example CR-V. 1 to 60 characters. Letters, digits, spaces, periods and hyphens only."
764
893
  },
765
894
  "model_year": {
766
895
  "type": "integer",
767
- "description": "The model year, from 1950 to next year"
896
+ "description": "The model year. At least 1950. Model year cannot be later than next year."
768
897
  },
769
898
  "limit": {
770
899
  "type": "integer",
771
- "description": "The most complaints to return, newest first. Default 10"
900
+ "description": "The most complaints to return, newest first. From 1 to 25. Defaults to `10`."
772
901
  }
773
902
  },
774
903
  "required": [
@@ -794,11 +923,11 @@ export const LOOKUP_MANIFEST = [
794
923
  "properties": {
795
924
  "vin": {
796
925
  "type": "string",
797
- "description": "The 17-character vehicle identification number"
926
+ "description": "The vehicle identification number. A VIN is 17 characters: digits and capital letters, never I, O or Q."
798
927
  },
799
928
  "model_year": {
800
929
  "type": "integer",
801
- "description": "Model year, when known. Resolves the year for numbers where position 10 is ambiguous"
930
+ "description": "Model year, when known. Resolves the year for numbers where position 10 is ambiguous. From 1981 to 2100."
802
931
  }
803
932
  },
804
933
  "required": [
@@ -819,19 +948,19 @@ export const LOOKUP_MANIFEST = [
819
948
  "properties": {
820
949
  "make": {
821
950
  "type": "string",
822
- "description": "The vehicle make, for example Honda"
951
+ "description": "The vehicle make, for example Honda. 2 to 40 characters. Letters, digits, spaces and hyphens only."
823
952
  },
824
953
  "model": {
825
954
  "type": "string",
826
- "description": "The vehicle model, for example CR-V"
955
+ "description": "The vehicle model, for example CR-V. 1 to 60 characters. Letters, digits, spaces, periods and hyphens only."
827
956
  },
828
957
  "model_year": {
829
958
  "type": "integer",
830
- "description": "The model year, from 1950 to next year"
959
+ "description": "The model year. At least 1950. Model year cannot be later than next year."
831
960
  },
832
961
  "limit": {
833
962
  "type": "integer",
834
- "description": "The most recalls to return. Default 25"
963
+ "description": "The most recalls to return. From 1 to 50. Defaults to `25`."
835
964
  }
836
965
  },
837
966
  "required": [
@@ -857,7 +986,7 @@ export const LOOKUP_MANIFEST = [
857
986
  "properties": {
858
987
  "cve_id": {
859
988
  "type": "string",
860
- "description": "The CVE identifier, for example CVE-2021-44228. Lower case is accepted"
989
+ "description": "The CVE identifier, for example CVE-2021-44228. Lower case is accepted. A CVE identifier is CVE-, a four-digit year, a dash and four or more digits."
861
990
  }
862
991
  },
863
992
  "required": [
@@ -878,11 +1007,11 @@ export const LOOKUP_MANIFEST = [
878
1007
  "properties": {
879
1008
  "latitude": {
880
1009
  "type": "number",
881
- "description": "Latitude in decimal degrees, 17 to 72, for example 29.7604"
1010
+ "description": "Latitude in decimal degrees, for example 29.7604. From 17 to 72."
882
1011
  },
883
1012
  "longitude": {
884
1013
  "type": "number",
885
- "description": "Longitude in decimal degrees, -180 to -64 (west is negative), for example -95.3698"
1014
+ "description": "Longitude in decimal degrees (west is negative), for example -95.3698. From -180 to -64."
886
1015
  }
887
1016
  },
888
1017
  "required": [
@@ -905,19 +1034,19 @@ export const LOOKUP_MANIFEST = [
905
1034
  "properties": {
906
1035
  "latitude": {
907
1036
  "type": "number",
908
- "description": "Latitude in decimal degrees, -90 to 90, for example 44.7"
1037
+ "description": "Latitude in decimal degrees, for example 44.7. From -90 to 90."
909
1038
  },
910
1039
  "longitude": {
911
1040
  "type": "number",
912
- "description": "Longitude in decimal degrees, -180 to 180 (west is negative), for example -120.0"
1041
+ "description": "Longitude in decimal degrees (west is negative), for example -120.0. From -180 to 180."
913
1042
  },
914
1043
  "radius_km": {
915
1044
  "type": "number",
916
- "description": "Distance from the point in kilometres, 1 to 200; default 50"
1045
+ "description": "Distance from the point in kilometres. From 1 to 200. Defaults to `50`."
917
1046
  },
918
1047
  "limit": {
919
1048
  "type": "integer",
920
- "description": "Most fires to return, 1 to 25; default 10"
1049
+ "description": "Most fires to return. From 1 to 25. Defaults to `10`."
921
1050
  }
922
1051
  },
923
1052
  "required": [
@@ -984,6 +1113,66 @@ export const ROUTE_MANIFEST = [
984
1113
  "key": "HONDA:CR-V:2019"
985
1114
  }
986
1115
  },
1116
+ {
1117
+ "name": "place_permits",
1118
+ "method": "POST",
1119
+ "path": "/v1/tools/lookup/place-permits",
1120
+ "paid": true,
1121
+ "readOnly": true,
1122
+ "title": "Building Permits",
1123
+ "description": "Look up recorded building permits at an exact site address in Chicago or New York City. NYC coverage is the legacy permit issuance dataset, excluding DOB NOW. Supply an NYC borough. Chicago covers permits since 2006, excluding voided or revoked permits. Returns permit type, source status, dates, description, declared value and business contractors where published. Optional issue-date and permit-type filters. No match does not prove no work occurred. Data checked daily; missing, failed or stale ingests fail the call. Outside coverage is refused before payment. Paid per call.",
1124
+ "inputSchema": {
1125
+ "type": "object",
1126
+ "properties": {
1127
+ "street_address": {
1128
+ "type": "string",
1129
+ "description": "Site street address with number and source spelling; no unit or city"
1130
+ },
1131
+ "city": {
1132
+ "type": "string",
1133
+ "description": "Chicago or New York City; an NYC borough name is also accepted"
1134
+ },
1135
+ "state": {
1136
+ "type": "string",
1137
+ "description": "Two-letter US state code"
1138
+ },
1139
+ "borough": {
1140
+ "type": "string",
1141
+ "description": "NYC borough, required when city is New York City"
1142
+ },
1143
+ "issued_from": {
1144
+ "type": "string",
1145
+ "description": "First issue date inclusive, YYYY-MM-DD"
1146
+ },
1147
+ "issued_to": {
1148
+ "type": "string",
1149
+ "description": "Last issue date inclusive, YYYY-MM-DD"
1150
+ },
1151
+ "permit_type": {
1152
+ "type": "string",
1153
+ "description": "Exact source permit type, case insensitive"
1154
+ },
1155
+ "limit": {
1156
+ "type": "integer",
1157
+ "description": "Page size, 1-100, default 50"
1158
+ },
1159
+ "offset": {
1160
+ "type": "integer",
1161
+ "description": "Results to skip, 0-10000, default 0"
1162
+ }
1163
+ },
1164
+ "required": [
1165
+ "street_address",
1166
+ "city",
1167
+ "state"
1168
+ ]
1169
+ },
1170
+ "example": {
1171
+ "street_address": "7529 N CLARK ST",
1172
+ "city": "Chicago",
1173
+ "state": "IL"
1174
+ }
1175
+ },
987
1176
  {
988
1177
  "name": "watch_update",
989
1178
  "method": "PATCH",
@@ -1028,7 +1217,7 @@ export const ROUTE_MANIFEST = [
1028
1217
  "paid": true,
1029
1218
  "readOnly": true,
1030
1219
  "title": "Changes",
1031
- "description": "What changed about one entity since a date, from the observations OneShot recorded: each change has the earlier value, the later value, when it was seen and the source. Give `attribute` (the name of a data tool that keeps history), `since`, and exactly one of `key` and `input`. A window with no changes is a completed, charged result. Paid per call.",
1220
+ "description": "What changed about one entity since a date, from the observations OneShot recorded: each change has the earlier value, the later value, when it was seen and the source. Give `attribute` (the name of a data tool that keeps history), `since`, and exactly one of `key` and `input`. For healthcare_exclusions, input selects a held monthly release and optional exact name/NPI/UPIN; returns row membership and full-row additions/removals, with coverage. A corrected row is removal plus addition, never person identity. A window with no changes is a completed, charged result. Paid per call.",
1032
1221
  "inputSchema": {
1033
1222
  "type": "object",
1034
1223
  "properties": {
@@ -1042,7 +1231,7 @@ export const ROUTE_MANIFEST = [
1042
1231
  },
1043
1232
  "input": {
1044
1233
  "type": "object",
1045
- "description": "Input a search was called with, for a stored search. Give exactly one of key and input"
1234
+ "description": "Stored search input; healthcare_exclusions accepts {entity: person|company, release: YYYY-MM, name? | npi? | upin?, previous_release?, after?}. Exact row membership, not person identity. Give exactly one of key and input"
1046
1235
  },
1047
1236
  "source": {
1048
1237
  "type": "string",
@@ -1050,7 +1239,7 @@ export const ROUTE_MANIFEST = [
1050
1239
  },
1051
1240
  "since": {
1052
1241
  "type": "string",
1053
- "description": "First day of the window, YYYY-MM-DD"
1242
+ "description": "First day of the window, YYYY-MM-DD; optional for healthcare_exclusions monthly releases"
1054
1243
  },
1055
1244
  "until": {
1056
1245
  "type": "string",
@@ -1062,8 +1251,7 @@ export const ROUTE_MANIFEST = [
1062
1251
  }
1063
1252
  },
1064
1253
  "required": [
1065
- "attribute",
1066
- "since"
1254
+ "attribute"
1067
1255
  ]
1068
1256
  },
1069
1257
  "example": {