@amazon-sp-api-release/dev-mcp 0.0.1

package/dist/zod-schemas/orders-schemas.d.ts

@@ -0,0 +1,291 @@
+/**
+ * Zod schemas for Orders API tools
+ */
+import { z } from "zod";
+export declare const searchOrdersSchema: z.ZodObject<{
+    createdAfter: z.ZodOptional<z.ZodString>;
+    createdBefore: z.ZodOptional<z.ZodString>;
+    lastUpdatedAfter: z.ZodOptional<z.ZodString>;
+    lastUpdatedBefore: z.ZodOptional<z.ZodString>;
+    fulfillmentStatuses: z.ZodOptional<z.ZodArray<z.ZodEnum<["PENDING", "UNSHIPPED", "PARTIALLY_SHIPPED", "SHIPPED", "CANCELLED", "UNFULFILLABLE"]>, "many">>;
+    marketplaceIds: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
+    fulfilledBy: z.ZodOptional<z.ZodArray<z.ZodEnum<["AMAZON", "MERCHANT"]>, "many">>;
+    maxResultsPerPage: z.ZodDefault<z.ZodNumber>;
+    includedData: z.ZodOptional<z.ZodArray<z.ZodEnum<["BUYER", "RECIPIENT", "PROCEEDS", "EXPENSE", "PROMOTION", "CANCELLATION", "FULFILLMENT", "PACKAGES"]>, "many">>;
+    paginationToken: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    marketplaceIds: string[];
+    maxResultsPerPage: number;
+    createdAfter?: string | undefined;
+    createdBefore?: string | undefined;
+    lastUpdatedAfter?: string | undefined;
+    lastUpdatedBefore?: string | undefined;
+    fulfillmentStatuses?: ("PENDING" | "UNSHIPPED" | "PARTIALLY_SHIPPED" | "SHIPPED" | "CANCELLED" | "UNFULFILLABLE")[] | undefined;
+    fulfilledBy?: ("AMAZON" | "MERCHANT")[] | undefined;
+    includedData?: ("BUYER" | "RECIPIENT" | "PROCEEDS" | "EXPENSE" | "PROMOTION" | "CANCELLATION" | "FULFILLMENT" | "PACKAGES")[] | undefined;
+    paginationToken?: string | undefined;
+}, {
+    createdAfter?: string | undefined;
+    createdBefore?: string | undefined;
+    lastUpdatedAfter?: string | undefined;
+    lastUpdatedBefore?: string | undefined;
+    fulfillmentStatuses?: ("PENDING" | "UNSHIPPED" | "PARTIALLY_SHIPPED" | "SHIPPED" | "CANCELLED" | "UNFULFILLABLE")[] | undefined;
+    marketplaceIds?: string[] | undefined;
+    fulfilledBy?: ("AMAZON" | "MERCHANT")[] | undefined;
+    maxResultsPerPage?: number | undefined;
+    includedData?: ("BUYER" | "RECIPIENT" | "PROCEEDS" | "EXPENSE" | "PROMOTION" | "CANCELLATION" | "FULFILLMENT" | "PACKAGES")[] | undefined;
+    paginationToken?: string | undefined;
+}>;
+export declare const getOrderSchema: z.ZodObject<{
+    orderId: z.ZodString;
+    includedData: z.ZodOptional<z.ZodArray<z.ZodEnum<["BUYER", "RECIPIENT", "PROCEEDS", "EXPENSE", "PROMOTION", "CANCELLATION", "FULFILLMENT", "PACKAGES"]>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    orderId: string;
+    includedData?: ("BUYER" | "RECIPIENT" | "PROCEEDS" | "EXPENSE" | "PROMOTION" | "CANCELLATION" | "FULFILLMENT" | "PACKAGES")[] | undefined;
+}, {
+    orderId: string;
+    includedData?: ("BUYER" | "RECIPIENT" | "PROCEEDS" | "EXPENSE" | "PROMOTION" | "CANCELLATION" | "FULFILLMENT" | "PACKAGES")[] | undefined;
+}>;
+export declare const cancelOrderSchema: z.ZodObject<{
+    orderId: z.ZodString;
+    cancelReasonCode: z.ZodEnum<["NO_INVENTORY", "BUYER_CANCELLED", "SHIPPING_ADDRESS_UNDELIVERABLE", "CUSTOMER_EXCHANGE", "PRICING_ERROR"]>;
+}, "strip", z.ZodTypeAny, {
+    orderId: string;
+    cancelReasonCode: "NO_INVENTORY" | "BUYER_CANCELLED" | "SHIPPING_ADDRESS_UNDELIVERABLE" | "CUSTOMER_EXCHANGE" | "PRICING_ERROR";
+}, {
+    orderId: string;
+    cancelReasonCode: "NO_INVENTORY" | "BUYER_CANCELLED" | "SHIPPING_ADDRESS_UNDELIVERABLE" | "CUSTOMER_EXCHANGE" | "PRICING_ERROR";
+}>;
+export declare const updateShipmentStatusSchema: z.ZodObject<{
+    orderId: z.ZodString;
+    marketplaceId: z.ZodDefault<z.ZodString>;
+    shipmentStatus: z.ZodEnum<["ReadyForPickup", "PickedUp", "RefusedPickup"]>;
+    orderItems: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        orderItemId: z.ZodOptional<z.ZodString>;
+        quantity: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        orderItemId?: string | undefined;
+        quantity?: number | undefined;
+    }, {
+        orderItemId?: string | undefined;
+        quantity?: number | undefined;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    orderId: string;
+    marketplaceId: string;
+    shipmentStatus: "ReadyForPickup" | "PickedUp" | "RefusedPickup";
+    orderItems?: {
+        orderItemId?: string | undefined;
+        quantity?: number | undefined;
+    }[] | undefined;
+}, {
+    orderId: string;
+    shipmentStatus: "ReadyForPickup" | "PickedUp" | "RefusedPickup";
+    marketplaceId?: string | undefined;
+    orderItems?: {
+        orderItemId?: string | undefined;
+        quantity?: number | undefined;
+    }[] | undefined;
+}>;
+export declare const updateVerificationStatusSchema: z.ZodObject<{
+    orderId: z.ZodString;
+    marketplaceId: z.ZodDefault<z.ZodString>;
+    regulatedOrderVerificationStatus: z.ZodObject<{
+        status: z.ZodEnum<["Approved", "Rejected", "Expired", "Cancelled"]>;
+        validUntil: z.ZodOptional<z.ZodString>;
+        rejectionReason: z.ZodOptional<z.ZodObject<{
+            rejectionReasonId: z.ZodString;
+            rejectionReasonDescription: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            rejectionReasonId: string;
+            rejectionReasonDescription: string;
+        }, {
+            rejectionReasonId: string;
+            rejectionReasonDescription: string;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        status: "Approved" | "Rejected" | "Expired" | "Cancelled";
+        validUntil?: string | undefined;
+        rejectionReason?: {
+            rejectionReasonId: string;
+            rejectionReasonDescription: string;
+        } | undefined;
+    }, {
+        status: "Approved" | "Rejected" | "Expired" | "Cancelled";
+        validUntil?: string | undefined;
+        rejectionReason?: {
+            rejectionReasonId: string;
+            rejectionReasonDescription: string;
+        } | undefined;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    orderId: string;
+    marketplaceId: string;
+    regulatedOrderVerificationStatus: {
+        status: "Approved" | "Rejected" | "Expired" | "Cancelled";
+        validUntil?: string | undefined;
+        rejectionReason?: {
+            rejectionReasonId: string;
+            rejectionReasonDescription: string;
+        } | undefined;
+    };
+}, {
+    orderId: string;
+    regulatedOrderVerificationStatus: {
+        status: "Approved" | "Rejected" | "Expired" | "Cancelled";
+        validUntil?: string | undefined;
+        rejectionReason?: {
+            rejectionReasonId: string;
+            rejectionReasonDescription: string;
+        } | undefined;
+    };
+    marketplaceId?: string | undefined;
+}>;
+export declare const confirmShipmentSchema: z.ZodObject<{
+    orderId: z.ZodString;
+    marketplaceId: z.ZodDefault<z.ZodString>;
+    packageDetail: z.ZodObject<{
+        packageReferenceId: z.ZodString;
+        carrierCode: z.ZodString;
+        shippingMethod: z.ZodOptional<z.ZodString>;
+        trackingNumber: z.ZodOptional<z.ZodString>;
+        shipDate: z.ZodString;
+        carrierName: z.ZodOptional<z.ZodString>;
+        shipFrom: z.ZodOptional<z.ZodObject<{
+            name: z.ZodString;
+            addressLine1: z.ZodString;
+            addressLine2: z.ZodOptional<z.ZodString>;
+            addressLine3: z.ZodOptional<z.ZodString>;
+            city: z.ZodString;
+            county: z.ZodOptional<z.ZodString>;
+            district: z.ZodOptional<z.ZodString>;
+            stateOrRegion: z.ZodString;
+            postalCode: z.ZodString;
+            countryCode: z.ZodString;
+            phone: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            addressLine1: string;
+            city: string;
+            stateOrRegion: string;
+            postalCode: string;
+            countryCode: string;
+            phone: string;
+            addressLine2?: string | undefined;
+            addressLine3?: string | undefined;
+            county?: string | undefined;
+            district?: string | undefined;
+        }, {
+            name: string;
+            addressLine1: string;
+            city: string;
+            stateOrRegion: string;
+            postalCode: string;
+            countryCode: string;
+            phone: string;
+            addressLine2?: string | undefined;
+            addressLine3?: string | undefined;
+            county?: string | undefined;
+            district?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        packageReferenceId: string;
+        carrierCode: string;
+        shipDate: string;
+        shippingMethod?: string | undefined;
+        trackingNumber?: string | undefined;
+        carrierName?: string | undefined;
+        shipFrom?: {
+            name: string;
+            addressLine1: string;
+            city: string;
+            stateOrRegion: string;
+            postalCode: string;
+            countryCode: string;
+            phone: string;
+            addressLine2?: string | undefined;
+            addressLine3?: string | undefined;
+            county?: string | undefined;
+            district?: string | undefined;
+        } | undefined;
+    }, {
+        packageReferenceId: string;
+        carrierCode: string;
+        shipDate: string;
+        shippingMethod?: string | undefined;
+        trackingNumber?: string | undefined;
+        carrierName?: string | undefined;
+        shipFrom?: {
+            name: string;
+            addressLine1: string;
+            city: string;
+            stateOrRegion: string;
+            postalCode: string;
+            countryCode: string;
+            phone: string;
+            addressLine2?: string | undefined;
+            addressLine3?: string | undefined;
+            county?: string | undefined;
+            district?: string | undefined;
+        } | undefined;
+    }>;
+    codCollectionMethod: z.ZodOptional<z.ZodEnum<["DirectPayment"]>>;
+}, "strip", z.ZodTypeAny, {
+    orderId: string;
+    marketplaceId: string;
+    packageDetail: {
+        packageReferenceId: string;
+        carrierCode: string;
+        shipDate: string;
+        shippingMethod?: string | undefined;
+        trackingNumber?: string | undefined;
+        carrierName?: string | undefined;
+        shipFrom?: {
+            name: string;
+            addressLine1: string;
+            city: string;
+            stateOrRegion: string;
+            postalCode: string;
+            countryCode: string;
+            phone: string;
+            addressLine2?: string | undefined;
+            addressLine3?: string | undefined;
+            county?: string | undefined;
+            district?: string | undefined;
+        } | undefined;
+    };
+    codCollectionMethod?: "DirectPayment" | undefined;
+}, {
+    orderId: string;
+    packageDetail: {
+        packageReferenceId: string;
+        carrierCode: string;
+        shipDate: string;
+        shippingMethod?: string | undefined;
+        trackingNumber?: string | undefined;
+        carrierName?: string | undefined;
+        shipFrom?: {
+            name: string;
+            addressLine1: string;
+            city: string;
+            stateOrRegion: string;
+            postalCode: string;
+            countryCode: string;
+            phone: string;
+            addressLine2?: string | undefined;
+            addressLine3?: string | undefined;
+            county?: string | undefined;
+            district?: string | undefined;
+        } | undefined;
+    };
+    marketplaceId?: string | undefined;
+    codCollectionMethod?: "DirectPayment" | undefined;
+}>;
+export declare const getOrderRegulatedInfoSchema: z.ZodObject<{
+    orderId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    orderId: string;
+}, {
+    orderId: string;
+}>;
+//# sourceMappingURL=orders-schemas.d.ts.map

package/dist/zod-schemas/orders-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orders-schemas.d.ts","sourceRoot":"","sources":["../../src/zod-schemas/orders-schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiE7B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;EAiBzB,CAAC;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;EAW5B,CAAC;AAGH,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBrC,CAAC;AAEH,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBzC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsChC,CAAC;AAEH,eAAO,MAAM,2BAA2B;;;;;;EAEtC,CAAC"}

package/dist/zod-schemas/orders-schemas.js

@@ -0,0 +1,178 @@
+/**
+ * Zod schemas for Orders API tools
+ */
+import { z } from "zod";
+// Orders API V1 Schemas
+export const searchOrdersSchema = z.object({
+    createdAfter: z
+        .string()
+        .optional()
+        .describe("ISO 8601 date for orders created after this time (e.g., '2025-10-01T00:00:00Z')"),
+    createdBefore: z
+        .string()
+        .optional()
+        .describe("ISO 8601 date for orders created before this time"),
+    lastUpdatedAfter: z
+        .string()
+        .optional()
+        .describe("ISO 8601 date for orders last updated after this time"),
+    lastUpdatedBefore: z
+        .string()
+        .optional()
+        .describe("ISO 8601 date for orders last updated before this time"),
+    fulfillmentStatuses: z
+        .array(z.enum([
+        "PENDING",
+        "UNSHIPPED",
+        "PARTIALLY_SHIPPED",
+        "SHIPPED",
+        "CANCELLED",
+        "UNFULFILLABLE",
+    ]))
+        .optional()
+        .describe("Filter by fulfillment status"),
+    marketplaceIds: z
+        .array(z.string())
+        .default(["ATVPDKIKX0DER"])
+        .describe("Marketplace IDs to search in (e.g., ['ATVPDKIKX0DER' for US])"),
+    fulfilledBy: z
+        .array(z.enum(["AMAZON", "MERCHANT"]))
+        .optional()
+        .describe("Filter by fulfillment channel"),
+    maxResultsPerPage: z
+        .number()
+        .min(1)
+        .max(100)
+        .default(50)
+        .describe("Number of results per page (1-100)"),
+    includedData: z
+        .array(z.enum([
+        "BUYER",
+        "RECIPIENT",
+        "PROCEEDS",
+        "EXPENSE",
+        "PROMOTION",
+        "CANCELLATION",
+        "FULFILLMENT",
+        "PACKAGES",
+    ]))
+        .optional()
+        .describe("Data sets to include in response"),
+    paginationToken: z
+        .string()
+        .optional()
+        .describe("Token for pagination from previous response"),
+});
+export const getOrderSchema = z.object({
+    orderId: z.string().describe("Amazon order ID (e.g., '123-4567890-1234567')"),
+    includedData: z
+        .array(z.enum([
+        "BUYER",
+        "RECIPIENT",
+        "PROCEEDS",
+        "EXPENSE",
+        "PROMOTION",
+        "CANCELLATION",
+        "FULFILLMENT",
+        "PACKAGES",
+    ]))
+        .optional()
+        .describe("Data sets to include in response"),
+});
+export const cancelOrderSchema = z.object({
+    orderId: z.string().describe("Amazon order ID to cancel"),
+    cancelReasonCode: z
+        .enum([
+        "NO_INVENTORY",
+        "BUYER_CANCELLED",
+        "SHIPPING_ADDRESS_UNDELIVERABLE",
+        "CUSTOMER_EXCHANGE",
+        "PRICING_ERROR",
+    ])
+        .describe("Reason for cancellation"),
+});
+// Orders API V0 Schemas
+export const updateShipmentStatusSchema = z.object({
+    orderId: z.string().describe("Amazon order ID"),
+    marketplaceId: z
+        .string()
+        .default("ATVPDKIKX0DER")
+        .describe("Marketplace ID (e.g., 'ATVPDKIKX0DER' for US)"),
+    shipmentStatus: z
+        .enum(["ReadyForPickup", "PickedUp", "RefusedPickup"])
+        .describe("New shipment status"),
+    orderItems: z
+        .array(z.object({
+        orderItemId: z.string().optional().describe("Order item ID"),
+        quantity: z.number().optional().describe("Quantity"),
+    }))
+        .optional()
+        .describe("Optional order items to update"),
+});
+export const updateVerificationStatusSchema = z.object({
+    orderId: z.string().describe("Amazon order ID"),
+    marketplaceId: z
+        .string()
+        .default("ATVPDKIKX0DER")
+        .describe("Marketplace ID (e.g., 'ATVPDKIKX0DER' for US)"),
+    regulatedOrderVerificationStatus: z.object({
+        status: z
+            .enum(["Approved", "Rejected", "Expired", "Cancelled"])
+            .describe("Verification status"),
+        validUntil: z
+            .string()
+            .optional()
+            .describe("ISO 8601 date when status is valid until"),
+        rejectionReason: z
+            .object({
+            rejectionReasonId: z.string().describe("Rejection reason ID"),
+            rejectionReasonDescription: z
+                .string()
+                .describe("Rejection reason description"),
+        })
+            .optional()
+            .describe("Rejection reason (required if status is 'Rejected')"),
+    }),
+});
+export const confirmShipmentSchema = z.object({
+    orderId: z.string().describe("Amazon order ID"),
+    marketplaceId: z
+        .string()
+        .default("ATVPDKIKX0DER")
+        .describe("Marketplace ID (e.g., 'ATVPDKIKX0DER' for US)"),
+    packageDetail: z.object({
+        packageReferenceId: z.string().describe("Package reference ID"),
+        carrierCode: z
+            .string()
+            .describe("Carrier code (e.g., 'UPS', 'FEDEX', 'USPS')"),
+        shippingMethod: z.string().optional().describe("Shipping method"),
+        trackingNumber: z.string().optional().describe("Tracking number"),
+        shipDate: z
+            .string()
+            .describe("ISO 8601 ship date (e.g., '2025-10-01T00:00:00Z')"),
+        carrierName: z.string().optional().describe("Carrier name"),
+        shipFrom: z
+            .object({
+            name: z.string().describe("Sender name"),
+            addressLine1: z.string().describe("Address line 1"),
+            addressLine2: z.string().optional().describe("Address line 2"),
+            addressLine3: z.string().optional().describe("Address line 3"),
+            city: z.string().describe("City"),
+            county: z.string().optional().describe("County"),
+            district: z.string().optional().describe("District"),
+            stateOrRegion: z.string().describe("State or region"),
+            postalCode: z.string().describe("Postal code"),
+            countryCode: z.string().describe("Country code (e.g., 'US')"),
+            phone: z.string().describe("Phone number"),
+        })
+            .optional()
+            .describe("Ship from address"),
+    }),
+    codCollectionMethod: z
+        .enum(["DirectPayment"])
+        .optional()
+        .describe("Cash on delivery collection method"),
+});
+export const getOrderRegulatedInfoSchema = z.object({
+    orderId: z.string().describe("Amazon order ID"),
+});

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@amazon-sp-api-release/dev-mcp",
+  "version": "0.0.1",
+  "description": "MCP server for Amazon SP-API Developers",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "selling-partner-api-dev-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts",
+    "build": "tsc",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "type-check": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "prepare": "npm run lint:fix && npm run format && npm run type-check"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.11.2",
+    "axios": "^1.7.7",
+    "dotenv": "^16.4.5",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.25.2",
+    "@babel/preset-env": "^7.25.4",
+    "@babel/preset-typescript": "^7.24.7",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^22.5.4",
+    "@typescript-eslint/eslint-plugin": "^8.3.0",
+    "@typescript-eslint/parser": "^8.3.0",
+    "babel-jest": "^29.7.0",
+    "eslint": "^9.9.1",
+    "eslint-config-prettier": "^9.1.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.3.3",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "tsx": "^4.19.1",
+    "typescript": "^5.5.4"
+  },
+  "files": [
+    "src/",
+    "dist/",
+    "!dist/utils",
+    "index.js",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "amazon",
+    "sp-api",
+    "orders",
+    "model-context-protocol"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/auth/sp-api-auth.ts

@@ -0,0 +1,88 @@
+import axios, { AxiosInstance, AxiosRequestConfig, AxiosResponse } from "axios";
+
+export interface SPAPIConfig {
+  clientId?: string;
+  clientSecret?: string;
+  refreshToken?: string;
+  baseUrl?: string;
+}
+
+interface TokenResponse {
+  access_token: string;
+  expires_in: number;
+  token_type: string;
+}
+
+export class SPAPIAuth {
+  private config: SPAPIConfig;
+  private accessToken: string | null = null;
+  private tokenExpiry: number | null = null;
+  private axiosInstance: AxiosInstance;
+
+  constructor(config: SPAPIConfig) {
+    this.config = config;
+    this.axiosInstance = axios.create();
+  }
+
+  private async getAccessToken(): Promise<string> {
+    // Check if we have a valid token
+    if (this.accessToken && this.tokenExpiry && Date.now() < this.tokenExpiry) {
+      return this.accessToken;
+    }
+
+    // Refresh the access token using LWA refresh token
+    try {
+      const response = await this.axiosInstance.post<TokenResponse>(
+        "https://api.amazon.com/auth/o2/token",
+        {
+          grant_type: "refresh_token",
+          client_id: this.config.clientId,
+          client_secret: this.config.clientSecret,
+          refresh_token: this.config.refreshToken,
+        },
+        {
+          headers: {
+            "Content-Type": "application/x-www-form-urlencoded",
+          },
+        },
+      );
+
+      this.accessToken = response.data.access_token;
+      // Set expiry 5 minutes before actual expiry to be safe
+      this.tokenExpiry = Date.now() + (response.data.expires_in - 300) * 1000;
+
+      return this.accessToken;
+    } catch (error: any) {
+      throw new Error(
+        `Failed to get access token: ${error.response?.data?.error_description || error.message}`,
+      );
+    }
+  }
+
+  async makeAuthenticatedRequest<T = any>(
+    method: string,
+    url: string,
+    params: Record<string, string> = {},
+    data: any = null,
+  ): Promise<AxiosResponse<T>> {
+    const accessToken = await this.getAccessToken();
+
+    const config: AxiosRequestConfig = {
+      method,
+      url,
+      headers: {
+        "x-amz-access-token": accessToken!,
+        "Content-Type": "application/json",
+        "User-Agent": "SP-API-Orders-V1-MCP/1.1.0",
+      },
+      params,
+      timeout: 30000,
+    };
+
+    if (data && (method === "POST" || method === "PUT")) {
+      config.data = data;
+    }
+
+    return this.axiosInstance.request<T>(config);
+  }
+}