parseapi-mcp 1.10.3 → 1.10.5
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 +4 -15
- package/dist/{chunk-TBKFVFVQ.js → chunk-QOTNYA4K.js} +4 -93
- 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,6 +1,6 @@
|
|
|
1
1
|
# parseapi-mcp
|
|
2
2
|
|
|
3
|
-
Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather,
|
|
3
|
+
Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, timezones, dates and more from your AI agent.
|
|
4
4
|
|
|
5
5
|
## Hosted
|
|
6
6
|
|
|
@@ -57,7 +57,7 @@ MCP packages older than 1.0.0 keep their existing behavior and use the team's de
|
|
|
57
57
|
|
|
58
58
|
Full mode provides 68 local lookup tools and 67 hosted lookup tools, plus `discover` for local metadata and `preflight` for authenticated task estimates. `ip_self` is local only. `time` returns current local time and Unix seconds. It accepts a timezone or coordinates and defaults to UTC when both are omitted. `date` parses the supplied date, or returns today in UTC when omitted. Existing `timezone` calls remain supported with their original arguments. Every lookup returns the JSON the API serves.
|
|
59
59
|
|
|
60
|
-
Tools follow the lookup names: `country_states`, `city_search`, `postal_nearby`, `address`, `address_search`, `company`, `company_id`, `company_search`, `company_coverage`, `email`, `
|
|
60
|
+
Tools follow the lookup names: `country_states`, `city_search`, `postal_nearby`, `address`, `address_search`, `company`, `company_id`, `company_search`, `company_coverage`, `email`, `bank_us_ach`, `card`, `industry`, `industry_search`, `dns`, `asn`, `mac`, `currency_rate`, and the rest. Text searches take `query`. Company directory search supports one name/domain/ticker/identifier selector or country/exact-SIC discovery filters.
|
|
61
61
|
|
|
62
62
|
The existing `naics` and `naics_search` tools remain available as compatibility names for Industry.
|
|
63
63
|
|
|
@@ -73,7 +73,6 @@ Example tool arguments:
|
|
|
73
73
|
| `dns` | `{"domain":"example.com","type":"TXT"}` |
|
|
74
74
|
| `mx` | `{"domain":"example.com"}` |
|
|
75
75
|
| `asn` | `{"asn":"AS13335"}` |
|
|
76
|
-
| `mac` | `{"mac":"00:1B:63:84:45:E6"}` |
|
|
77
76
|
| `card` | `{"bin":"424242"}` |
|
|
78
77
|
| `country_states` | `{"code":"US"}` |
|
|
79
78
|
| `address_search` | `{"query":"1600 Pennsylvania","country":"US","city":"Washington","state":"DC"}` |
|
|
@@ -177,17 +176,9 @@ package does not activate it.
|
|
|
177
176
|
|
|
178
177
|
Display names follow available source translations. IDs, native-name fields,
|
|
179
178
|
numbers and input parsing stay unchanged. Omitted language keeps the default
|
|
180
|
-
behavior.
|
|
179
|
+
behavior. Holiday and prove tools have no new
|
|
181
180
|
language argument.
|
|
182
181
|
|
|
183
|
-
## Measurements
|
|
184
|
-
|
|
185
|
-
Call `measure` with `{ "measure": "5 ft 11 in", "to": "cm" }`. The result keeps the amount as the decimal string `"180.34"`. Without `to`, the result uses the canonical unit for its type. Optional `locale` and `system` (`us` or `imperial`) resolve explicit number or customary-unit ambiguity.
|
|
186
|
-
|
|
187
|
-
Call `measure_units` with `{ "unit": "m" }` to discover compatible targets, or `{}` for the reviewed catalog. Optional `query` and `type` filters narrow the list. Ambiguous input remains a successful result with `valid: false`, `reason`, and `choices`. Invalid targets return the ordinary API error. Both tools use pooled requests.
|
|
188
|
-
|
|
189
|
-
Successful JSON has `measure`, `valid`, `type`, `amount`, and `unit`. Invalid input adds `reason`. `choices` appears only when alternatives are available.
|
|
190
|
-
|
|
191
182
|
## Development
|
|
192
183
|
|
|
193
184
|
```bash
|
|
@@ -206,11 +197,9 @@ The [agent benchmark](eval/README.md) compares full and compact discovery on fix
|
|
|
206
197
|
MIT licensed.
|
|
207
198
|
|
|
208
199
|
|
|
209
|
-
Bank returns core `checks` for input, country, length, structure, checksum and national rules, plus an `issues` list. States are `passed`, `failed`, `not_checked` or `not_supported`. Unsupported national checking is not a failure. `valid` covers the implemented format and checksum rules, not account existence, ownership or payment reachability. Directory names and BICs may be null independently. Older responses may omit `checks` and `issues`, and future states and issue codes remain strings. Pass the original input unchanged so the API can report invalid characters. Deep `account` remains the BBAN remainder.
|
|
210
|
-
|
|
211
200
|
## Optional detail
|
|
212
201
|
|
|
213
|
-
Start with the default tool call. Use the same tool with `deep: true` for richer facts. Time, Date,
|
|
202
|
+
Start with the default tool call. Use the same tool with `deep: true` for richer facts. Time, Date, Language, Emoji, Phone and Point include detail on every plan. Geographic profiles, Name evidence and NAICS definitions require a paid plan. Carrier and HLR detail stays inside the same metered core unit, including Free allowance units, with no additional charge or second gate.
|
|
214
203
|
|
|
215
204
|
Search detail belongs to each returned entity. Time conversion puts target display detail in `to.deep`; only the source returns `deep.next_dst`. Name core parsing needs no dictionary lookup. Paid Name deep also returns flat `short`, `directory`, and `initials`. Optional `name_locale` selects CLDR formatting rules, defaults to `en`, and leaves parsing and gender context unchanged. Unavailable formatting is null, and older responses may omit these fields. Country, State and Postal tax references are in their paid deep bags.
|
|
216
205
|
|
|
@@ -1657,7 +1657,7 @@ function registerTasks(server, client, transport) {
|
|
|
1657
1657
|
// package.json
|
|
1658
1658
|
var package_default = {
|
|
1659
1659
|
name: "parseapi-mcp",
|
|
1660
|
-
version: "1.10.
|
|
1660
|
+
version: "1.10.5",
|
|
1661
1661
|
mcpName: "com.parseapi/mcp",
|
|
1662
1662
|
description: "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
|
|
1663
1663
|
keywords: [
|
|
@@ -1707,7 +1707,7 @@ var package_default = {
|
|
|
1707
1707
|
dependencies: {
|
|
1708
1708
|
"@modelcontextprotocol/node": "^2.0.0",
|
|
1709
1709
|
"@modelcontextprotocol/server": "^2.0.0",
|
|
1710
|
-
"@parseapi/sdk": "^1.11.
|
|
1710
|
+
"@parseapi/sdk": "^1.11.4",
|
|
1711
1711
|
zod: "^4.0.0"
|
|
1712
1712
|
},
|
|
1713
1713
|
devDependencies: {
|
|
@@ -1723,7 +1723,6 @@ var package_default = {
|
|
|
1723
1723
|
// src/registry.ts
|
|
1724
1724
|
var VERSION = package_default.version;
|
|
1725
1725
|
var API_VERSION = "2.0.0";
|
|
1726
|
-
var US_ROUTING_NOTICE = "Routing reference attribution: https://parseapi.com/legal/attribution#routing-numbers";
|
|
1727
1726
|
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";
|
|
1728
1727
|
var deep = z4.boolean().optional().describe("Include the nested deep object when available. Pricing depends on the operation.");
|
|
1729
1728
|
var lat = z4.number().min(-90).max(90).describe("Latitude in decimal degrees");
|
|
@@ -1743,7 +1742,6 @@ var titleWords = {
|
|
|
1743
1742
|
ach: "ACH",
|
|
1744
1743
|
url: "URL",
|
|
1745
1744
|
hlr: "HLR",
|
|
1746
|
-
mac: "MAC",
|
|
1747
1745
|
useragent: "User Agent"
|
|
1748
1746
|
};
|
|
1749
1747
|
var cityScope = {
|
|
@@ -1791,7 +1789,7 @@ function cityCollectionArguments(args) {
|
|
|
1791
1789
|
romanized: args.romanized || void 0
|
|
1792
1790
|
};
|
|
1793
1791
|
}
|
|
1794
|
-
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", "
|
|
1792
|
+
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", "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"]);
|
|
1795
1793
|
var displayLanguage = z4.string().min(2).max(64).optional().describe("Optional display language, such as fr or zh-Hant. IDs, numeric values and input parsing stay unchanged.");
|
|
1796
1794
|
var emojiFilters = {
|
|
1797
1795
|
limit: z4.number().int().min(1).max(50).optional().describe("Maximum results per page."),
|
|
@@ -1812,7 +1810,7 @@ function buildServer(key, transport, options = {}) {
|
|
|
1812
1810
|
name: "parseapi",
|
|
1813
1811
|
version: VERSION,
|
|
1814
1812
|
title: "ParseAPI",
|
|
1815
|
-
description: "Lookups for agents: IP and place data, addresses, company numbers, email,
|
|
1813
|
+
description: "Lookups for agents: IP and place data, addresses, company numbers, email, phone, domains, weather, timezones, dates and holidays. Real reference data instead of guessing.",
|
|
1816
1814
|
websiteUrl: "https://parseapi.com"
|
|
1817
1815
|
},
|
|
1818
1816
|
{ capabilities: { tools: {} } }
|
|
@@ -1842,9 +1840,6 @@ function buildServer(key, transport, options = {}) {
|
|
|
1842
1840
|
if (["postal", "postal_nearby", "postal_distance"].includes(name) && data && typeof data === "object" && "country" in data && data.country === "AU") {
|
|
1843
1841
|
result.content.push({ type: "text", text: AU_POSTAL_NOTICE });
|
|
1844
1842
|
}
|
|
1845
|
-
if (name === "bank_us_ach" && data && typeof data === "object" && "bank_name" in data && typeof data.bank_name === "string" && data.bank_name.length > 0) {
|
|
1846
|
-
result.content.push({ type: "text", text: US_ROUTING_NOTICE });
|
|
1847
|
-
}
|
|
1848
1843
|
return result;
|
|
1849
1844
|
} catch (err) {
|
|
1850
1845
|
return toErrorResult(err);
|
|
@@ -1863,27 +1858,6 @@ function buildServer(key, transport, options = {}) {
|
|
|
1863
1858
|
(args, context) => invoke(args, context.mcpReq.signal)
|
|
1864
1859
|
);
|
|
1865
1860
|
}
|
|
1866
|
-
tool(
|
|
1867
|
-
"measure",
|
|
1868
|
-
"Parse a measurement or convert it to a target unit. Supports mixed measurements such as 5 ft 11 in. Amount is a decimal string. Without to, returns the canonical unit for its type. Successful JSON omits reason and choices. Invalid input adds reason, and ambiguous units add choices. Use measure_units to discover accepted units. Pooled request, no separate check charge.",
|
|
1869
|
-
{
|
|
1870
|
-
measure: z4.string().min(1).max(256).describe("Measurement to parse, e.g. 5 ft 11 in or 10 kg"),
|
|
1871
|
-
to: z4.string().min(1).max(128).optional().describe("Target unit, e.g. cm or lb"),
|
|
1872
|
-
locale: z4.string().min(1).max(32).optional().describe("Explicit number locale, e.g. de-DE"),
|
|
1873
|
-
system: z4.enum(["us", "imperial"]).optional().describe("Resolve an ambiguous customary unit using the stated system")
|
|
1874
|
-
},
|
|
1875
|
-
(c, a, request) => c.measure(a.measure, { ...request, to: a.to, locale: a.locale, system: a.system })
|
|
1876
|
-
);
|
|
1877
|
-
tool(
|
|
1878
|
-
"measure_units",
|
|
1879
|
-
"Discover the reviewed measurement units, canonical codes, types and aliases. With no filters, returns the full catalog. Pass unit to find compatible conversion targets. Combine query and type to narrow results.",
|
|
1880
|
-
{
|
|
1881
|
-
query: z4.string().max(128).optional().describe("Search text, e.g. foot"),
|
|
1882
|
-
type: z4.string().min(1).max(64).optional().describe("Measurement type, e.g. length"),
|
|
1883
|
-
unit: z4.string().min(1).max(128).optional().describe("Return units compatible with this unit, e.g. m")
|
|
1884
|
-
},
|
|
1885
|
-
(c, a, request) => c.measure.units({ ...request, query: a.query, type: a.type, unit: a.unit })
|
|
1886
|
-
);
|
|
1887
1861
|
tool(
|
|
1888
1862
|
"ip",
|
|
1889
1863
|
"Look up an IPv4 or IPv6 address: country, region, ASN, timezone. Deep adds datacenter, relay, tor and vpn flags.",
|
|
@@ -2230,16 +2204,6 @@ function buildServer(key, transport, options = {}) {
|
|
|
2230
2204
|
{ email: z4.string().describe("Email address to validate"), deep },
|
|
2231
2205
|
(c, a, request) => c.email(a.email, { ...request, deep: a.deep })
|
|
2232
2206
|
);
|
|
2233
|
-
tool(
|
|
2234
|
-
"iban",
|
|
2235
|
-
"Parse an IBAN and check its format, ISO checksum, and published national BBAN checks, with known bank identifiers. Deep adds check digits, branch and account decomposition on every plan. Does not verify an account exists.",
|
|
2236
|
-
{
|
|
2237
|
-
iban: z4.string().describe("IBAN, with or without spaces, with or without the country prefix"),
|
|
2238
|
-
country: iso2("country code when the number has no prefix").optional(),
|
|
2239
|
-
deep: deep.describe("Include optional detail on every plan.")
|
|
2240
|
-
},
|
|
2241
|
-
(c, a, request) => c.iban(a.iban, { ...request, deep: a.deep, country: a.country })
|
|
2242
|
-
);
|
|
2243
2207
|
tool(
|
|
2244
2208
|
"bin",
|
|
2245
2209
|
"Look up a 6-11 digit payment-card prefix. Returns the actual longest matched prefix, issuer, country, brand key, brand name, card type and prepaid status where known. Unknown fields are null. Does not confirm a card or account exists. Pooled request on every plan.",
|
|
@@ -2249,34 +2213,6 @@ function buildServer(key, transport, options = {}) {
|
|
|
2249
2213
|
},
|
|
2250
2214
|
(c, a, request) => c.bin(a.bin, { ...request, deep: a.deep })
|
|
2251
2215
|
);
|
|
2252
|
-
tool(
|
|
2253
|
-
"bank",
|
|
2254
|
-
"Send an IBAN in a POST JSON body, keeping it out of the request URL. Parse with core checks and issues for input, country, length, structure, ISO checksum and supported national checks. not_supported is not a failed national check. Known bank names and BICs are independent nullable directory facts. Deep adds check digits, branch, the BBAN account remainder and source edition/match grain when a directory lookup ran, on every plan. Does not verify account existence, ownership or payment reachability.",
|
|
2255
|
-
{
|
|
2256
|
-
iban: z4.string().describe("Original IBAN input, with or without the country prefix. Preserve characters exactly so the API can report invalid input. Do not strip punctuation or decode percent escapes."),
|
|
2257
|
-
country: iso2("country code when the number has no prefix").optional(),
|
|
2258
|
-
deep: deep.describe("Include optional detail on every plan.")
|
|
2259
|
-
},
|
|
2260
|
-
(c, a, request) => c.bank(a.iban, { ...request, deep: a.deep, country: a.country })
|
|
2261
|
-
);
|
|
2262
|
-
tool(
|
|
2263
|
-
"bank_us_ach",
|
|
2264
|
-
"Check US routing-number format and ABA checksum plus account-field syntax. Sends original strings in a POST JSON body. No universal account checksum is available. A nullable bank_name is routing-directory identity only; this does not establish ACH eligibility, account existence or ownership. No deep option.",
|
|
2265
|
-
{
|
|
2266
|
-
routing: z4.string().describe("Original US routing string. Preserve leading zeros and characters; the API validates accepted separators."),
|
|
2267
|
-
account: z4.string().describe("Original account string. Preserve all characters, letter case and leading zeros; do not trim, normalize or decode.")
|
|
2268
|
-
},
|
|
2269
|
-
(c, a, request) => c.bankUsAch({ routing: a.routing, account: a.account }, request)
|
|
2270
|
-
);
|
|
2271
|
-
tool(
|
|
2272
|
-
"bank_requirements",
|
|
2273
|
-
"Describe supported Bank input fields, normalization rules, check scope and limitations for a country and format. Metadata only: support does not establish directory completeness or payment reachability.",
|
|
2274
|
-
{
|
|
2275
|
-
country: iso2("country code"),
|
|
2276
|
-
format: z4.string().optional().describe("Input format, currently iban (default) or us_ach. Unknown formats report supported false.")
|
|
2277
|
-
},
|
|
2278
|
-
(c, a, request) => c.bankRequirements(a.country, { ...request, format: a.format })
|
|
2279
|
-
);
|
|
2280
2216
|
tool(
|
|
2281
2217
|
"card",
|
|
2282
2218
|
"Identify a network and its CDN SVG logo from 2-11 leading digits, including processor-provided BIN/IIN prefixes. Unknown or ambiguous networks return null brand and a generic logo. Optional deep adds the longest recorded prefix, issuer, country, funding type and nullable prepaid status. Core identity is independent of issuer coverage. A shorter deep.prefix is broader coverage; missing fields never inherit from a parent row. Partial reference data does not prove card validity, account existence or payment acceptance. One pooled request on every plan, including deep.",
|
|
@@ -2343,12 +2279,6 @@ function buildServer(key, transport, options = {}) {
|
|
|
2343
2279
|
{ asn: z4.string().describe("Autonomous system number, such as AS13335 or 13335") },
|
|
2344
2280
|
(c, a, request) => c.asn(a.asn, request)
|
|
2345
2281
|
);
|
|
2346
|
-
tool(
|
|
2347
|
-
"mac",
|
|
2348
|
-
"Normalize a 48-bit MAC address and return its registered assignment holder, local flag, and multicast flag. Vendor is null for local or multicast addresses.",
|
|
2349
|
-
{ mac: z4.string().describe("MAC address") },
|
|
2350
|
-
(c, a, request) => c.mac(a.mac, request)
|
|
2351
|
-
);
|
|
2352
2282
|
tool(
|
|
2353
2283
|
"dns",
|
|
2354
2284
|
"Look up published DNS records with TTLs. Pooled on every plan. Omit type to check all ten supported types. The selected question may include its CNAME chain. Values retain DNS presentation syntax, including TXT quoting.",
|
|
@@ -2402,25 +2332,6 @@ function buildServer(key, transport, options = {}) {
|
|
|
2402
2332
|
},
|
|
2403
2333
|
(c, a, request) => c.industry.search(a.query, { ...request, deep: a.deep, limit: a.limit })
|
|
2404
2334
|
);
|
|
2405
|
-
tool(
|
|
2406
|
-
"currency",
|
|
2407
|
-
"Currency name, symbols and decimal places. Deep adds numeric code, plural name and using countries on every plan.",
|
|
2408
|
-
{ code: z4.string().describe("ISO 4217 code, e.g. USD"), deep: deep.describe("Include optional detail on every plan.") },
|
|
2409
|
-
(c, a, request) => c.currency(a.code, { ...request, deep: a.deep })
|
|
2410
|
-
);
|
|
2411
|
-
tool(
|
|
2412
|
-
"currency_rate",
|
|
2413
|
-
"Reference exchange rate between two currencies. Pass date for a past business day, amount to convert.",
|
|
2414
|
-
{
|
|
2415
|
-
base: z4.string().describe("Base currency ISO 4217 code, e.g. USD"),
|
|
2416
|
-
quote: z4.string().describe("Quote currency ISO 4217 code, e.g. EUR"),
|
|
2417
|
-
date: z4.string().optional().describe(
|
|
2418
|
-
"YYYY-MM-DD. Official rate for that business day. A weekend or holiday resolves to the last published day on or before it"
|
|
2419
|
-
),
|
|
2420
|
-
amount: z4.number().optional().describe("Appends amount and converted, rounded to the quote currency minor-unit digits")
|
|
2421
|
-
},
|
|
2422
|
-
(c, a, request) => c.currency.rate(a.base, a.quote, { ...request, date: a.date, amount: a.amount })
|
|
2423
|
-
);
|
|
2424
2335
|
tool(
|
|
2425
2336
|
"language",
|
|
2426
2337
|
"Language names, script and writing direction. Deep adds ISO3 and country associations on every plan.",
|
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.10.
|
|
3
|
+
"version": "1.10.5",
|
|
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": "^1.11.
|
|
53
|
+
"@parseapi/sdk": "^1.11.4",
|
|
54
54
|
"zod": "^4.0.0"
|
|
55
55
|
},
|
|
56
56
|
"devDependencies": {
|