parseapi-mcp 1.12.3 → 1.12.4

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 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, timezones, dates and more from your AI agent.
3
+ Official ParseAPI MCP server. Look up places, addresses, companies, email, phone, weather, timezones, dates and more from your AI agent.
4
4
 
5
5
  ## Hosted
6
6
 
@@ -66,7 +66,7 @@ spellings. Use the existing lookup methods for each resource.
66
66
 
67
67
  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.
68
68
 
69
- 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.
69
+ Tools follow the lookup names: `country_states`, `city_search`, `postal_nearby`, `address`, `address_search`, `company`, `company_id`, `company_search`, `company_coverage`, `email`, `card`, `industry`, `industry_search`, `dns`, `asn`, `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.
70
70
 
71
71
  The existing `naics` and `naics_search` tools remain available as compatibility names for Industry.
72
72
 
@@ -85,7 +85,6 @@ Example tool arguments:
85
85
  | `card` | `{"bin":"424242"}` |
86
86
  | `country_states` | `{"code":"US"}` |
87
87
  | `address_search` | `{"query":"1600 Pennsylvania","country":"US","city":"Washington","state":"DC"}` |
88
- | `company` | `{"number":"552100554","country":"FR"}` |
89
88
  | `company_search` | `{"query":"Cloudflare","country":"US"}` |
90
89
  | `company_id` | `{"id":"co_xw3f22es6cjq","deep":true}` |
91
90
  | `company_coverage` | `{}` |
@@ -112,25 +111,24 @@ Each local batch is limited to 25 km between any two coordinates and 12 distinct
112
111
 
113
112
  Australian `postal` lookup returns core `localities` with suburb choices (`city`, `state`, `state_name`). Null or an omitted field means unknown, while `[]` means the reviewed reference has no eligible choices. A single choice can coexist with `city: null`. Ask for the user's suburb choice and preserve manual entry. These are geographic choices, not mailing-address verification. AU Postal tool results include a separate source notice after the JSON. [G-NAF source, adaptations and licence](https://parseapi.com/legal/attribution#postal-au).
114
113
 
115
- Address lookup returns standardized components and registration status for the US and France. Its `deep` object is currently empty. National-number `company` lookup returns validity, registration status and business details when available. `address_search` also accepts `postal` and `ip` to narrow or rank matches. French search needs `country: "FR"` and either `postal` or `city`.
114
+ Address lookup returns standardized components and registration status for the US and France. Its `deep` object is currently empty. `address_search` also accepts `postal` and `ip` to narrow or rank matches. French search needs `country: "FR"` and either `postal` or `city`.
116
115
 
117
116
  For the company directory, call `company_search` with at most one of `query`,
118
117
  `domain`, `ticker` or `identifier`. Use `exchange` with a ticker and `authority`
119
118
  with an identifier. Review the candidates, then pass the chosen `id` to
120
119
  `company_id`. Send the returned `next` as `cursor` with the same selector,
121
- filters and `limit` for another page. Directory deep adds detail in the same
122
- pooled request on every plan and belongs to each company result.
120
+ filters and `limit` for another page. Directory Deep adds detail to each company result on paid plans in the same
121
+ pooled request. Existing accounts retain their current Deep access.
123
122
  Selected website descriptions, logos, socials and founding claims are returned
124
123
  where available. Logo URLs are returned without fetching images. Directory
125
124
  tools do not accept `lang`. `company_coverage` describes the edition's records,
126
- and empty listings do not establish private ownership. The existing `company`
127
- tool continues to parse national registration numbers.
125
+ and empty listings do not establish private ownership. The `company` tool
126
+ remains listed for compatibility, but national-number lookups are retired on
127
+ the public API. Use `company_search` and `company_id` for maintained public-company records.
128
128
 
129
129
  For discovery without an identity selector, supply `country` or both `industry` and `industry_type`. For example: `{ "country": "US", "industry": "0700", "industry_type": "sic" }`. SIC is the supported namespace; its exact four-digit code stays a string. Empty requests, incomplete industry pairs and multiple selectors are rejected. Country means the profile country. Filters intersect, unknown values do not match, and the same filters and limit must accompany a returned cursor. Filter-only candidates carry `match: { "field": "filters", "value": null }`.
130
130
 
131
131
 
132
- Paid Deep also returns `taxonomies` in published order, with taxonomy code, specialty label, primary flag and provider-reported license number/state, plus `enumerated_at`, `updated_at` and `reactivated_at` record dates. Reported licenses are not verified licenses. Null lists mean unavailable; empty lists mean the edition contains no entries. Provider record dates describe the provider record, not live verification.
133
-
134
132
  Ordinary lookups retry up to twice after a transient failure. A valid `Retry-After` is honored when the wait is at most five seconds; longer waits return the API error immediately without retrying early. When the response supplies this header, the error includes `retry_after` with its original seconds or HTTP-date value. Metered lookups and address deep checks default to no retries. Cancelling a tool call cancels the pending SDK request.
135
133
 
136
134
  Errors come back as JSON with a machine-readable `code`. Branch on `code`, never on message text. A miss is `not_found`. No key is `invalid_api_key`.
@@ -236,7 +234,7 @@ MIT licensed.
236
234
 
237
235
  Country Core contains the everyday reference: `name`, `name_full`, `name_local`, demonym, `iso_alpha3` and `iso_numeric` country identifiers, continent, region and subregion, currency, calling code, `flag`, language and timezone codes, borders, bloc memberships and `capital: { name, latitude, longitude }`. Paid Deep adds specialist detail, including population, total area and national statistics. `gdp_usd` and `gdp_per_capita_usd` are current US dollars; `population_growth_percent`, `urban_population_percent` and `internet_users_percent` use a 0–100 percent scale (growth can be negative or exceed 100). GDP per person and these three percentages round once to two decimals in the API response. `elevation_average` is average terrain elevation in meters; `lowest_point.elevation` and `highest_point.elevation` keep their point-specific meaning. Unknown stays null and a known zero stays zero. Country tax references are grouped once as `deep.tax: { name, rate }`; the rate remains a percentage. Read capital from the Core object and read the tax name and rate from the Deep tax object.
238
236
 
239
- 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.
237
+ Start with the default tool call. Use the same tool with `deep: true` for richer facts. Time, Date, Emoji, Phone, Point and Card offer optional detail on paid plans; existing accounts retain their current Deep access. Language includes every reference fact in Core, and requested Deep is empty. 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.
240
238
 
241
239
  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.
242
240
 
@@ -264,10 +262,6 @@ Time `targets` accepts 1-10 destination IDs instead of `to`. Results retain the
264
262
  `time_zones` can filter by country, IANA area, exact offset, abbreviation, DST at an instant or DST occurrence during the UTC calendar year. It preserves explicit false filters. `details` adds rich rows and the common evaluation instant, while the default identifier list remains compact. Abbreviations return candidate zones. Source deep exposes standard and signed seasonal offsets plus actual DST-season transition boundaries. Negative seasonal adjustments and null boundaries retain their meaning.
265
263
 
266
264
 
267
- Bank tools send original IBAN, routing and account strings in POST JSON bodies, keeping account input out of URLs. `bank` retains optional country and deep controls. Deep directory evidence identifies the immutable source edition and actual match grain when a directory lookup ran; it does not prove country completeness or reachability. `bank_us_ach` takes routing/account strings and checks the ABA routing checksum plus account-field syntax. It has no deep option and cannot verify an account checksum, existence, ownership or ACH eligibility. Preserve all account characters and leading zeros. `bank_requirements` takes a country and optional format (`iban` by default, or `us_ach`) and returns accepted fields, check scope and limitations. Requirements are metadata, not bank coverage. Avoid logging tool arguments or request bodies containing banking input.
268
-
269
- When US ACH returns a bank name, MCP includes a separate [routing reference attribution](https://parseapi.com/legal/attribution#routing-numbers) notice alongside the unchanged JSON result.
270
-
271
265
 
272
266
  ## Emoji catalog additions
273
267
 
@@ -685,7 +685,7 @@ var agent_catalog_default = {
685
685
  deep: {
686
686
  type: "boolean",
687
687
  default: false,
688
- description: "Optional recorded issuer details; included on every plan. Six or more digits enable matching."
688
+ description: "Optional recorded issuer details on paid plans; existing accounts retain their current Deep access. Six or more digits enable matching."
689
689
  }
690
690
  }
691
691
  },
@@ -731,7 +731,7 @@ var agent_catalog_default = {
731
731
  metered: null,
732
732
  monetary_quote: null,
733
733
  account_state: "unknown; pooled allowance and accepted account terms are not checked",
734
- deep: "Included in the same pooled request on every plan"
734
+ deep: "Included in the same pooled request on paid plans. Existing accounts retain their current Deep access"
735
735
  },
736
736
  access: {
737
737
  api_key_required: true,
@@ -2249,9 +2249,9 @@ function registerBulk(server, key, transport) {
2249
2249
  // package.json
2250
2250
  var package_default = {
2251
2251
  name: "parseapi-mcp",
2252
- version: "1.12.3",
2252
+ version: "1.12.4",
2253
2253
  mcpName: "com.parseapi/mcp",
2254
- description: "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
2254
+ description: "Official ParseAPI MCP server. Look up places, addresses, companies, email, phone, weather, dates and more.",
2255
2255
  keywords: [
2256
2256
  "parseapi",
2257
2257
  "mcp",
@@ -2402,7 +2402,7 @@ function buildServer(key, transport, options = {}) {
2402
2402
  name: "parseapi",
2403
2403
  version: VERSION,
2404
2404
  title: "ParseAPI",
2405
- 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.",
2405
+ description: "Lookups for agents: IP and place data, addresses, companies, email, phone, domains, weather, timezones, dates and holidays. Real reference data instead of guessing.",
2406
2406
  websiteUrl: "https://parseapi.com"
2407
2407
  },
2408
2408
  { capabilities: { tools: {} } }
@@ -2706,7 +2706,7 @@ function buildServer(key, transport, options = {}) {
2706
2706
  );
2707
2707
  tool(
2708
2708
  "company",
2709
- "Parse a company number and its registered identity, status and address. Paid deep adds business activity and associated identifiers. Geography lookups are separate calls.",
2709
+ "Compatibility national Company-number lookup. This operation is retired on the public API in both contracts. Use company_search and company_id for maintained public-company records. Existing inputs and compatibility methods are preserved.",
2710
2710
  {
2711
2711
  number: z5.string().describe("Company registration number, e.g. 552100554 with country FR"),
2712
2712
  country: countryOpt,
@@ -2807,10 +2807,10 @@ function buildServer(key, transport, options = {}) {
2807
2807
  );
2808
2808
  tool(
2809
2809
  "card",
2810
- "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.",
2810
+ "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 on paid plans adds the longest recorded prefix, issuer, country, funding type and nullable prepaid status; existing accounts retain their current Deep access. 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. Core uses one pooled request on every plan. Optional Deep follows paid-plan or retained-access rules in that same request.",
2811
2811
  {
2812
2812
  bin: z5.string().max(64, "Send a prefix only: 2-11 digits.").regex(/^[ \t\r\n-]*(?:[0-9][ \t\r\n-]*){2,11}$/, "Send a prefix only: 2-11 digits.").describe("Processor-provided leading digits as a string, 2-11 ASCII digits. Preserve zeros. Only ASCII space, tab, CR, LF and hyphen separators; at most 64 raw characters. Never send a full card number. Six or more digits enable issuer lookup."),
2813
- deep: deep.describe("Include recorded issuer details, pooled on every plan. Omitted by default; fewer than six digits returns all-null Deep fields.")
2813
+ deep: deep.describe("Include recorded issuer details on paid plans in the same pooled request; existing accounts retain their current Deep access. Omitted by default; locked Deep is empty. With access, fewer than six digits returns all-null Deep fields.")
2814
2814
  },
2815
2815
  (c, a, request) => c.card(a.bin, { ...request, deep: a.deep })
2816
2816
  );
@@ -2826,7 +2826,7 @@ function buildServer(key, transport, options = {}) {
2826
2826
  );
2827
2827
  tool(
2828
2828
  "carrier",
2829
- "Look up current carrier, real line type and burner flag. Deep adds issuing city and state in the same metered lookup, including Free allowance units. No extra check or second paid gate.",
2829
+ "Look up current carrier, line type and burner flag. Type uses the provider observation when mapped; otherwise it retains the numbering-plan type. Deep adds issuing city and state in the same metered lookup, including Free allowance units. No extra check or second paid gate.",
2830
2830
  {
2831
2831
  number: z5.string().describe("Phone number, e.g. +14155552671"),
2832
2832
  country: iso2("country code for national-format numbers").optional(),
package/dist/http.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  buildServer,
4
4
  catalogMode
5
- } from "./chunk-W5DHLSD3.js";
5
+ } from "./chunk-CPJ3VR6E.js";
6
6
 
7
7
  // src/http.ts
8
8
  import { createServer } from "http";
package/dist/registry.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  VERSION,
4
4
  buildServer
5
- } from "./chunk-W5DHLSD3.js";
5
+ } from "./chunk-CPJ3VR6E.js";
6
6
  export {
7
7
  VERSION,
8
8
  buildServer
package/dist/stdio.js CHANGED
@@ -2,7 +2,7 @@
2
2
  import {
3
3
  buildServer,
4
4
  catalogMode
5
- } from "./chunk-W5DHLSD3.js";
5
+ } from "./chunk-CPJ3VR6E.js";
6
6
 
7
7
  // src/stdio.ts
8
8
  import { serveStdio } from "@modelcontextprotocol/server/stdio";
package/package.json CHANGED
@@ -1,8 +1,8 @@
1
1
  {
2
2
  "name": "parseapi-mcp",
3
- "version": "1.12.3",
3
+ "version": "1.12.4",
4
4
  "mcpName": "com.parseapi/mcp",
5
- "description": "Official ParseAPI MCP server. Look up places, addresses, company numbers, email, phone, weather, dates and more.",
5
+ "description": "Official ParseAPI MCP server. Look up places, addresses, companies, email, phone, weather, dates and more.",
6
6
  "keywords": [
7
7
  "parseapi",
8
8
  "mcp",