@shippo/shippo-mcp 2.0.2 → 2.0.8

package/esm/models/validateaddressv2op.js

@@ -0,0 +1,258 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod";
+import { AddressValidationResultV2$zodSchema, } from "./addressvalidationresultv2.js";
+export const ValidateAddressV2Globals$zodSchema = z.object({
+    shippoApiVersion: z.string().describe("Optional string used to pick a non-default API version to use. See our <a href=\"https://docs.goshippo.com/docs/api_concepts/apiversioning/\">API version</a> guide.").optional(),
+});
+/**
+ * The ISO 3166 country code
+ */
+export const CountryCode = {
+    Ae: "AE",
+    Ar: "AR",
+    At: "AT",
+    Au: "AU",
+    Ax: "AX",
+    Az: "AZ",
+    Ba: "BA",
+    Bd: "BD",
+    Be: "BE",
+    Bg: "BG",
+    Bh: "BH",
+    Bm: "BM",
+    Bn: "BN",
+    Br: "BR",
+    Bs: "BS",
+    Bw: "BW",
+    By: "BY",
+    Ca: "CA",
+    Ch: "CH",
+    Cl: "CL",
+    Co: "CO",
+    Cn: "CN",
+    Cy: "CY",
+    Cz: "CZ",
+    De: "DE",
+    Dk: "DK",
+    Ec: "EC",
+    Ee: "EE",
+    Eg: "EG",
+    Es: "ES",
+    Fi: "FI",
+    Fo: "FO",
+    Fr: "FR",
+    Gb: "GB",
+    Ge: "GE",
+    Gf: "GF",
+    Gg: "GG",
+    Gi: "GI",
+    Gp: "GP",
+    Gr: "GR",
+    Gu: "GU",
+    Hk: "HK",
+    Hr: "HR",
+    Hu: "HU",
+    Id: "ID",
+    Ie: "IE",
+    Il: "IL",
+    Im: "IM",
+    In: "IN",
+    Is: "IS",
+    It: "IT",
+    Je: "JE",
+    Jo: "JO",
+    Jp: "JP",
+    Kr: "KR",
+    Ky: "KY",
+    Kw: "KW",
+    Kz: "KZ",
+    Lb: "LB",
+    Li: "LI",
+    Lt: "LT",
+    Lu: "LU",
+    Lv: "LV",
+    Ma: "MA",
+    Mc: "MC",
+    Md: "MD",
+    Me: "ME",
+    Mk: "MK",
+    Mo: "MO",
+    Mp: "MP",
+    Mq: "MQ",
+    Mt: "MT",
+    Mx: "MX",
+    My: "MY",
+    Na: "NA",
+    Nl: "NL",
+    No: "NO",
+    Nz: "NZ",
+    Om: "OM",
+    Pe: "PE",
+    Ph: "PH",
+    Pl: "PL",
+    Pm: "PM",
+    Pr: "PR",
+    Pt: "PT",
+    Py: "PY",
+    Qa: "QA",
+    Re: "RE",
+    Ro: "RO",
+    Ru: "RU",
+    Sa: "SA",
+    Sc: "SC",
+    Se: "SE",
+    Sg: "SG",
+    Si: "SI",
+    Sk: "SK",
+    Sm: "SM",
+    Sr: "SR",
+    Th: "TH",
+    Tn: "TN",
+    Tr: "TR",
+    Tw: "TW",
+    Ua: "UA",
+    Us: "US",
+    Uy: "UY",
+    Vn: "VN",
+    We: "WE",
+    Yt: "YT",
+    Za: "ZA",
+};
+export const CountryCode$zodSchema = z.enum([
+    "AE",
+    "AR",
+    "AT",
+    "AU",
+    "AX",
+    "AZ",
+    "BA",
+    "BD",
+    "BE",
+    "BG",
+    "BH",
+    "BM",
+    "BN",
+    "BR",
+    "BS",
+    "BW",
+    "BY",
+    "CA",
+    "CH",
+    "CL",
+    "CO",
+    "CN",
+    "CY",
+    "CZ",
+    "DE",
+    "DK",
+    "EC",
+    "EE",
+    "EG",
+    "ES",
+    "FI",
+    "FO",
+    "FR",
+    "GB",
+    "GE",
+    "GF",
+    "GG",
+    "GI",
+    "GP",
+    "GR",
+    "GU",
+    "HK",
+    "HR",
+    "HU",
+    "ID",
+    "IE",
+    "IL",
+    "IM",
+    "IN",
+    "IS",
+    "IT",
+    "JE",
+    "JO",
+    "JP",
+    "KR",
+    "KY",
+    "KW",
+    "KZ",
+    "LB",
+    "LI",
+    "LT",
+    "LU",
+    "LV",
+    "MA",
+    "MC",
+    "MD",
+    "ME",
+    "MK",
+    "MO",
+    "MP",
+    "MQ",
+    "MT",
+    "MX",
+    "MY",
+    "NA",
+    "NL",
+    "NO",
+    "NZ",
+    "OM",
+    "PE",
+    "PH",
+    "PL",
+    "PM",
+    "PR",
+    "PT",
+    "PY",
+    "QA",
+    "RE",
+    "RO",
+    "RU",
+    "SA",
+    "SC",
+    "SE",
+    "SG",
+    "SI",
+    "SK",
+    "SM",
+    "SR",
+    "TH",
+    "TN",
+    "TR",
+    "TW",
+    "UA",
+    "US",
+    "UY",
+    "VN",
+    "WE",
+    "YT",
+    "ZA",
+]).describe("The ISO 3166 country code");
+export const ValidateAddressV2Request$zodSchema = z.object({
+    address_line_1: z.string().describe("The first line of the address"),
+    address_line_2: z.string().describe("The second line of the address")
+        .optional(),
+    city_locality: z.string().describe("The city or locality of the address")
+        .optional(),
+    country_code: CountryCode$zodSchema,
+    name: z.string().describe("The name of the addressee").optional(),
+    organization: z.string().describe("The organization of the addressee")
+        .optional(),
+    postal_code: z.string().describe("The postal code or zip code").optional(),
+    state_province: z.string().describe("The state, province, county, or municipal division").optional(),
+});
+export const ValidateAddressV2Detail$zodSchema = z.object({});
+export const ValidateAddressV2ResponseBody$zodSchema = z.object({
+    detail: z.array(z.lazy(() => ValidateAddressV2Detail$zodSchema)).optional(),
+}).describe("Unprocessable Entity");
+export const ValidateAddressV2Response$zodSchema = z.object({
+    AddressValidationResultV2: AddressValidationResultV2$zodSchema.optional(),
+    ContentType: z.string(),
+    RawResponse: z.custom(x => x instanceof Response),
+    StatusCode: z.int(),
+    object: z.lazy(() => ValidateAddressV2ResponseBody$zodSchema).optional(),
+});
+//# sourceMappingURL=validateaddressv2op.js.map

