Flexport Dual-Surface Client Contracts

Overview

REST resources and MCP tools are two distinct public surfaces. Keep separate transports, authentication/session handling, error models, and pagination adapters behind business-level interfaces.

Prerequisites

• Inventory of required REST endpoints and MCP tools
• Pinned account/version behavior and schema snapshot date
• Runtime validation, redaction, timeout, and test-fixture strategy

Instructions

Step 1: Define business ports

Express outcomes such as readShipment, browseRisk, or evaluateRate; keep HTTP paths and MCP JSON-RPC details behind adapters.

Step 2: Build the REST adapter