parseapi-mcp 1.13.0 → 1.14.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.
- package/README.md +16 -7
- package/dist/{chunk-OY4MSQLL.js → chunk-W2HQKIWP.js} +69 -55
- package/dist/http.js +1 -1
- package/dist/registry.js +1 -1
- package/dist/stdio.js +1 -1
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,12 +1,14 @@
|
|
|
1
1
|
# parseapi-mcp
|
|
2
2
|
|
|
3
|
+
This package selects HTTP API `2.2.0`. Its SDK dependency is pinned to `1.15.0`. Use the `api22` npm tag to opt in; the `latest` and `api21` tags keep their existing contracts.
|
|
4
|
+
|
|
3
5
|
Official ParseAPI MCP server. Look up places, addresses, companies, email, phone, weather, timezones, dates and more from your AI agent.
|
|
4
6
|
|
|
5
7
|
## Hosted
|
|
6
8
|
|
|
7
9
|
One URL, nothing to install. Add the server and sign in once in the browser. Free plan works.
|
|
8
10
|
|
|
9
|
-
|
|
11
|
+
Installing a local package does not update the shared hosted service. Hosted activation is reviewed separately.
|
|
10
12
|
|
|
11
13
|
```json
|
|
12
14
|
{
|
|
@@ -40,7 +42,7 @@ CI and headless setups skip the browser with a key from [parseapi.com](https://p
|
|
|
40
42
|
"mcpServers": {
|
|
41
43
|
"parseAPI": {
|
|
42
44
|
"command": "npx",
|
|
43
|
-
"args": ["-y", "parseapi-mcp@
|
|
45
|
+
"args": ["-y", "parseapi-mcp@api22"],
|
|
44
46
|
"env": { "PARSEAPI_KEY": "your-api-key" }
|
|
45
47
|
}
|
|
46
48
|
}
|
|
@@ -49,7 +51,7 @@ CI and headless setups skip the browser with a key from [parseapi.com](https://p
|
|
|
49
51
|
|
|
50
52
|
## API versions
|
|
51
53
|
|
|
52
|
-
Since version 1.0.0, the package explicitly selects the API contract supported by this MCP package. This version sends `X-API-Version: 2.
|
|
54
|
+
Since version 1.0.0, the package explicitly selects the API contract supported by this MCP package. This version sends `X-API-Version: 2.2.0` on every API tool request, matching its tool descriptions and SDK response types. The contract is fixed for local stdio and HTTP servers running this package, including retries. The shared hosted service remains on its existing API 2.0 release. Your key, OAuth identity and team's saved default stay the same. The API still accepts earlier `Parse-Version` request pins.
|
|
53
55
|
|
|
54
56
|
For local stdio, pin the MCP package version in your application configuration and test the new release before deploying it. A future major MCP upgrade can select a newer API contract. There is no version argument to add to individual tool calls. The hosted service uses the API contract supported by its deployed MCP release.
|
|
55
57
|
|
|
@@ -58,8 +60,9 @@ MCP packages older than 1.0.0 keep their existing behavior and use the team's de
|
|
|
58
60
|
## ISO identifiers
|
|
59
61
|
|
|
60
62
|
Country uses `iso_alpha3` and `iso_numeric`, State uses the full
|
|
61
|
-
`
|
|
62
|
-
uses `iso_numeric`.
|
|
63
|
+
`iso_code` such as `US-CA`, Language uses `iso_alpha3`, and Currency
|
|
64
|
+
uses `iso_numeric`. County lookup and State county-list items include nullable
|
|
65
|
+
`iso_code` for an exact recorded ISO 3166-2 assignment; unsupported assignments stay null. Primary `country`, `state`, `language` and `currency` codes
|
|
63
66
|
keep their meaning. Results retain the selected API contract's exact keys,
|
|
64
67
|
values, nulls and nesting. Earlier server contracts retain their earlier ISO
|
|
65
68
|
spellings. Use the existing lookup methods for each resource.
|
|
@@ -161,7 +164,7 @@ The estimate allows up to three attempts per ordinary lookup and one per Email D
|
|
|
161
164
|
For a compact tool catalog, set `PARSEAPI_MCP_MODE=compact` on the MCP process:
|
|
162
165
|
|
|
163
166
|
```bash
|
|
164
|
-
PARSEAPI_MCP_MODE=compact npx -y parseapi-mcp@
|
|
167
|
+
PARSEAPI_MCP_MODE=compact npx -y parseapi-mcp@api22
|
|
165
168
|
```
|
|
166
169
|
|
|
167
170
|
Set `PARSEAPI_KEY` in the process environment for lookups. Compact mode advertises three tools, `discover`, `preflight` and `lookup`. After discovering an operation, pass its exact name and arguments:
|
|
@@ -340,6 +343,12 @@ The 2.0 API is a temporary migration bridge for older installed clients. There i
|
|
|
340
343
|
|
|
341
344
|
## Upgrade to API 2.1
|
|
342
345
|
|
|
343
|
-
|
|
346
|
+
API `2.1.0` introduced natural fields. Update existing `.deep` property reads to the fields at their natural homes, such as `country.population`. User-Agent identities are objects; Postal tax and Weather observations keep their documented object homes. Paid profile detail is automatic in API 2.1. Existing explicit depth requests remain supported; verification stays explicit.
|
|
344
347
|
|
|
345
348
|
**This minor version changes existing field reads.** Upgrade the SDK and your application reads together. Existing factories remain. Email verification is explicit and includes basic validation; Carrier/HLR need no extra detail request. Preserve missing values, `null`, `false` and `0`.
|
|
349
|
+
|
|
350
|
+
## County migration: HTTP API 2.2
|
|
351
|
+
|
|
352
|
+
This source selects HTTP API `2.2.0`. County is the public name for counties and comparable administrative areas internationally. Use `county` and the State counties operation. Read `county`, `county_name`, `county_name_local` and `counties` in affected geography results; City `capital_of` uses `county` for this administrative level. Actual local types such as `department` and `district` retain their meaning.
|
|
353
|
+
|
|
354
|
+
This is a breaking field-read upgrade from earlier contracts. Canonical tools are `county` and `state_counties`. Deprecated `district` and `state_districts` tools preserve their historical result keys and omit the added County `iso_code` through a tool-only adapter; other geography tools use the canonical County fields. Hosted activation requires a separate compatibility review. Update property reads before upgrading. Older installed packages keep their existing API contract, and this client does not change an account's saved default. The shared hosted service and existing npm tags are unchanged by this opt-in package.
|
|
@@ -46,7 +46,7 @@ import * as z from "zod";
|
|
|
46
46
|
// src/agent-catalog.json
|
|
47
47
|
var agent_catalog_default = {
|
|
48
48
|
schema_version: "1.0.0",
|
|
49
|
-
api_version: "2.
|
|
49
|
+
api_version: "2.2.0",
|
|
50
50
|
operations: {
|
|
51
51
|
email: {
|
|
52
52
|
operation: "email",
|
|
@@ -121,7 +121,7 @@ var agent_catalog_default = {
|
|
|
121
121
|
guidance: "Basic syntax and routing checks do not establish mailbox deliverability. Use email_verify explicitly for that metered operation."
|
|
122
122
|
},
|
|
123
123
|
docs: {
|
|
124
|
-
help: "https://api.parseapi.com/version/2.
|
|
124
|
+
help: "https://api.parseapi.com/version/2.2.0/email/help",
|
|
125
125
|
guide: "https://parseapi.com/docs/email"
|
|
126
126
|
}
|
|
127
127
|
},
|
|
@@ -206,7 +206,7 @@ var agent_catalog_default = {
|
|
|
206
206
|
guidance: "available=null is a completed HTTP response with an unknown fact, not evidence the domain is free. Do not retry automatically from null; respect rate and quota errors."
|
|
207
207
|
},
|
|
208
208
|
docs: {
|
|
209
|
-
help: "https://api.parseapi.com/version/2.
|
|
209
|
+
help: "https://api.parseapi.com/version/2.2.0/domain/help",
|
|
210
210
|
guide: "https://parseapi.com/docs/domain"
|
|
211
211
|
}
|
|
212
212
|
},
|
|
@@ -292,7 +292,7 @@ var agent_catalog_default = {
|
|
|
292
292
|
guidance: "An empty records array and a DNS-name 404 are negative answers, not transient failures. Reuse records only within their remaining TTL; respect rate and quota errors."
|
|
293
293
|
},
|
|
294
294
|
docs: {
|
|
295
|
-
help: "https://api.parseapi.com/version/2.
|
|
295
|
+
help: "https://api.parseapi.com/version/2.2.0/dns/help",
|
|
296
296
|
guide: "https://parseapi.com/docs/dns"
|
|
297
297
|
}
|
|
298
298
|
},
|
|
@@ -367,7 +367,7 @@ var agent_catalog_default = {
|
|
|
367
367
|
guidance: "Do not retry solely because mx is empty. Use email for mail-route validation or dns for explicit A/AAAA records; respect rate and quota errors."
|
|
368
368
|
},
|
|
369
369
|
docs: {
|
|
370
|
-
help: "https://api.parseapi.com/version/2.
|
|
370
|
+
help: "https://api.parseapi.com/version/2.2.0/mx/help",
|
|
371
371
|
guide: "https://parseapi.com/docs/mx"
|
|
372
372
|
}
|
|
373
373
|
},
|
|
@@ -470,7 +470,7 @@ var agent_catalog_default = {
|
|
|
470
470
|
guidance: "Do not retry to fill null reference fields or a locked deep object. Preserve unknowns and distinguish reported zero from null; respect rate and quota errors."
|
|
471
471
|
},
|
|
472
472
|
docs: {
|
|
473
|
-
help: "https://api.parseapi.com/version/2.
|
|
473
|
+
help: "https://api.parseapi.com/version/2.2.0/country/help",
|
|
474
474
|
guide: "https://parseapi.com/docs/country"
|
|
475
475
|
}
|
|
476
476
|
},
|
|
@@ -595,7 +595,7 @@ var agent_catalog_default = {
|
|
|
595
595
|
guidance: "Do not retry unresolved/ambiguous locations or rejected wall times automatically. Correct the input or choose a resolution. Retried calls with omitted at evaluate a later now; pin an explicit instant when repeatability matters."
|
|
596
596
|
},
|
|
597
597
|
docs: {
|
|
598
|
-
help: "https://api.parseapi.com/version/2.
|
|
598
|
+
help: "https://api.parseapi.com/version/2.2.0/time/help",
|
|
599
599
|
guide: "https://parseapi.com/docs/time"
|
|
600
600
|
}
|
|
601
601
|
},
|
|
@@ -707,7 +707,7 @@ var agent_catalog_default = {
|
|
|
707
707
|
guidance: "Do not retry a successful unknown prefix or null fields to manufacture a match. Honor Retry-After; waits over five seconds return the API error without automatic retry."
|
|
708
708
|
},
|
|
709
709
|
docs: {
|
|
710
|
-
help: "https://api.parseapi.com/version/2.
|
|
710
|
+
help: "https://api.parseapi.com/version/2.2.0/card/help",
|
|
711
711
|
guide: "https://parseapi.com/docs/card",
|
|
712
712
|
attribution: "https://parseapi.com/legal/attribution#bin"
|
|
713
713
|
}
|
|
@@ -783,7 +783,7 @@ var agent_catalog_default = {
|
|
|
783
783
|
guidance: "Do not retry an empty match list automatically. Correct or broaden the identifier query."
|
|
784
784
|
},
|
|
785
785
|
docs: {
|
|
786
|
-
help: "https://api.parseapi.com/version/2.
|
|
786
|
+
help: "https://api.parseapi.com/version/2.2.0/time/help",
|
|
787
787
|
guide: "https://parseapi.com/docs/time"
|
|
788
788
|
}
|
|
789
789
|
},
|
|
@@ -855,7 +855,7 @@ var agent_catalog_default = {
|
|
|
855
855
|
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
856
856
|
},
|
|
857
857
|
docs: {
|
|
858
|
-
help: "https://api.parseapi.com/version/2.
|
|
858
|
+
help: "https://api.parseapi.com/version/2.2.0/emoji/help",
|
|
859
859
|
guide: "https://parseapi.com/docs/emoji"
|
|
860
860
|
}
|
|
861
861
|
},
|
|
@@ -926,7 +926,7 @@ var agent_catalog_default = {
|
|
|
926
926
|
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
927
927
|
},
|
|
928
928
|
docs: {
|
|
929
|
-
help: "https://api.parseapi.com/version/2.
|
|
929
|
+
help: "https://api.parseapi.com/version/2.2.0/emoji/help",
|
|
930
930
|
guide: "https://parseapi.com/docs/emoji"
|
|
931
931
|
}
|
|
932
932
|
},
|
|
@@ -996,7 +996,7 @@ var agent_catalog_default = {
|
|
|
996
996
|
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
997
997
|
},
|
|
998
998
|
docs: {
|
|
999
|
-
help: "https://api.parseapi.com/version/2.
|
|
999
|
+
help: "https://api.parseapi.com/version/2.2.0/emoji/help",
|
|
1000
1000
|
guide: "https://parseapi.com/docs/emoji"
|
|
1001
1001
|
}
|
|
1002
1002
|
},
|
|
@@ -1051,7 +1051,7 @@ var agent_catalog_default = {
|
|
|
1051
1051
|
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
1052
1052
|
},
|
|
1053
1053
|
docs: {
|
|
1054
|
-
help: "https://api.parseapi.com/version/2.
|
|
1054
|
+
help: "https://api.parseapi.com/version/2.2.0/emoji/help",
|
|
1055
1055
|
guide: "https://parseapi.com/docs/emoji"
|
|
1056
1056
|
}
|
|
1057
1057
|
},
|
|
@@ -1120,7 +1120,7 @@ var agent_catalog_default = {
|
|
|
1120
1120
|
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
1121
1121
|
},
|
|
1122
1122
|
docs: {
|
|
1123
|
-
help: "https://api.parseapi.com/version/2.
|
|
1123
|
+
help: "https://api.parseapi.com/version/2.2.0/emoji/help",
|
|
1124
1124
|
guide: "https://parseapi.com/docs/emoji"
|
|
1125
1125
|
}
|
|
1126
1126
|
},
|
|
@@ -1190,7 +1190,7 @@ var agent_catalog_default = {
|
|
|
1190
1190
|
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
1191
1191
|
},
|
|
1192
1192
|
docs: {
|
|
1193
|
-
help: "https://api.parseapi.com/version/2.
|
|
1193
|
+
help: "https://api.parseapi.com/version/2.2.0/emoji/help",
|
|
1194
1194
|
guide: "https://parseapi.com/docs/emoji"
|
|
1195
1195
|
}
|
|
1196
1196
|
},
|
|
@@ -1252,7 +1252,7 @@ var agent_catalog_default = {
|
|
|
1252
1252
|
guidance: "Do not retry to fill missing source facts or unsupported glyphs. Ordinary retries can consume additional pooled requests; rate and quota limits still apply."
|
|
1253
1253
|
},
|
|
1254
1254
|
docs: {
|
|
1255
|
-
help: "https://api.parseapi.com/version/2.
|
|
1255
|
+
help: "https://api.parseapi.com/version/2.2.0/emoji/help",
|
|
1256
1256
|
guide: "https://parseapi.com/docs/emoji"
|
|
1257
1257
|
}
|
|
1258
1258
|
},
|
|
@@ -1288,7 +1288,7 @@ var agent_catalog_default = {
|
|
|
1288
1288
|
},
|
|
1289
1289
|
access: {
|
|
1290
1290
|
plans: "all",
|
|
1291
|
-
credentials: "Existing permitted API or app key; API 2.
|
|
1291
|
+
credentials: "Existing permitted API or app key; API 2.2.0",
|
|
1292
1292
|
deep: "Not accepted; complete collection metadata is core",
|
|
1293
1293
|
effective_access: null,
|
|
1294
1294
|
preflight_and_tasks: "Unsupported by the current single-value preflight/task execution contract; use a direct collection lookup."
|
|
@@ -1299,7 +1299,7 @@ var agent_catalog_default = {
|
|
|
1299
1299
|
"Optional type and region; a region must be represented in every reached annual calendar"
|
|
1300
1300
|
],
|
|
1301
1301
|
docs: {
|
|
1302
|
-
help: "https://api.parseapi.com/version/2.
|
|
1302
|
+
help: "https://api.parseapi.com/version/2.2.0/holiday/help",
|
|
1303
1303
|
reference: "https://parseapi.com/docs/holiday"
|
|
1304
1304
|
},
|
|
1305
1305
|
retry: {
|
|
@@ -1378,7 +1378,7 @@ var agent_catalog_default = {
|
|
|
1378
1378
|
effective_access: null
|
|
1379
1379
|
},
|
|
1380
1380
|
docs: {
|
|
1381
|
-
help: "https://api.parseapi.com/version/2.
|
|
1381
|
+
help: "https://api.parseapi.com/version/2.2.0/holiday/help",
|
|
1382
1382
|
reference: "https://parseapi.com/docs/holiday"
|
|
1383
1383
|
},
|
|
1384
1384
|
retry: {
|
|
@@ -1418,7 +1418,7 @@ var agent_catalog_default = {
|
|
|
1418
1418
|
},
|
|
1419
1419
|
access: {
|
|
1420
1420
|
plans: "all",
|
|
1421
|
-
credentials: "Existing permitted API or app key; API 2.
|
|
1421
|
+
credentials: "Existing permitted API or app key; API 2.2.0",
|
|
1422
1422
|
deep: "Not accepted; complete collection metadata is core",
|
|
1423
1423
|
effective_access: null,
|
|
1424
1424
|
preflight_and_tasks: "Unsupported by the current single-value preflight/task execution contract; use a direct collection lookup."
|
|
@@ -1429,7 +1429,7 @@ var agent_catalog_default = {
|
|
|
1429
1429
|
"Optional type and region; a region must be represented in every reached annual calendar"
|
|
1430
1430
|
],
|
|
1431
1431
|
docs: {
|
|
1432
|
-
help: "https://api.parseapi.com/version/2.
|
|
1432
|
+
help: "https://api.parseapi.com/version/2.2.0/holiday/help",
|
|
1433
1433
|
reference: "https://parseapi.com/docs/holiday"
|
|
1434
1434
|
},
|
|
1435
1435
|
retry: {
|
|
@@ -1533,7 +1533,7 @@ var agent_catalog_default = {
|
|
|
1533
1533
|
guidance: "A successful response with unknown facts is a completed result, not a reason to retry. Respect explicit unavailable errors and retry guidance."
|
|
1534
1534
|
},
|
|
1535
1535
|
docs: {
|
|
1536
|
-
help: "https://api.parseapi.com/version/2.
|
|
1536
|
+
help: "https://api.parseapi.com/version/2.2.0/postal/help",
|
|
1537
1537
|
guide: "https://parseapi.com/docs/postal"
|
|
1538
1538
|
}
|
|
1539
1539
|
},
|
|
@@ -1596,7 +1596,7 @@ var agent_catalog_default = {
|
|
|
1596
1596
|
guidance: "A successful response with unknown facts is a completed result, not a reason to retry. Respect explicit unavailable errors and retry guidance."
|
|
1597
1597
|
},
|
|
1598
1598
|
docs: {
|
|
1599
|
-
help: "https://api.parseapi.com/version/2.
|
|
1599
|
+
help: "https://api.parseapi.com/version/2.2.0/postal/help",
|
|
1600
1600
|
guide: "https://parseapi.com/docs/postal"
|
|
1601
1601
|
}
|
|
1602
1602
|
},
|
|
@@ -1658,7 +1658,7 @@ var agent_catalog_default = {
|
|
|
1658
1658
|
guidance: "A successful response with unknown facts is a completed result, not a reason to retry. Respect explicit unavailable errors and retry guidance."
|
|
1659
1659
|
},
|
|
1660
1660
|
docs: {
|
|
1661
|
-
help: "https://api.parseapi.com/version/2.
|
|
1661
|
+
help: "https://api.parseapi.com/version/2.2.0/postal/help",
|
|
1662
1662
|
guide: "https://parseapi.com/docs/postal"
|
|
1663
1663
|
}
|
|
1664
1664
|
},
|
|
@@ -1717,8 +1717,8 @@ var agent_catalog_default = {
|
|
|
1717
1717
|
},
|
|
1718
1718
|
errors: {
|
|
1719
1719
|
"400": "Invalid controls or cursor from another query/catalog; restart pagination when the edition changes",
|
|
1720
|
-
"409": "ambiguous_city under ambiguity=error; bounded safe candidates without Deep",
|
|
1721
1720
|
"404": "City ID or name is not present in the serving catalog",
|
|
1721
|
+
"409": "ambiguous_city under ambiguity=error; bounded safe candidates without Deep",
|
|
1722
1722
|
"503": "Required catalog or admitted spelling index unavailable"
|
|
1723
1723
|
},
|
|
1724
1724
|
billing: {
|
|
@@ -1768,7 +1768,7 @@ var agent_catalog_default = {
|
|
|
1768
1768
|
]
|
|
1769
1769
|
},
|
|
1770
1770
|
docs: {
|
|
1771
|
-
help: "https://api.parseapi.com/version/2.
|
|
1771
|
+
help: "https://api.parseapi.com/version/2.2.0/city/help",
|
|
1772
1772
|
guide: "https://parseapi.com/docs/city",
|
|
1773
1773
|
selection: "https://parseapi.com/docs/city#choose-a-city",
|
|
1774
1774
|
continuity: "https://parseapi.com/docs/city#stable-ids"
|
|
@@ -1875,7 +1875,7 @@ var agent_catalog_default = {
|
|
|
1875
1875
|
guidance: "Do not infer a retry from null. Repeated completed checks consume additional verification units; a transport failure does not prove the previous attempt was unbilled. DNS failures can return 503 before mailbox verification."
|
|
1876
1876
|
},
|
|
1877
1877
|
docs: {
|
|
1878
|
-
help: "https://api.parseapi.com/version/2.
|
|
1878
|
+
help: "https://api.parseapi.com/version/2.2.0/email/help",
|
|
1879
1879
|
guide: "https://parseapi.com/docs/email"
|
|
1880
1880
|
}
|
|
1881
1881
|
}
|
|
@@ -1962,7 +1962,7 @@ function registerDiscovery(server, operations, mode, apiVersion) {
|
|
|
1962
1962
|
if (mode !== "compact") return;
|
|
1963
1963
|
server.registerTool("lookup", {
|
|
1964
1964
|
title: "Run a ParseAPI lookup",
|
|
1965
|
-
description: "Run one ParseAPI operation found with discover. Pass its exact name and arguments. Uses the same validation, API 2.
|
|
1965
|
+
description: "Run one ParseAPI operation found with discover. Pass its exact name and arguments. Uses the same validation, API 2.2.0 contract, credentials and billing as the named lookup. Reads can consume pooled or paid units. Ordinary lookups can retry twice, metered checks default to no retries.",
|
|
1966
1966
|
inputSchema: z.object({ operation: z.string().min(1).max(64), arguments: object2 }),
|
|
1967
1967
|
annotations: { readOnlyHint: true, idempotentHint: false }
|
|
1968
1968
|
}, async (args, context) => {
|
|
@@ -2101,7 +2101,7 @@ function registerBulk(server, key, transport) {
|
|
|
2101
2101
|
// package.json
|
|
2102
2102
|
var package_default = {
|
|
2103
2103
|
name: "parseapi-mcp",
|
|
2104
|
-
version: "1.
|
|
2104
|
+
version: "1.14.0",
|
|
2105
2105
|
mcpName: "com.parseapi/mcp",
|
|
2106
2106
|
description: "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
|
|
2107
2107
|
keywords: [
|
|
@@ -2151,7 +2151,7 @@ var package_default = {
|
|
|
2151
2151
|
dependencies: {
|
|
2152
2152
|
"@modelcontextprotocol/node": "^2.0.0",
|
|
2153
2153
|
"@modelcontextprotocol/server": "^2.0.0",
|
|
2154
|
-
"@parseapi/sdk": "
|
|
2154
|
+
"@parseapi/sdk": "1.15.0",
|
|
2155
2155
|
zod: "^4.0.0"
|
|
2156
2156
|
},
|
|
2157
2157
|
devDependencies: {
|
|
@@ -2166,9 +2166,9 @@ var package_default = {
|
|
|
2166
2166
|
|
|
2167
2167
|
// src/registry.ts
|
|
2168
2168
|
var VERSION = package_default.version;
|
|
2169
|
-
var API_VERSION = "2.
|
|
2169
|
+
var API_VERSION = "2.2.0";
|
|
2170
2170
|
var AU_POSTAL_NOTICE = "Incorporates or developed using G-NAF \xA9 Geoscape Australia licensed by the Commonwealth of Australia under the Open Geo-coded National Address File (G-NAF) End User Licence Agreement. Geographic choices are not mailing-address verification. Source, adaptations and licence: https://parseapi.com/legal/attribution#postal-au";
|
|
2171
|
-
var deep = z5.boolean().optional().describe("Legacy profile request flag. API 2.
|
|
2171
|
+
var deep = z5.boolean().optional().describe("Legacy profile request flag. API 2.2 paid plans include profile detail automatically. Existing access rules and explicit metered operations remain unchanged.");
|
|
2172
2172
|
var lat = z5.number().min(-90).max(90).describe("Latitude in decimal degrees");
|
|
2173
2173
|
var lon = z5.number().min(-180).max(180).describe("Longitude in decimal degrees");
|
|
2174
2174
|
var iso2 = (what) => z5.string().describe(`ISO 3166-1 alpha-2 ${what}, e.g. US`);
|
|
@@ -2227,7 +2227,7 @@ function cityCollectionArguments(args) {
|
|
|
2227
2227
|
romanized: args.romanized || void 0
|
|
2228
2228
|
};
|
|
2229
2229
|
}
|
|
2230
|
-
var languageTools = /* @__PURE__ */ new Set(["ip", "ip_self", "asn", "company", "continent", "continent_countries", "country", "country_states", "state", "state_districts", "district", "city", "city_id", "city_search", "city_nearest", "city_nearby", "postal", "postal_nearby", "postal_distance", "currency", "language", "date", "time", "timezone", "emoji", "emoji_search", "emoji_browse", "emoji_parse", "emoji_catalog", "point", "city_list", "city_nearby_coordinates", "city_children", "city_ancestors", "city_siblings"]);
|
|
2230
|
+
var languageTools = /* @__PURE__ */ new Set(["ip", "ip_self", "asn", "company", "continent", "continent_countries", "country", "country_states", "state", "state_counties", "county", "state_districts", "district", "city", "city_id", "city_search", "city_nearest", "city_nearby", "postal", "postal_nearby", "postal_distance", "currency", "language", "date", "time", "timezone", "emoji", "emoji_search", "emoji_browse", "emoji_parse", "emoji_catalog", "point", "city_list", "city_nearby_coordinates", "city_children", "city_ancestors", "city_siblings"]);
|
|
2231
2231
|
var displayLanguage = z5.string().min(2).max(64).optional().describe("Optional display language, such as fr or zh-Hant. IDs, numeric values and input parsing stay unchanged.");
|
|
2232
2232
|
var emojiFilters = {
|
|
2233
2233
|
limit: z5.number().int().min(1).max(50).optional().describe("Maximum results per page."),
|
|
@@ -2239,6 +2239,12 @@ var emojiFilters = {
|
|
|
2239
2239
|
offset: z5.number().int().min(0).max(1e5).optional().describe("Page offset. Reuse next_offset with the same filters."),
|
|
2240
2240
|
deep: deep.describe("Include optional detail when supported; access follows this operation's plan or included-unit rules.")
|
|
2241
2241
|
};
|
|
2242
|
+
function legacyDistrictResult(value) {
|
|
2243
|
+
if (Array.isArray(value)) return value.map(legacyDistrictResult);
|
|
2244
|
+
if (!value || typeof value !== "object") return value;
|
|
2245
|
+
const names = { county: "district", county_name: "district_name", county_name_local: "district_name_local", counties: "districts" };
|
|
2246
|
+
return Object.fromEntries(Object.entries(value).filter(([key]) => !(key === "iso_code" && Object.hasOwn(value, "county"))).map(([key, item]) => [Object.hasOwn(names, key) ? names[key] : key, legacyDistrictResult(item)]));
|
|
2247
|
+
}
|
|
2242
2248
|
function buildServer(key, transport, options = {}) {
|
|
2243
2249
|
const mode = options.mode ?? "full";
|
|
2244
2250
|
if (mode !== "full" && mode !== "compact") throw new Error("Unknown MCP catalog mode");
|
|
@@ -2336,7 +2342,7 @@ function buildServer(key, transport, options = {}) {
|
|
|
2336
2342
|
);
|
|
2337
2343
|
tool(
|
|
2338
2344
|
"state",
|
|
2339
|
-
"Look up a state or province by code or name, with its full
|
|
2345
|
+
"Look up a state or province by code or name, with its full iso_code identifier. Paid plans include its demographic and tax profile automatically. Pass country to resolve a colliding code.",
|
|
2340
2346
|
{
|
|
2341
2347
|
code: z5.string().describe("State code or name, e.g. colorado, NC"),
|
|
2342
2348
|
country: countryOpt,
|
|
@@ -2344,27 +2350,35 @@ function buildServer(key, transport, options = {}) {
|
|
|
2344
2350
|
},
|
|
2345
2351
|
(c, a, request) => c.state(a.code, { ...request, deep: a.deep, country: a.country })
|
|
2346
2352
|
);
|
|
2347
|
-
|
|
2348
|
-
|
|
2349
|
-
|
|
2350
|
-
|
|
2351
|
-
|
|
2352
|
-
|
|
2353
|
-
|
|
2354
|
-
|
|
2355
|
-
|
|
2356
|
-
|
|
2357
|
-
|
|
2358
|
-
|
|
2359
|
-
|
|
2360
|
-
|
|
2361
|
-
|
|
2362
|
-
|
|
2363
|
-
|
|
2364
|
-
|
|
2365
|
-
|
|
2366
|
-
|
|
2367
|
-
|
|
2353
|
+
for (const deprecated of [false, true]) {
|
|
2354
|
+
tool(
|
|
2355
|
+
deprecated ? "state_districts" : "state_counties",
|
|
2356
|
+
deprecated ? "Deprecated alias for state_counties. Retains historical districts/district result keys for existing tool callers. Paid plans include population automatically." : "List the counties and comparable administrative areas of a state, including nullable ISO 3166-2 iso_code on each item. Paid plans include population in each result automatically.",
|
|
2357
|
+
{
|
|
2358
|
+
code: z5.string().describe("State code or name, e.g. NC, colorado"),
|
|
2359
|
+
country: countryOpt,
|
|
2360
|
+
deep: deep.describe("Include population in each county on a paid plan.")
|
|
2361
|
+
},
|
|
2362
|
+
async (c, a, request) => {
|
|
2363
|
+
const result = await c.state.counties(a.code, { ...request, deep: a.deep, country: a.country });
|
|
2364
|
+
return deprecated ? legacyDistrictResult(result) : result;
|
|
2365
|
+
}
|
|
2366
|
+
);
|
|
2367
|
+
tool(
|
|
2368
|
+
deprecated ? "district" : "county",
|
|
2369
|
+
deprecated ? "Deprecated alias for county. Retains the historical district result key for existing tool callers." : "Look up a county or comparable administrative area by code or name, with nullable ISO 3166-2 iso_code. Paid plans include area, population and seat automatically. Pass state to resolve a colliding name. Property_tax contains annual_median, currency and period: median annual tax payable on owner-occupied homes in the area, adjusted to the final year of that period. It is not a rate or property bill. Unsupported, missing and censored estimates are null.",
|
|
2370
|
+
{
|
|
2371
|
+
code: z5.string().describe("County code or name, e.g. 37081, guilford county"),
|
|
2372
|
+
country: countryOpt,
|
|
2373
|
+
state: z5.string().optional().describe("ADM1 code or name to disambiguate, e.g. NC or louisiana"),
|
|
2374
|
+
deep: deep.describe("Compatibility flag; paid plans include this profile detail automatically.")
|
|
2375
|
+
},
|
|
2376
|
+
async (c, a, request) => {
|
|
2377
|
+
const result = await c.county(a.code, { ...request, deep: a.deep, country: a.country, state: a.state });
|
|
2378
|
+
return deprecated ? legacyDistrictResult(result) : result;
|
|
2379
|
+
}
|
|
2380
|
+
);
|
|
2381
|
+
}
|
|
2368
2382
|
tool(
|
|
2369
2383
|
"city",
|
|
2370
2384
|
"Resolve a city name to coordinates, timezone and administrative context. Paid plans include demographic and geographic detail automatically. Pass country or state for name ties.",
|
package/dist/http.js
CHANGED
package/dist/registry.js
CHANGED
package/dist/stdio.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "parseapi-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.14.0",
|
|
4
4
|
"mcpName": "com.parseapi/mcp",
|
|
5
5
|
"description": "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
|
|
6
6
|
"keywords": [
|
|
@@ -50,7 +50,7 @@
|
|
|
50
50
|
"dependencies": {
|
|
51
51
|
"@modelcontextprotocol/node": "^2.0.0",
|
|
52
52
|
"@modelcontextprotocol/server": "^2.0.0",
|
|
53
|
-
"@parseapi/sdk": "
|
|
53
|
+
"@parseapi/sdk": "1.15.0",
|
|
54
54
|
"zod": "^4.0.0"
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|