package/esm/models/validateaddressv2op.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateaddressv2op.js","sourceRoot":"","sources":["../../src/models/validateaddressv2op.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,EAEL,mCAAmC,GACpC,MAAM,gCAAgC,CAAC;AAMxC,MAAM,CAAC,MAAM,kCAAkC,GAE3C,CAAC,CAAC,MAAM,CAAC;IACX,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CACnC,sKAAsK,CACvK,CAAC,QAAQ,EAAE;CACb,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,I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"}

package/esm/models/validationresultv2.d.ts

@@ -0,0 +1,15 @@
+import * as z from "zod";
+export type Reasons = {
+    code?: string | undefined;
+    description?: string | undefined;
+};
+export declare const Reasons$zodSchema: z.ZodType<Reasons>;
+/**
+ * Validation result details
+ */
+export type ValidationResultV2 = {
+    value?: string | null | undefined;
+    reasons?: Array<Reasons> | null | undefined;
+};
+export declare const ValidationResultV2$zodSchema: z.ZodType<ValidationResultV2>;
+//# sourceMappingURL=validationresultv2.d.ts.map

package/esm/models/validationresultv2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationresultv2.d.ts","sourceRoot":"","sources":["../../src/models/validationresultv2.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,MAAM,MAAM,OAAO,GAAG;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAG/C,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,OAAO,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;CAC7C,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAAC,kBAAkB,CAI7B,CAAC"}

package/esm/models/validationresultv2.js

@@ -0,0 +1,14 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+import * as z from "zod";
+export const Reasons$zodSchema = z.object({
+    code: z.string().optional(),
+    description: z.string().optional(),
+});
+export const ValidationResultV2$zodSchema = z
+    .object({
+    reasons: z.array(z.lazy(() => Reasons$zodSchema)).nullable().optional(),
+    value: z.string().nullable().optional(),
+}).describe("Validation result details");
+//# sourceMappingURL=validationresultv2.js.map

