@cyanheads/geonames-mcp-server 0.0.0-stage → 0.1.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.
Files changed (86) hide show
  1. package/AGENTS.md +438 -0
  2. package/CLAUDE.md +438 -0
  3. package/Dockerfile +177 -0
  4. package/LICENSE +201 -0
  5. package/README.md +316 -2
  6. package/changelog/0.1.x/0.1.0.md +9 -0
  7. package/changelog/0.1.x/0.1.1.md +22 -0
  8. package/changelog/template.md +151 -0
  9. package/dist/config/server-config.d.ts +13 -0
  10. package/dist/config/server-config.d.ts.map +1 -0
  11. package/dist/config/server-config.js +21 -0
  12. package/dist/config/server-config.js.map +1 -0
  13. package/dist/index.d.ts +8 -0
  14. package/dist/index.d.ts.map +1 -0
  15. package/dist/index.js +30 -0
  16. package/dist/index.js.map +1 -0
  17. package/dist/mcp-server/tools/definitions/find-postal-codes.tool.d.ts +90 -0
  18. package/dist/mcp-server/tools/definitions/find-postal-codes.tool.d.ts.map +1 -0
  19. package/dist/mcp-server/tools/definitions/find-postal-codes.tool.js +262 -0
  20. package/dist/mcp-server/tools/definitions/find-postal-codes.tool.js.map +1 -0
  21. package/dist/mcp-server/tools/definitions/get-children.tool.d.ts +88 -0
  22. package/dist/mcp-server/tools/definitions/get-children.tool.d.ts.map +1 -0
  23. package/dist/mcp-server/tools/definitions/get-children.tool.js +248 -0
  24. package/dist/mcp-server/tools/definitions/get-children.tool.js.map +1 -0
  25. package/dist/mcp-server/tools/definitions/get-countries.tool.d.ts +90 -0
  26. package/dist/mcp-server/tools/definitions/get-countries.tool.d.ts.map +1 -0
  27. package/dist/mcp-server/tools/definitions/get-countries.tool.js +217 -0
  28. package/dist/mcp-server/tools/definitions/get-countries.tool.js.map +1 -0
  29. package/dist/mcp-server/tools/definitions/get-hierarchy.tool.d.ts +64 -0
  30. package/dist/mcp-server/tools/definitions/get-hierarchy.tool.d.ts.map +1 -0
  31. package/dist/mcp-server/tools/definitions/get-hierarchy.tool.js +168 -0
  32. package/dist/mcp-server/tools/definitions/get-hierarchy.tool.js.map +1 -0
  33. package/dist/mcp-server/tools/definitions/get-place.tool.d.ts +108 -0
  34. package/dist/mcp-server/tools/definitions/get-place.tool.d.ts.map +1 -0
  35. package/dist/mcp-server/tools/definitions/get-place.tool.js +300 -0
  36. package/dist/mcp-server/tools/definitions/get-place.tool.js.map +1 -0
  37. package/dist/mcp-server/tools/definitions/index.d.ts +735 -0
  38. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -0
  39. package/dist/mcp-server/tools/definitions/index.js +23 -0
  40. package/dist/mcp-server/tools/definitions/index.js.map +1 -0
  41. package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts +103 -0
  42. package/dist/mcp-server/tools/definitions/list-reference.tool.d.ts.map +1 -0
  43. package/dist/mcp-server/tools/definitions/list-reference.tool.js +233 -0
  44. package/dist/mcp-server/tools/definitions/list-reference.tool.js.map +1 -0
  45. package/dist/mcp-server/tools/definitions/reverse-geocode.tool.d.ts +134 -0
  46. package/dist/mcp-server/tools/definitions/reverse-geocode.tool.d.ts.map +1 -0
  47. package/dist/mcp-server/tools/definitions/reverse-geocode.tool.js +381 -0
  48. package/dist/mcp-server/tools/definitions/reverse-geocode.tool.js.map +1 -0
  49. package/dist/mcp-server/tools/definitions/search-places.tool.d.ts +133 -0
  50. package/dist/mcp-server/tools/definitions/search-places.tool.d.ts.map +1 -0
  51. package/dist/mcp-server/tools/definitions/search-places.tool.js +348 -0
  52. package/dist/mcp-server/tools/definitions/search-places.tool.js.map +1 -0
  53. package/dist/mcp-server/tools/shared-inputs.d.ts +97 -0
  54. package/dist/mcp-server/tools/shared-inputs.d.ts.map +1 -0
  55. package/dist/mcp-server/tools/shared-inputs.js +156 -0
  56. package/dist/mcp-server/tools/shared-inputs.js.map +1 -0
  57. package/dist/services/geonames/feature-codes.d.ts +27 -0
  58. package/dist/services/geonames/feature-codes.d.ts.map +1 -0
  59. package/dist/services/geonames/feature-codes.js +723 -0
  60. package/dist/services/geonames/feature-codes.js.map +1 -0
  61. package/dist/services/geonames/geonames-service.d.ts +98 -0
  62. package/dist/services/geonames/geonames-service.d.ts.map +1 -0
  63. package/dist/services/geonames/geonames-service.js +555 -0
  64. package/dist/services/geonames/geonames-service.js.map +1 -0
  65. package/dist/services/geonames/response-cache.d.ts +24 -0
  66. package/dist/services/geonames/response-cache.d.ts.map +1 -0
  67. package/dist/services/geonames/response-cache.js +44 -0
  68. package/dist/services/geonames/response-cache.js.map +1 -0
  69. package/dist/services/geonames/response-parsers.d.ts +34 -0
  70. package/dist/services/geonames/response-parsers.d.ts.map +1 -0
  71. package/dist/services/geonames/response-parsers.js +350 -0
  72. package/dist/services/geonames/response-parsers.js.map +1 -0
  73. package/dist/services/geonames/types.d.ts +218 -0
  74. package/dist/services/geonames/types.d.ts.map +1 -0
  75. package/dist/services/geonames/types.js +10 -0
  76. package/dist/services/geonames/types.js.map +1 -0
  77. package/dist/services/geonames/upstream-errors.d.ts +54 -0
  78. package/dist/services/geonames/upstream-errors.d.ts.map +1 -0
  79. package/dist/services/geonames/upstream-errors.js +187 -0
  80. package/dist/services/geonames/upstream-errors.js.map +1 -0
  81. package/dist/utils/inline-text.d.ts +25 -0
  82. package/dist/utils/inline-text.d.ts.map +1 -0
  83. package/dist/utils/inline-text.js +60 -0
  84. package/dist/utils/inline-text.js.map +1 -0
  85. package/package.json +108 -4
  86. package/server.json +114 -0
