parseapi-mcp 1.10.4 → 1.11.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 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, currency, timezones, dates and more from your AI agent.
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
 
@@ -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"}` |
@@ -168,6 +167,30 @@ Set `PARSEAPI_KEY` in the process environment for lookups. Compact mode advertis
168
167
 
169
168
  The policy source is the API's `src/route/help/agent-catalog.json`. Current API help exposes the same metadata as `agent`. Frozen API 1.0.0 help stays unchanged. In a ParseAPI workspace, run `npm run catalog:sync` to copy a reviewed policy change, then `npm run catalog:check`. An independent checkout can pass `-- --source /path/to/api`. Package builds use the checked-in copy and do not need the API checkout or a network request.
170
169
 
170
+ ## Bulk files
171
+
172
+ Agents can process a whole CSV using five tools in either catalog mode:
173
+
174
+ | Tool | Action |
175
+ |---|---|
176
+ | `bulk_upload` | Create an account-owned job and get a private upload URL from the filename and exact byte count. |
177
+ | `bulk_preview` | Confirm the upload, analyze detected columns, select checks and get a sample and quote. |
178
+ | `bulk_start` | Start the current quote within the user's approved `max_cost_cents` in USD cents. |
179
+ | `bulk_status` | Read progress and any required user action. |
180
+ | `bulk_result` | Get a private download URL for the finished file. |
181
+
182
+ The agent needs a file-capable runtime. Transfer the CSV bytes directly to `upload_url` with `upload_headers` using HTTP PUT. Convert Excel or Numbers to CSV in that runtime first. Tool arguments contain file metadata and job IDs. They accept no file contents, base64, source URLs or server filesystem paths.
183
+
184
+ First call `bulk_preview` with the upload's `id` and no `checks` to confirm the completed upload and request analysis. Poll `bulk_status` until `job.status` is `quoted`. Then call `bulk_preview`, optionally passing `checks`, such as `["email", "phone", "ip"]`, to select operations present in the detected columns. Changing the selection requests analysis again. Repeat status and preview until the response includes a current `quote`. Inspect the sample and required setup before starting.
185
+
186
+ `bulk_start` requires that `id`, `quote.id` as `quote_id` and the user's approved `max_cost_cents`. Zero permits only zero additional cost. The server verifies the quote and ceiling. Paid jobs return a payment handoff when needed, and the tool does not charge a saved card. Keep the same job, quote and ceiling when recovering a start request. A lost create response must not trigger a blind second upload.
187
+
188
+ Fetch the finished `download_url` directly without an API key header. URLs expire and are private capabilities. File contents stay outside model context unless the user separately asks the agent to inspect them. Preserve the original columns and unknown answers in the customer's follow-up task.
189
+
190
+ Existing Bulk job URLs remain shareable. Treat job IDs and download URLs as file-access capabilities.
191
+
192
+ The existing API key or OAuth connection owns these jobs. The website origin can be configured with `PARSEAPI_WEB_URL`, independently of the lookup API origin.
193
+
171
194
  ## Display language
172
195
 
173
196
  This source candidate adds optional `lang` to supported tools. For example,
@@ -177,17 +200,9 @@ package does not activate it.
177
200
 
178
201
  Display names follow available source translations. IDs, native-name fields,
179
202
  numbers and input parsing stay unchanged. Omitted language keeps the default
180
- behavior. Measure parsing, currency rates, Holiday and prove tools have no new
203
+ behavior. Holiday and prove tools have no new
181
204
  language argument.
182
205
 
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
206
  ## Development
192
207
 
193
208
  ```bash
@@ -208,7 +223,7 @@ MIT licensed.
208
223
 
209
224
  ## Optional detail
210
225
 
211
- Start with the default tool call. Use the same tool with `deep: true` for richer facts. Time, Date, Currency, 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.
226
+ 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.
212
227
 
213
228
  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.
214
229