package/esm/models/validationresultv2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validationresultv2.js","sourceRoot":"","sources":["../../src/models/validationresultv2.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAOzB,MAAM,CAAC,MAAM,iBAAiB,GAAuB,CAAC,CAAC,MAAM,CAAC;IAC5D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC;AAUH,MAAM,CAAC,MAAM,4BAA4B,GAAkC,CAAC;KACzE,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACvE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC,CAAC"}

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": "0.3",
   "name": "@shippo/shippo-mcp",
-  "version": "2.0.2",
+  "version": "2.0.8",
   "description": "",
   "long_description": "Shippo external API.: Use this API to integrate with the Shippo service",
   "author": {
@@ -54,8 +54,8 @@
       "description": "List all addresses\n\nReturns a list of all address objects that have been created in this account."
     },
     {
-      "name": "addresses-create-or-validate",
-      "description": "**PREFERRED TOOL FOR ADDRESS VALIDATION AND CREATION** - Use this tool when asked to validate or create addresses.\n\nThis is the standard Shippo address validation and creation flow. When users request address validation,\nuse this tool with validate=true parameter.\n\nExample usage for validation:\n```\nPOST /addresses\n{\n  \"name\": \"Shawn Ippotle\",\n  \"company\": \"Shippo\", \n  \"street1\": \"215 Clayton St.\",\n  \"city\": \"San Francisco\",\n  \"state\": \"CA\",\n  \"zip\": \"94117\",\n  \"country\": \"US\",\n  \"email\": \"shippotle@shippo.com\",\n  \"validate\": true\n}\n```\n\nWhen validate=true is set, this endpoint:\n- Validates address accuracy and deliverability\n- Returns standardized formatting (street abbreviations, proper casing)\n- Provides extended ZIP+4 codes when available\n- Determines residential vs commercial classification\n- Returns validation results and any corrections\n- Creates the address record for future use\n\nUse this tool for both address validation AND creating address records for shipments.\n"
+      "name": "addresses-create-v1",
+      "description": "**DEPRECATED - Use `addresses-create-v2` instead for cleaner API format.**\n\nThis is the legacy v1 address creation endpoint. It uses different field names\n(street1, city, state, zip) compared to the newer v2 format.\n\n**Prefer `addresses-create-v2`** which uses standardized field names:\n- `address_line_1` instead of `street1`\n- `city_locality` instead of `city`\n- `state_province` instead of `state`\n- `postal_code` instead of `zip`\n\n**For address validation, use `addresses-validate-v2`.**\n\nOnly use this tool if you specifically need v1 API compatibility.\n"
     },
     {
       "name": "addresses-get",
@@ -63,7 +63,19 @@
     },
     {
       "name": "addresses-validate-existing",
-      "description": "**SECONDARY VALIDATION TOOL** - Validates an already created address using its ID.\n\nUse this tool only when you have an existing address ID and need to re-validate it.\nFor new address validation, prefer the addresses-create tool with validate=true.\n"
+      "description": "**DEPRECATED - Use `addresses-validate-v2` instead for better validation results.**\n\nThis v1 endpoint validates an already created address using its ID.\nIt only works on addresses that have been saved to Shippo's address book.\n\n**Prefer `addresses-validate-v2`** which:\n- Validates any address (no need to create first)\n- Returns confidence scores (high/medium/low)\n- Provides recommended address corrections\n- Returns geo coordinates (latitude/longitude)\n- Identifies residential vs commercial addresses\n\nOnly use this tool if you specifically need to re-validate an existing address record by ID.\n"
+    },
+    {
+      "name": "addresses-parse",
+      "description": "**ADDRESS PARSER** - Converts an unstructured address string into a structured address object.\n\nUse this tool when you have a single address string (like from customer input, emails, \nor CSV imports) and need to parse it into structured components.\n\n**Input Format Tips:**\n- Use commas (,) as delimiters between address parts\n- Follow this order: street address, city, state, postal code, country\n- Phone and email can be anywhere in the string\n\n**Example Input:**\n\"Shippo 731 Market St #200, San Francisco, CA 94103 US shippo@shippo.com +1-555-999-8888\"\n\n**Example Output:**\n```json\n{\n  \"address_line_1\": \"731 MARKET ST\",\n  \"address_line_2\": \"#200\",\n  \"city_locality\": \"SAN FRANCISCO\",\n  \"state_province\": \"CA\",\n  \"postal_code\": \"94103\",\n  \"country_code\": \"US\",\n  \"email\": \"shippo@shippo.com\",\n  \"phone\": \"+1-555-999-8888\"\n}\n```\n\n**Use Cases:**\n- Parse addresses from customer contact forms\n- Extract structured data from email signatures\n- Process bulk address imports\n- Clean up poorly formatted address data\n"
+    },
+    {
+      "name": "addresses-validate-v2",
+      "description": "**PRIMARY ADDRESS VALIDATION TOOL** - Use this tool whenever asked to validate an address.\n\nThis is the recommended v2 validation endpoint that provides comprehensive results:\n- Original address as submitted\n- Recommended address with corrections\n- Confidence score (high/medium/low)\n- Validation result (valid/invalid/unknown)\n- Address type (residential/commercial/unknown)\n- List of changed attributes\n- Geographic coordinates (latitude/longitude)\n\n**Required Fields:**\n- `address_line_1`: The street address (required)\n- `country_code`: ISO 3166 country code (required)\n\n**US Address Requirements (one of):**\n- state_province + city_locality + address_line_1\n- OR address_line_1 + postal_code\n\n**International Requirements:**\n- city_locality + address_line_1\n\n**Example Request:**\n```\naddress_line_1: \"731 Market Street\"\naddress_line_2: \"#200\"\ncity_locality: \"San Francisco\"\nstate_province: \"CA\"\npostal_code: \"94103\"\ncountry_code: \"US\"\n```\n\n**Example Response:**\n```json\n{\n  \"recommended_address\": {\n    \"address_line_1\": \"731 MARKET ST\",\n    \"city_locality\": \"SAN FRANCISCO\",\n    \"state_province\": \"CA\",\n    \"postal_code\": \"94103-2007\",\n    \"country_code\": \"US\",\n    \"confidence_result\": {\n      \"score\": \"high\",\n      \"description\": \"Address verified\"\n    }\n  },\n  \"analysis\": {\n    \"validation_result\": {\"value\": \"valid\"},\n    \"address_type\": \"commercial\",\n    \"changed_attributes\": [\"address_line_1\", \"postal_code\"]\n  },\n  \"geo\": {\"latitude\": 37.7879, \"longitude\": -122.4074}\n}\n```\n\n**Use Cases:**\n- Validate customer shipping addresses before label purchase\n- Get corrected/standardized address formatting\n- Determine if address is residential or commercial\n- Get ZIP+4 extended postal codes\n- Geocode addresses for mapping\n"
+    },
+    {
+      "name": "addresses-create-v2",
+      "description": "**PRIMARY ADDRESS CREATION TOOL** - Use this tool to create and save address records.\n\nThis is the recommended v2 endpoint for creating addresses with a cleaner, standardized format.\n\n**Required Fields:**\n- `name`: The addressee's name (max 64 chars)\n- `address_line_1`: Street address (1-100 chars)\n- `country_code`: ISO 3166 country code (2 chars, e.g., \"US\")\n\n**Optional Fields:**\n- `organization`: Company/organization name\n- `email`: Email address\n- `phone`: Phone number\n- `address_line_2`: Apt, suite, unit, etc.\n- `city_locality`: City name\n- `state_province`: State/province abbreviation\n- `postal_code`: ZIP/postal code\n- `address_type`: unknown, residential, commercial, po_box, military\n\n**Example Request:**\n```json\n{\n  \"name\": \"Wilson\",\n  \"organization\": \"Shippo\",\n  \"email\": \"user@shippo.com\",\n  \"phone\": \"+1-4155550132\",\n  \"address_line_1\": \"731 Market Street\",\n  \"address_line_2\": \"#200\",\n  \"city_locality\": \"San Francisco\",\n  \"state_province\": \"CA\",\n  \"postal_code\": \"94103\",\n  \"country_code\": \"US\",\n  \"address_type\": \"commercial\"\n}\n```\n\n**Response includes:**\n- `id`: Unique address identifier for future reference\n- `address`: The saved address data\n- `created_at`/`updated_at`: Timestamps\n\n**Use Cases:**\n- Save addresses for reuse in shipments\n- Build an address book\n- Store customer shipping addresses\n\n**For address validation, use `addresses-validate-v2`** which provides\nconfidence scores, geo coordinates, and recommended corrections.\n"
     },
     {
       "name": "batches-create",
@@ -167,7 +179,7 @@
     },
     {
       "name": "orders-list",
-      "description": "List all orders\n\nReturns a list of all order objects."
+      "description": "List all orders\n\nReturns a list of all order objects.\n\n**Available Filters:**\n- `orderStatus`: Filter by order status. Can pass multiple values as an array.\n  - Values: UNKNOWN, AWAITPAY, PAID, REFUNDED, CANCELLED, PARTIALLY_FULFILLED, SHIPPED\n- `shop_app`: Filter by platform/source where order was created\n  - Values: Amazon, Bigcommerce, CSV_Import, eBay, ePages, Etsy, Godaddy, Magento, Shippo, Shopify, Spreecommerce, StripeRelay, Walmart, Weebly, WooCommerce\n- `start_date`: Filter orders placed AFTER this date/time (ISO 8601 UTC format, e.g., \"2025-01-01T00:00:00Z\")\n- `end_date`: Filter orders placed BEFORE this date/time (ISO 8601 UTC format)\n- `page/results`: Pagination controls\n\n**Example Use Cases:**\n- \"Show all paid orders\" → filter by `orderStatus: [\"PAID\"]`\n- \"Show Shopify orders from last week\" → combine `shop_app: \"Shopify\"` with date filters\n- \"Show orders ready to ship\" → filter by `orderStatus: [\"PAID\"]`\n- \"Show cancelled or refunded orders\" → filter by `orderStatus: [\"CANCELLED\", \"REFUNDED\"]`\n\n**Note:** Date filters are based on `placed_at` field (when order was placed), not when the order object was created in Shippo.\n"
     },
     {
       "name": "orders-create",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shippo/shippo-mcp",
-  "version": "2.0.2",
+  "version": "2.0.8",
   "author": "shippo",
   "type": "module",
   "sideEffects": false,

package/src/funcs/{addressesCreate.ts → addressesCreateV1.ts}

@@ -36,7 +36,7 @@ import { Result } from "../types/fp.js";
  * @remarks
  * Creates a new address object. You can use address objects to create new shipments, calculate rates, and to create orders.
  */
-export function addressesCreate(
+export function addressesCreateV1(
   client$: ShippoSDKCore,
   request: AddressCreateRequest,
   options?: RequestOptions,

package/src/funcs/addressesCreateV2.ts

@@ -0,0 +1,178 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ShippoSDKCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import {
+  AddressCreateRequestV2,
+  AddressCreateRequestV2$zodSchema,
+} from "../models/addresscreaterequestv2.js";
+import {
+  CreateAddressV2Response,
+  CreateAddressV2Response$zodSchema,
+} from "../models/createaddressv2op.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Create a new address (v2)
+ *
+ * @remarks
+ * Stores a new address to your address book.
+ * This is the v2 address creation endpoint with a cleaner request/response format.
+ */
+export function addressesCreateV2(
+  client$: ShippoSDKCore,
+  request: AddressCreateRequestV2,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    CreateAddressV2Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client$: ShippoSDKCore,
+  request: AddressCreateRequestV2,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      CreateAddressV2Response,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed$ = safeParse(
+    request,
+    (value$) => AddressCreateRequestV2$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = encodeJSON("body", payload$, { explode: true });
+  const path$ = pathToFunc("/v2/addresses")();
+
+  const headers$ = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+    "SHIPPO-API-VERSION": encodeSimple(
+      "SHIPPO-API-VERSION",
+      client$._options.shippoApiVersion,
+      { explode: false, charEncoding: "none" },
+    ),
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "CreateAddressV2",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries
+      || client$._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504",
+    ],
+  };
+
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "POST",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs
+      || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  const response = doResult.value;
+  const responseFields$ = {
+    HttpMeta: { Response: response, Request: req$ },
+  };
+
+  const [result$] = await M.match<
+    CreateAddressV2Response,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json(201, CreateAddressV2Response$zodSchema, {
+      key: "AddressWithMetadataResponse",
+    }),
+    M.json(409, CreateAddressV2Response$zodSchema, {
+      key: "fourHundredAndNineApplicationJsonObject",
+    }),
+    M.json(422, CreateAddressV2Response$zodSchema, {
+      key: "fourHundredAndTwentyTwoApplicationJsonObject",
+    }),
+    M.nil("5XX", CreateAddressV2Response$zodSchema),
+  )(response, req$, { extraFields: responseFields$ });
+
+  return [result$, { status: "complete", request: req$, response }];
+}