@@ -0,0 +1,735 @@
1
+ /**
2
+ * @fileoverview Every GeoNames tool definition, collected for `createApp()`.
3
+ * @module mcp-server/tools/definitions
4
+ */
5
+ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
6
+ mode: import("zod").ZodPreprocess<import("zod").ZodEnum<{
7
+ code: "code";
8
+ nearby: "nearby";
9
+ place_name: "place_name";
10
+ }>, unknown>;
11
+ postalCode: import("zod").ZodPreprocess<import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>, unknown>;
12
+ placeName: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
13
+ lat: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodNumber>, unknown>;
14
+ lng: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodNumber>, unknown>;
15
+ radiusKm: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
16
+ countries: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>, unknown>;
17
+ limit: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
18
+ geonamesUsername: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
19
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
20
+ mode: import("zod").ZodEnum<{
21
+ code: "code";
22
+ nearby: "nearby";
23
+ place_name: "place_name";
24
+ }>;
25
+ postalCodes: import("zod").ZodArray<import("zod").ZodObject<{
26
+ postalCode: import("zod").ZodString;
27
+ placeName: import("zod").ZodString;
28
+ countryCode: import("zod").ZodString;
29
+ adminCode1: import("zod").ZodOptional<import("zod").ZodString>;
30
+ adminName1: import("zod").ZodOptional<import("zod").ZodString>;
31
+ adminCode2: import("zod").ZodOptional<import("zod").ZodString>;
32
+ adminName2: import("zod").ZodOptional<import("zod").ZodString>;
33
+ adminCode3: import("zod").ZodOptional<import("zod").ZodString>;
34
+ adminName3: import("zod").ZodOptional<import("zod").ZodString>;
35
+ iso3166_2: import("zod").ZodOptional<import("zod").ZodString>;
36
+ lat: import("zod").ZodOptional<import("zod").ZodNumber>;
37
+ lng: import("zod").ZodOptional<import("zod").ZodNumber>;
38
+ distanceInKm: import("zod").ZodOptional<import("zod").ZodNumber>;
39
+ }, import("zod/v4/core").$strip>>;
40
+ }, import("zod/v4/core").$strip>, readonly [{
41
+ readonly reason: "mode_fields_mismatch";
42
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
43
+ readonly when: "A field the mode requires is missing, or countries is given in mode nearby. The message names the field.";
44
+ readonly recovery: "Supply the fields the chosen mode needs (code: postalCode; place_name: placeName; nearby: lat and lng, without countries) and call geonames_find_postal_codes again.";
45
+ readonly severity: "notice";
46
+ }, {
47
+ readonly reason: "username_required";
48
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
49
+ readonly when: "Neither geonamesUsername nor the server's GEONAMES_USERNAME supplies a GeoNames account.";
50
+ readonly recovery: "Call the tool again with geonamesUsername set to a free GeoNames account that has web services enabled, or ask the operator to set GEONAMES_USERNAME.";
51
+ readonly severity: "notice";
52
+ readonly thrownBy: "service";
53
+ }, {
54
+ readonly reason: "caller_account_rejected";
55
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
56
+ readonly when: "GeoNames rejected the caller-supplied geonamesUsername (unknown user, or free web services not enabled).";
57
+ readonly recovery: "Enable free web services for that account on its GeoNames account page, or call the tool again without geonamesUsername to use the server's account.";
58
+ readonly severity: "notice";
59
+ readonly thrownBy: "service";
60
+ }, {
61
+ readonly reason: "server_account_rejected";
62
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ConfigurationError;
63
+ readonly when: "GeoNames rejected the server's GEONAMES_USERNAME.";
64
+ readonly recovery: "The operator must set GEONAMES_USERNAME to a registered account with free web services enabled; until then call the tool again with geonamesUsername set to your own account.";
65
+ readonly thrownBy: "service";
66
+ }, {
67
+ readonly reason: "quota_exhausted";
68
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
69
+ readonly when: "GeoNames reported the account's hourly, daily, or weekly credit limit spent, or this server's pacer for the account shed the call.";
70
+ readonly recovery: "Wait for the window named in the message before calling again, or call again with a different GeoNames account: pass geonamesUsername, or omit it to use the server's.";
71
+ readonly retryable: true;
72
+ readonly thrownBy: "service";
73
+ }, {
74
+ readonly reason: "upstream_rejected_parameter";
75
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
76
+ readonly when: "GeoNames rejected a value the schema let through; the message carries its text.";
77
+ readonly recovery: "Correct the value named in the message and call again; geonames_list_reference lists valid feature classes, feature codes, and postal coverage.";
78
+ readonly severity: "notice";
79
+ readonly thrownBy: "service";
80
+ }], {
81
+ readonly truncated: import("zod").ZodBoolean;
82
+ readonly shown: import("zod").ZodNumber;
83
+ readonly cap: import("zod").ZodNumber;
84
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
85
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
86
+ geonameId: import("zod").ZodPreprocess<import("zod").ZodString, unknown>;
87
+ nameLanguages: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>, unknown>;
88
+ geonamesUsername: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
89
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
90
+ found: import("zod").ZodBoolean;
91
+ guidance: import("zod").ZodOptional<import("zod").ZodString>;
92
+ place: import("zod").ZodOptional<import("zod").ZodObject<{
93
+ geonameId: import("zod").ZodNumber;
94
+ name: import("zod").ZodString;
95
+ toponymName: import("zod").ZodString;
96
+ asciiName: import("zod").ZodOptional<import("zod").ZodString>;
97
+ lat: import("zod").ZodOptional<import("zod").ZodNumber>;
98
+ lng: import("zod").ZodOptional<import("zod").ZodNumber>;
99
+ featureClass: import("zod").ZodOptional<import("zod").ZodString>;
100
+ featureClassName: import("zod").ZodOptional<import("zod").ZodString>;
101
+ featureCode: import("zod").ZodOptional<import("zod").ZodString>;
102
+ featureName: import("zod").ZodOptional<import("zod").ZodString>;
103
+ countryCode: import("zod").ZodOptional<import("zod").ZodString>;
104
+ countryName: import("zod").ZodOptional<import("zod").ZodString>;
105
+ countryGeonameId: import("zod").ZodOptional<import("zod").ZodNumber>;
106
+ continentCode: import("zod").ZodOptional<import("zod").ZodString>;
107
+ iso3166_2: import("zod").ZodOptional<import("zod").ZodString>;
108
+ adminLevels: import("zod").ZodArray<import("zod").ZodObject<{
109
+ level: import("zod").ZodNumber;
110
+ code: import("zod").ZodOptional<import("zod").ZodString>;
111
+ name: import("zod").ZodOptional<import("zod").ZodString>;
112
+ geonameId: import("zod").ZodOptional<import("zod").ZodNumber>;
113
+ }, import("zod/v4/core").$strip>>;
114
+ population: import("zod").ZodOptional<import("zod").ZodNumber>;
115
+ elevationInMeters: import("zod").ZodOptional<import("zod").ZodNumber>;
116
+ demElevationInMeters: import("zod").ZodOptional<import("zod").ZodNumber>;
117
+ timezone: import("zod").ZodOptional<import("zod").ZodObject<{
118
+ timezoneId: import("zod").ZodOptional<import("zod").ZodString>;
119
+ gmtOffsetInHours: import("zod").ZodOptional<import("zod").ZodNumber>;
120
+ dstOffsetInHours: import("zod").ZodOptional<import("zod").ZodNumber>;
121
+ }, import("zod/v4/core").$strip>>;
122
+ boundingBox: import("zod").ZodOptional<import("zod").ZodObject<{
123
+ north: import("zod").ZodNumber;
124
+ south: import("zod").ZodNumber;
125
+ east: import("zod").ZodNumber;
126
+ west: import("zod").ZodNumber;
127
+ }, import("zod/v4/core").$strip>>;
128
+ wikipediaUrl: import("zod").ZodOptional<import("zod").ZodString>;
129
+ alternateNames: import("zod").ZodArray<import("zod").ZodObject<{
130
+ name: import("zod").ZodString;
131
+ lang: import("zod").ZodOptional<import("zod").ZodString>;
132
+ isPreferredName: import("zod").ZodOptional<import("zod").ZodBoolean>;
133
+ isShortName: import("zod").ZodOptional<import("zod").ZodBoolean>;
134
+ }, import("zod/v4/core").$strip>>;
135
+ postalCodes: import("zod").ZodArray<import("zod").ZodString>;
136
+ links: import("zod").ZodArray<import("zod").ZodString>;
137
+ identifiers: import("zod").ZodArray<import("zod").ZodObject<{
138
+ type: import("zod").ZodEnum<{
139
+ faac: "faac";
140
+ iata: "iata";
141
+ icao: "icao";
142
+ tcid: "tcid";
143
+ unlc: "unlc";
144
+ wkdt: "wkdt";
145
+ }>;
146
+ value: import("zod").ZodString;
147
+ }, import("zod/v4/core").$strip>>;
148
+ }, import("zod/v4/core").$strip>>;
149
+ }, import("zod/v4/core").$strip>, readonly [{
150
+ readonly reason: "username_required";
151
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
152
+ readonly when: "Neither geonamesUsername nor the server's GEONAMES_USERNAME supplies a GeoNames account.";
153
+ readonly recovery: "Call the tool again with geonamesUsername set to a free GeoNames account that has web services enabled, or ask the operator to set GEONAMES_USERNAME.";
154
+ readonly severity: "notice";
155
+ readonly thrownBy: "service";
156
+ }, {
157
+ readonly reason: "caller_account_rejected";
158
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
159
+ readonly when: "GeoNames rejected the caller-supplied geonamesUsername (unknown user, or free web services not enabled).";
160
+ readonly recovery: "Enable free web services for that account on its GeoNames account page, or call the tool again without geonamesUsername to use the server's account.";
161
+ readonly severity: "notice";
162
+ readonly thrownBy: "service";
163
+ }, {
164
+ readonly reason: "server_account_rejected";
165
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ConfigurationError;
166
+ readonly when: "GeoNames rejected the server's GEONAMES_USERNAME.";
167
+ readonly recovery: "The operator must set GEONAMES_USERNAME to a registered account with free web services enabled; until then call the tool again with geonamesUsername set to your own account.";
168
+ readonly thrownBy: "service";
169
+ }, {
170
+ readonly reason: "quota_exhausted";
171
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
172
+ readonly when: "GeoNames reported the account's hourly, daily, or weekly credit limit spent, or this server's pacer for the account shed the call.";
173
+ readonly recovery: "Wait for the window named in the message before calling again, or call again with a different GeoNames account: pass geonamesUsername, or omit it to use the server's.";
174
+ readonly retryable: true;
175
+ readonly thrownBy: "service";
176
+ }, {
177
+ readonly reason: "upstream_rejected_parameter";
178
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
179
+ readonly when: "GeoNames rejected a value the schema let through; the message carries its text.";
180
+ readonly recovery: "Correct the value named in the message and call again; geonames_list_reference lists valid feature classes, feature codes, and postal coverage.";
181
+ readonly severity: "notice";
182
+ readonly thrownBy: "service";
183
+ }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
184
+ query: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
185
+ match: import("zod").ZodPreprocess<import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodEnum<{
186
+ any_field: "any_field";
187
+ exact_name: "exact_name";
188
+ name_prefix: "name_prefix";
189
+ name_required: "name_required";
190
+ }>>, unknown>, unknown>;
191
+ countries: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>, unknown>;
192
+ featureClasses: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
193
+ A: "A";
194
+ H: "H";
195
+ L: "L";
196
+ P: "P";
197
+ R: "R";
198
+ S: "S";
199
+ T: "T";
200
+ U: "U";
201
+ V: "V";
202
+ }>>>, unknown>;
203
+ featureCodes: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>, unknown>;
204
+ cities: import("zod").ZodPreprocess<import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodEnum<{
205
+ cities1000: "cities1000";
206
+ cities15000: "cities15000";
207
+ cities5000: "cities5000";
208
+ }>>, unknown>, unknown>;
209
+ boundingBox: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodObject<{
210
+ north: import("zod").ZodNumber;
211
+ south: import("zod").ZodNumber;
212
+ east: import("zod").ZodNumber;
213
+ west: import("zod").ZodNumber;
214
+ }, import("zod/v4/core").$strict>>, unknown>;
215
+ orderBy: import("zod").ZodPreprocess<import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodEnum<{
216
+ population: "population";
217
+ relevance: "relevance";
218
+ }>>, unknown>, unknown>;
219
+ limit: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
220
+ offset: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
221
+ geonamesUsername: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
222
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
223
+ places: import("zod").ZodArray<import("zod").ZodObject<{
224
+ geonameId: import("zod").ZodNumber;
225
+ name: import("zod").ZodString;
226
+ toponymName: import("zod").ZodString;
227
+ lat: import("zod").ZodOptional<import("zod").ZodNumber>;
228
+ lng: import("zod").ZodOptional<import("zod").ZodNumber>;
229
+ featureClass: import("zod").ZodOptional<import("zod").ZodString>;
230
+ featureClassName: import("zod").ZodOptional<import("zod").ZodString>;
231
+ featureCode: import("zod").ZodOptional<import("zod").ZodString>;
232
+ featureName: import("zod").ZodOptional<import("zod").ZodString>;
233
+ countryCode: import("zod").ZodOptional<import("zod").ZodString>;
234
+ countryName: import("zod").ZodOptional<import("zod").ZodString>;
235
+ adminCode1: import("zod").ZodOptional<import("zod").ZodString>;
236
+ adminName1: import("zod").ZodOptional<import("zod").ZodString>;
237
+ iso3166_2: import("zod").ZodOptional<import("zod").ZodString>;
238
+ population: import("zod").ZodOptional<import("zod").ZodNumber>;
239
+ }, import("zod/v4/core").$strip>>;
240
+ nextOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
241
+ }, import("zod/v4/core").$strip>, readonly [{
242
+ readonly reason: "query_or_filter_required";
243
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
244
+ readonly when: "Neither query nor a narrowing filter (countries, featureClasses, featureCodes, boundingBox) was given.";
245
+ readonly recovery: "Pass query, or at least one of countries, featureClasses, featureCodes, or boundingBox, then call geonames_search_places again.";
246
+ readonly severity: "notice";
247
+ }, {
248
+ readonly reason: "query_required";
249
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
250
+ readonly when: "match was set without query.";
251
+ readonly recovery: "Call geonames_search_places again with query text for the chosen match mode, or drop match to search by filters alone.";
252
+ readonly severity: "notice";
253
+ }, {
254
+ readonly reason: "unknown_feature_code";
255
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
256
+ readonly when: "A featureCodes entry is not a GeoNames feature code.";
257
+ readonly recovery: "Look up valid codes with geonames_list_reference topic feature_codes, then retry with a listed code.";
258
+ readonly severity: "notice";
259
+ }, {
260
+ readonly reason: "invalid_bounding_box";
261
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
262
+ readonly when: "boundingBox has south greater than or equal to north, or west greater than or equal to east.";
263
+ readonly recovery: "Call geonames_search_places again with south below north and west below east; split a box that crosses the 180° meridian into two searches.";
264
+ readonly severity: "notice";
265
+ }, {
266
+ readonly reason: "username_required";
267
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
268
+ readonly when: "Neither geonamesUsername nor the server's GEONAMES_USERNAME supplies a GeoNames account.";
269
+ readonly recovery: "Call the tool again with geonamesUsername set to a free GeoNames account that has web services enabled, or ask the operator to set GEONAMES_USERNAME.";
270
+ readonly severity: "notice";
271
+ readonly thrownBy: "service";
272
+ }, {
273
+ readonly reason: "caller_account_rejected";
274
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
275
+ readonly when: "GeoNames rejected the caller-supplied geonamesUsername (unknown user, or free web services not enabled).";
276
+ readonly recovery: "Enable free web services for that account on its GeoNames account page, or call the tool again without geonamesUsername to use the server's account.";
277
+ readonly severity: "notice";
278
+ readonly thrownBy: "service";
279
+ }, {
280
+ readonly reason: "server_account_rejected";
281
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ConfigurationError;
282
+ readonly when: "GeoNames rejected the server's GEONAMES_USERNAME.";
283
+ readonly recovery: "The operator must set GEONAMES_USERNAME to a registered account with free web services enabled; until then call the tool again with geonamesUsername set to your own account.";
284
+ readonly thrownBy: "service";
285
+ }, {
286
+ readonly reason: "quota_exhausted";
287
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
288
+ readonly when: "GeoNames reported the account's hourly, daily, or weekly credit limit spent, or this server's pacer for the account shed the call.";
289
+ readonly recovery: "Wait for the window named in the message before calling again, or call again with a different GeoNames account: pass geonamesUsername, or omit it to use the server's.";
290
+ readonly retryable: true;
291
+ readonly thrownBy: "service";
292
+ }, {
293
+ readonly reason: "upstream_rejected_parameter";
294
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
295
+ readonly when: "GeoNames rejected a value the schema let through; the message carries its text.";
296
+ readonly recovery: "Correct the value named in the message and call again; geonames_list_reference lists valid feature classes, feature codes, and postal coverage.";
297
+ readonly severity: "notice";
298
+ readonly thrownBy: "service";
299
+ }], {
300
+ readonly totalCount: import("zod").ZodNumber;
301
+ readonly effectiveQuery: import("zod").ZodString;
302
+ readonly truncated: import("zod").ZodBoolean;
303
+ readonly shown: import("zod").ZodNumber;
304
+ readonly cap: import("zod").ZodNumber;
305
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
306
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
307
+ geonameId: import("zod").ZodPreprocess<import("zod").ZodString, unknown>;
308
+ geonamesUsername: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
309
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
310
+ found: import("zod").ZodBoolean;
311
+ geonameId: import("zod").ZodNumber;
312
+ guidance: import("zod").ZodOptional<import("zod").ZodString>;
313
+ chain: import("zod").ZodArray<import("zod").ZodObject<{
314
+ geonameId: import("zod").ZodNumber;
315
+ name: import("zod").ZodString;
316
+ toponymName: import("zod").ZodString;
317
+ featureClass: import("zod").ZodOptional<import("zod").ZodString>;
318
+ featureCode: import("zod").ZodOptional<import("zod").ZodString>;
319
+ featureName: import("zod").ZodOptional<import("zod").ZodString>;
320
+ countryCode: import("zod").ZodOptional<import("zod").ZodString>;
321
+ adminCode1: import("zod").ZodOptional<import("zod").ZodString>;
322
+ iso3166_2: import("zod").ZodOptional<import("zod").ZodString>;
323
+ lat: import("zod").ZodOptional<import("zod").ZodNumber>;
324
+ lng: import("zod").ZodOptional<import("zod").ZodNumber>;
325
+ population: import("zod").ZodOptional<import("zod").ZodNumber>;
326
+ }, import("zod/v4/core").$strip>>;
327
+ }, import("zod/v4/core").$strip>, readonly [{
328
+ readonly reason: "username_required";
329
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
330
+ readonly when: "Neither geonamesUsername nor the server's GEONAMES_USERNAME supplies a GeoNames account.";
331
+ readonly recovery: "Call the tool again with geonamesUsername set to a free GeoNames account that has web services enabled, or ask the operator to set GEONAMES_USERNAME.";
332
+ readonly severity: "notice";
333
+ readonly thrownBy: "service";
334
+ }, {
335
+ readonly reason: "caller_account_rejected";
336
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
337
+ readonly when: "GeoNames rejected the caller-supplied geonamesUsername (unknown user, or free web services not enabled).";
338
+ readonly recovery: "Enable free web services for that account on its GeoNames account page, or call the tool again without geonamesUsername to use the server's account.";
339
+ readonly severity: "notice";
340
+ readonly thrownBy: "service";
341
+ }, {
342
+ readonly reason: "server_account_rejected";
343
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ConfigurationError;
344
+ readonly when: "GeoNames rejected the server's GEONAMES_USERNAME.";
345
+ readonly recovery: "The operator must set GEONAMES_USERNAME to a registered account with free web services enabled; until then call the tool again with geonamesUsername set to your own account.";
346
+ readonly thrownBy: "service";
347
+ }, {
348
+ readonly reason: "quota_exhausted";
349
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
350
+ readonly when: "GeoNames reported the account's hourly, daily, or weekly credit limit spent, or this server's pacer for the account shed the call.";
351
+ readonly recovery: "Wait for the window named in the message before calling again, or call again with a different GeoNames account: pass geonamesUsername, or omit it to use the server's.";
352
+ readonly retryable: true;
353
+ readonly thrownBy: "service";
354
+ }, {
355
+ readonly reason: "upstream_rejected_parameter";
356
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
357
+ readonly when: "GeoNames rejected a value the schema let through; the message carries its text.";
358
+ readonly recovery: "Correct the value named in the message and call again; geonames_list_reference lists valid feature classes, feature codes, and postal coverage.";
359
+ readonly severity: "notice";
360
+ readonly thrownBy: "service";
361
+ }], undefined> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
362
+ geonameId: import("zod").ZodPreprocess<import("zod").ZodString, unknown>;
363
+ hierarchy: import("zod").ZodPreprocess<import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodEnum<{
364
+ administrative: "administrative";
365
+ dependency: "dependency";
366
+ geography: "geography";
367
+ tourism: "tourism";
368
+ }>>, unknown>, unknown>;
369
+ nameContains: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
370
+ limit: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
371
+ offset: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
372
+ geonamesUsername: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
373
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
374
+ found: import("zod").ZodBoolean;
375
+ parentGeonameId: import("zod").ZodNumber;
376
+ hierarchy: import("zod").ZodEnum<{
377
+ administrative: "administrative";
378
+ dependency: "dependency";
379
+ geography: "geography";
380
+ tourism: "tourism";
381
+ }>;
382
+ guidance: import("zod").ZodOptional<import("zod").ZodString>;
383
+ children: import("zod").ZodArray<import("zod").ZodObject<{
384
+ geonameId: import("zod").ZodNumber;
385
+ name: import("zod").ZodString;
386
+ toponymName: import("zod").ZodString;
387
+ featureClass: import("zod").ZodOptional<import("zod").ZodString>;
388
+ featureCode: import("zod").ZodOptional<import("zod").ZodString>;
389
+ featureName: import("zod").ZodOptional<import("zod").ZodString>;
390
+ countryCode: import("zod").ZodOptional<import("zod").ZodString>;
391
+ adminCode1: import("zod").ZodOptional<import("zod").ZodString>;
392
+ adminName1: import("zod").ZodOptional<import("zod").ZodString>;
393
+ iso3166_2: import("zod").ZodOptional<import("zod").ZodString>;
394
+ lat: import("zod").ZodOptional<import("zod").ZodNumber>;
395
+ lng: import("zod").ZodOptional<import("zod").ZodNumber>;
396
+ population: import("zod").ZodOptional<import("zod").ZodNumber>;
397
+ }, import("zod/v4/core").$strip>>;
398
+ nextOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
399
+ }, import("zod/v4/core").$strip>, readonly [{
400
+ readonly reason: "username_required";
401
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
402
+ readonly when: "Neither geonamesUsername nor the server's GEONAMES_USERNAME supplies a GeoNames account.";
403
+ readonly recovery: "Call the tool again with geonamesUsername set to a free GeoNames account that has web services enabled, or ask the operator to set GEONAMES_USERNAME.";
404
+ readonly severity: "notice";
405
+ readonly thrownBy: "service";
406
+ }, {
407
+ readonly reason: "caller_account_rejected";
408
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
409
+ readonly when: "GeoNames rejected the caller-supplied geonamesUsername (unknown user, or free web services not enabled).";
410
+ readonly recovery: "Enable free web services for that account on its GeoNames account page, or call the tool again without geonamesUsername to use the server's account.";
411
+ readonly severity: "notice";
412
+ readonly thrownBy: "service";
413
+ }, {
414
+ readonly reason: "server_account_rejected";
415
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ConfigurationError;
416
+ readonly when: "GeoNames rejected the server's GEONAMES_USERNAME.";
417
+ readonly recovery: "The operator must set GEONAMES_USERNAME to a registered account with free web services enabled; until then call the tool again with geonamesUsername set to your own account.";
418
+ readonly thrownBy: "service";
419
+ }, {
420
+ readonly reason: "quota_exhausted";
421
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
422
+ readonly when: "GeoNames reported the account's hourly, daily, or weekly credit limit spent, or this server's pacer for the account shed the call.";
423
+ readonly recovery: "Wait for the window named in the message before calling again, or call again with a different GeoNames account: pass geonamesUsername, or omit it to use the server's.";
424
+ readonly retryable: true;
425
+ readonly thrownBy: "service";
426
+ }, {
427
+ readonly reason: "upstream_rejected_parameter";
428
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
429
+ readonly when: "GeoNames rejected a value the schema let through; the message carries its text.";
430
+ readonly recovery: "Correct the value named in the message and call again; geonames_list_reference lists valid feature classes, feature codes, and postal coverage.";
431
+ readonly severity: "notice";
432
+ readonly thrownBy: "service";
433
+ }], {
434
+ readonly totalCount: import("zod").ZodNumber;
435
+ readonly truncated: import("zod").ZodBoolean;
436
+ readonly shown: import("zod").ZodNumber;
437
+ readonly cap: import("zod").ZodNumber;
438
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
439
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
440
+ lat: import("zod").ZodNumber;
441
+ lng: import("zod").ZodNumber;
442
+ nearbyLimit: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
443
+ radiusKm: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
444
+ cities: import("zod").ZodPreprocess<import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodEnum<{
445
+ cities1000: "cities1000";
446
+ cities15000: "cities15000";
447
+ cities5000: "cities5000";
448
+ }>>, unknown>, unknown>;
449
+ featureClasses: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodEnum<{
450
+ A: "A";
451
+ H: "H";
452
+ L: "L";
453
+ P: "P";
454
+ R: "R";
455
+ S: "S";
456
+ T: "T";
457
+ U: "U";
458
+ V: "V";
459
+ }>>>, unknown>;
460
+ featureCodes: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>, unknown>;
461
+ includeTimezone: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodBoolean>, unknown>;
462
+ geonamesUsername: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
463
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
464
+ lat: import("zod").ZodNumber;
465
+ lng: import("zod").ZodNumber;
466
+ country: import("zod").ZodOptional<import("zod").ZodObject<{
467
+ countryCode: import("zod").ZodString;
468
+ countryName: import("zod").ZodOptional<import("zod").ZodString>;
469
+ }, import("zod/v4/core").$strip>>;
470
+ adminLevels: import("zod").ZodArray<import("zod").ZodObject<{
471
+ level: import("zod").ZodNumber;
472
+ code: import("zod").ZodOptional<import("zod").ZodString>;
473
+ name: import("zod").ZodOptional<import("zod").ZodString>;
474
+ geonameId: import("zod").ZodOptional<import("zod").ZodNumber>;
475
+ isoCode: import("zod").ZodOptional<import("zod").ZodString>;
476
+ }, import("zod/v4/core").$strip>>;
477
+ ocean: import("zod").ZodOptional<import("zod").ZodObject<{
478
+ name: import("zod").ZodString;
479
+ geonameId: import("zod").ZodOptional<import("zod").ZodNumber>;
480
+ }, import("zod/v4/core").$strip>>;
481
+ nearbyKind: import("zod").ZodEnum<{
482
+ features: "features";
483
+ none: "none";
484
+ populated_places: "populated_places";
485
+ }>;
486
+ nearby: import("zod").ZodArray<import("zod").ZodObject<{
487
+ geonameId: import("zod").ZodNumber;
488
+ name: import("zod").ZodString;
489
+ toponymName: import("zod").ZodString;
490
+ featureClass: import("zod").ZodOptional<import("zod").ZodString>;
491
+ featureCode: import("zod").ZodOptional<import("zod").ZodString>;
492
+ featureName: import("zod").ZodOptional<import("zod").ZodString>;
493
+ countryCode: import("zod").ZodOptional<import("zod").ZodString>;
494
+ adminName1: import("zod").ZodOptional<import("zod").ZodString>;
495
+ lat: import("zod").ZodOptional<import("zod").ZodNumber>;
496
+ lng: import("zod").ZodOptional<import("zod").ZodNumber>;
497
+ distanceInKm: import("zod").ZodOptional<import("zod").ZodNumber>;
498
+ population: import("zod").ZodOptional<import("zod").ZodNumber>;
499
+ }, import("zod/v4/core").$strip>>;
500
+ timezone: import("zod").ZodOptional<import("zod").ZodObject<{
501
+ timezoneId: import("zod").ZodOptional<import("zod").ZodString>;
502
+ countryCode: import("zod").ZodOptional<import("zod").ZodString>;
503
+ rawOffsetInHours: import("zod").ZodNumber;
504
+ gmtOffsetInHours: import("zod").ZodNumber;
505
+ dstOffsetInHours: import("zod").ZodNumber;
506
+ localTime: import("zod").ZodOptional<import("zod").ZodString>;
507
+ sunrise: import("zod").ZodOptional<import("zod").ZodString>;
508
+ sunset: import("zod").ZodOptional<import("zod").ZodString>;
509
+ }, import("zod/v4/core").$strip>>;
510
+ }, import("zod/v4/core").$strip>, readonly [{
511
+ readonly reason: "unknown_feature_code";
512
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
513
+ readonly when: "A featureCodes entry is not a GeoNames feature code.";
514
+ readonly recovery: "Look up valid codes with geonames_list_reference topic feature_codes, then retry with a listed code.";
515
+ readonly severity: "notice";
516
+ }, {
517
+ readonly reason: "conflicting_filters";
518
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
519
+ readonly when: "cities was combined with featureClasses or featureCodes.";
520
+ readonly recovery: "Call geonames_reverse_geocode again with cities for the nearest populated places, or featureClasses/featureCodes for the nearest features of a type, not both.";
521
+ readonly severity: "notice";
522
+ }, {
523
+ readonly reason: "username_required";
524
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
525
+ readonly when: "Neither geonamesUsername nor the server's GEONAMES_USERNAME supplies a GeoNames account.";
526
+ readonly recovery: "Call the tool again with geonamesUsername set to a free GeoNames account that has web services enabled, or ask the operator to set GEONAMES_USERNAME.";
527
+ readonly severity: "notice";
528
+ readonly thrownBy: "service";
529
+ }, {
530
+ readonly reason: "caller_account_rejected";
531
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
532
+ readonly when: "GeoNames rejected the caller-supplied geonamesUsername (unknown user, or free web services not enabled).";
533
+ readonly recovery: "Enable free web services for that account on its GeoNames account page, or call the tool again without geonamesUsername to use the server's account.";
534
+ readonly severity: "notice";
535
+ readonly thrownBy: "service";
536
+ }, {
537
+ readonly reason: "server_account_rejected";
538
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ConfigurationError;
539
+ readonly when: "GeoNames rejected the server's GEONAMES_USERNAME.";
540
+ readonly recovery: "The operator must set GEONAMES_USERNAME to a registered account with free web services enabled; until then call the tool again with geonamesUsername set to your own account.";
541
+ readonly thrownBy: "service";
542
+ }, {
543
+ readonly reason: "quota_exhausted";
544
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
545
+ readonly when: "GeoNames reported the account's hourly, daily, or weekly credit limit spent, or this server's pacer for the account shed the call.";
546
+ readonly recovery: "Wait for the window named in the message before calling again, or call again with a different GeoNames account: pass geonamesUsername, or omit it to use the server's.";
547
+ readonly retryable: true;
548
+ readonly thrownBy: "service";
549
+ }, {
550
+ readonly reason: "upstream_rejected_parameter";
551
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
552
+ readonly when: "GeoNames rejected a value the schema let through; the message carries its text.";
553
+ readonly recovery: "Correct the value named in the message and call again; geonames_list_reference lists valid feature classes, feature codes, and postal coverage.";
554
+ readonly severity: "notice";
555
+ readonly thrownBy: "service";
556
+ }], {
557
+ readonly truncated: import("zod").ZodBoolean;
558
+ readonly shown: import("zod").ZodNumber;
559
+ readonly cap: import("zod").ZodNumber;
560
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
561
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
562
+ countries: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodArray<import("zod").ZodString>>, unknown>;
563
+ continent: import("zod").ZodPreprocess<import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodEnum<{
564
+ AF: "AF";
565
+ AN: "AN";
566
+ AS: "AS";
567
+ EU: "EU";
568
+ NA: "NA";
569
+ OC: "OC";
570
+ SA: "SA";
571
+ }>>, unknown>, unknown>;
572
+ nameContains: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
573
+ limit: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
574
+ offset: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
575
+ geonamesUsername: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
576
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
577
+ countries: import("zod").ZodArray<import("zod").ZodObject<{
578
+ countryCode: import("zod").ZodString;
579
+ isoAlpha3: import("zod").ZodString;
580
+ isoNumeric: import("zod").ZodOptional<import("zod").ZodString>;
581
+ fipsCode: import("zod").ZodOptional<import("zod").ZodString>;
582
+ countryName: import("zod").ZodString;
583
+ geonameId: import("zod").ZodNumber;
584
+ capital: import("zod").ZodOptional<import("zod").ZodString>;
585
+ continentCode: import("zod").ZodString;
586
+ continentName: import("zod").ZodString;
587
+ population: import("zod").ZodOptional<import("zod").ZodNumber>;
588
+ areaInSqKm: import("zod").ZodOptional<import("zod").ZodNumber>;
589
+ languages: import("zod").ZodArray<import("zod").ZodString>;
590
+ currencyCode: import("zod").ZodOptional<import("zod").ZodString>;
591
+ postalCodeFormat: import("zod").ZodOptional<import("zod").ZodString>;
592
+ boundingBox: import("zod").ZodObject<{
593
+ north: import("zod").ZodNumber;
594
+ south: import("zod").ZodNumber;
595
+ east: import("zod").ZodNumber;
596
+ west: import("zod").ZodNumber;
597
+ }, import("zod/v4/core").$strip>;
598
+ }, import("zod/v4/core").$strip>>;
599
+ notFound: import("zod").ZodArray<import("zod").ZodString>;
600
+ nextOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
601
+ }, import("zod/v4/core").$strip>, readonly [{
602
+ readonly reason: "username_required";
603
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
604
+ readonly when: "Neither geonamesUsername nor the server's GEONAMES_USERNAME supplies a GeoNames account.";
605
+ readonly recovery: "Call the tool again with geonamesUsername set to a free GeoNames account that has web services enabled, or ask the operator to set GEONAMES_USERNAME.";
606
+ readonly severity: "notice";
607
+ readonly thrownBy: "service";
608
+ }, {
609
+ readonly reason: "caller_account_rejected";
610
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
611
+ readonly when: "GeoNames rejected the caller-supplied geonamesUsername (unknown user, or free web services not enabled).";
612
+ readonly recovery: "Enable free web services for that account on its GeoNames account page, or call the tool again without geonamesUsername to use the server's account.";
613
+ readonly severity: "notice";
614
+ readonly thrownBy: "service";
615
+ }, {
616
+ readonly reason: "server_account_rejected";
617
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ConfigurationError;
618
+ readonly when: "GeoNames rejected the server's GEONAMES_USERNAME.";
619
+ readonly recovery: "The operator must set GEONAMES_USERNAME to a registered account with free web services enabled; until then call the tool again with geonamesUsername set to your own account.";
620
+ readonly thrownBy: "service";
621
+ }, {
622
+ readonly reason: "quota_exhausted";
623
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
624
+ readonly when: "GeoNames reported the account's hourly, daily, or weekly credit limit spent, or this server's pacer for the account shed the call.";
625
+ readonly recovery: "Wait for the window named in the message before calling again, or call again with a different GeoNames account: pass geonamesUsername, or omit it to use the server's.";
626
+ readonly retryable: true;
627
+ readonly thrownBy: "service";
628
+ }, {
629
+ readonly reason: "upstream_rejected_parameter";
630
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
631
+ readonly when: "GeoNames rejected a value the schema let through; the message carries its text.";
632
+ readonly recovery: "Correct the value named in the message and call again; geonames_list_reference lists valid feature classes, feature codes, and postal coverage.";
633
+ readonly severity: "notice";
634
+ readonly thrownBy: "service";
635
+ }], {
636
+ readonly totalCount: import("zod").ZodNumber;
637
+ readonly truncated: import("zod").ZodBoolean;
638
+ readonly shown: import("zod").ZodNumber;
639
+ readonly cap: import("zod").ZodNumber;
640
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
641
+ }> | import("@cyanheads/mcp-ts-core").ToolDefinition<import("zod").ZodObject<{
642
+ topic: import("zod").ZodPreprocess<import("zod").ZodEnum<{
643
+ feature_classes: "feature_classes";
644
+ feature_codes: "feature_codes";
645
+ postal_countries: "postal_countries";
646
+ }>, unknown>;
647
+ featureClass: import("zod").ZodPreprocess<import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodEnum<{
648
+ A: "A";
649
+ H: "H";
650
+ L: "L";
651
+ P: "P";
652
+ R: "R";
653
+ S: "S";
654
+ T: "T";
655
+ U: "U";
656
+ V: "V";
657
+ }>>, unknown>, unknown>;
658
+ nameContains: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
659
+ limit: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
660
+ offset: import("zod").ZodPreprocess<import("zod").ZodDefault<import("zod").ZodNumber>, unknown>;
661
+ geonamesUsername: import("zod").ZodPreprocess<import("zod").ZodOptional<import("zod").ZodString>, unknown>;
662
+ }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
663
+ topic: import("zod").ZodEnum<{
664
+ feature_classes: "feature_classes";
665
+ feature_codes: "feature_codes";
666
+ postal_countries: "postal_countries";
667
+ }>;
668
+ entries: import("zod").ZodArray<import("zod").ZodObject<{
669
+ code: import("zod").ZodString;
670
+ name: import("zod").ZodString;
671
+ description: import("zod").ZodOptional<import("zod").ZodString>;
672
+ featureClass: import("zod").ZodOptional<import("zod").ZodEnum<{
673
+ A: "A";
674
+ H: "H";
675
+ L: "L";
676
+ P: "P";
677
+ R: "R";
678
+ S: "S";
679
+ T: "T";
680
+ U: "U";
681
+ V: "V";
682
+ }>>;
683
+ postalCodeCount: import("zod").ZodOptional<import("zod").ZodNumber>;
684
+ minPostalCode: import("zod").ZodOptional<import("zod").ZodString>;
685
+ maxPostalCode: import("zod").ZodOptional<import("zod").ZodString>;
686
+ }, import("zod/v4/core").$strip>>;
687
+ nextOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
688
+ }, import("zod/v4/core").$strip>, readonly [{
689
+ readonly reason: "filter_not_applicable";
690
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
691
+ readonly when: "featureClass was given with a topic other than feature_codes.";
692
+ readonly recovery: "Drop featureClass, or call geonames_list_reference with topic feature_codes to filter codes by class.";
693
+ readonly severity: "notice";
694
+ }, {
695
+ readonly reason: "username_required";
696
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
697
+ readonly when: "Neither geonamesUsername nor the server's GEONAMES_USERNAME supplies a GeoNames account.";
698
+ readonly recovery: "Call the tool again with geonamesUsername set to a free GeoNames account that has web services enabled, or ask the operator to set GEONAMES_USERNAME.";
699
+ readonly severity: "notice";
700
+ readonly thrownBy: "service";
701
+ }, {
702
+ readonly reason: "caller_account_rejected";
703
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.Unauthorized;
704
+ readonly when: "GeoNames rejected the caller-supplied geonamesUsername (unknown user, or free web services not enabled).";
705
+ readonly recovery: "Enable free web services for that account on its GeoNames account page, or call the tool again without geonamesUsername to use the server's account.";
706
+ readonly severity: "notice";
707
+ readonly thrownBy: "service";
708
+ }, {
709
+ readonly reason: "server_account_rejected";
710
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ConfigurationError;
711
+ readonly when: "GeoNames rejected the server's GEONAMES_USERNAME.";
712
+ readonly recovery: "The operator must set GEONAMES_USERNAME to a registered account with free web services enabled; until then call the tool again with geonamesUsername set to your own account.";
713
+ readonly thrownBy: "service";
714
+ }, {
715
+ readonly reason: "quota_exhausted";
716
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.RateLimited;
717
+ readonly when: "GeoNames reported the account's hourly, daily, or weekly credit limit spent, or this server's pacer for the account shed the call.";
718
+ readonly recovery: "Wait for the window named in the message before calling again, or call again with a different GeoNames account: pass geonamesUsername, or omit it to use the server's.";
719
+ readonly retryable: true;
720
+ readonly thrownBy: "service";
721
+ }, {
722
+ readonly reason: "upstream_rejected_parameter";
723
+ readonly code: import("@cyanheads/mcp-ts-core/errors").JsonRpcErrorCode.ValidationError;
724
+ readonly when: "GeoNames rejected a value the schema let through; the message carries its text.";
725
+ readonly recovery: "Correct the value named in the message and call again; geonames_list_reference lists valid feature classes, feature codes, and postal coverage.";
726
+ readonly severity: "notice";
727
+ readonly thrownBy: "service";
728
+ }], {
729
+ readonly totalCount: import("zod").ZodNumber;
730
+ readonly truncated: import("zod").ZodBoolean;
731
+ readonly shown: import("zod").ZodNumber;
732
+ readonly cap: import("zod").ZodNumber;
733
+ readonly notice: import("zod").ZodOptional<import("zod").ZodString>;
734
+ }>)[];
735
+ //# sourceMappingURL=index.d.ts.map