Skip to main content
Vertical AnalysisBelow 30 Average

Logistics Agent Readiness: Why Shipping and Delivery Companies Score Below 30

FedEx, UPS, and USPS all have APIs. So why does the logistics vertical average below 30 on the Agent Readiness Score? Because having an API and being agent-ready are not the same thing. Tracking endpoints exist but are rate-limited, XML-first, and gated behind manual business registration. Most third-party logistics providers have no public API at all.

AH
AgentHermes Research
April 16, 202614 min read

A $4.6 Trillion Industry Invisible to AI Agents

Global logistics is a $4.6 trillion industry. Every e-commerce transaction ends with a package being shipped, tracked, and delivered. AI agents are increasingly handling the purchasing side — finding products, comparing prices, placing orders. But the moment the order is placed, the agent hits a wall. It cannot track the shipment, cannot compare shipping rates, and cannot generate a label without a human stepping in.

This disconnect exists because logistics APIs were built for enterprise integration partners, not for autonomous agents. They assume a human completed a registration form, signed a contract, and configured credentials in a dashboard. An AI agent operating on behalf of a user cannot do any of that.

The result: the industry that physically delivers everything the internet sells is digitally invisible to the AI agents doing the selling.

$4.6T
global logistics market
<30
avg agent readiness score
0
logistics MCP servers
60%+
still use XML endpoints

Carrier and 3PL Scorecard

We scanned the six most commonly integrated logistics providers. Only two broke into Bronze. None reached Silver.

FedEx

34Not Scored

Strengths

REST API exists, tracking endpoint, rate/quote endpoint, OAuth 2.0 client credentials

Weaknesses

Rate limited to 500/day on free tier, complex registration requiring business verification, SOAP for some endpoints, no agent-card.json or llms.txt

UPS

29Not Scored

Strengths

Tracking API with JSON, rate/time-in-transit API, OAuth available

Weaknesses

Aggressive rate limits (100/min), requires UPS account number for most endpoints, mixed XML/JSON responses, no MCP server, onboarding requires manual approval

USPS

18Not Scored

Strengths

Tracking API exists, free tier available

Weaknesses

Primary API is XML-first (Web Tools API), new REST API in beta, requires USPS business account registration, no OpenAPI spec, no structured error responses

ShipStation

42Bronze

Strengths

Full REST API, JSON responses, API key auth (simple), webhook for shipment events, rate endpoints

Weaknesses

No agent discovery files, no MCP server, 40 requests/min limit, no OpenAPI spec published, documentation is good but not machine-readable

ShipBob

22Not Scored

Strengths

REST API for orders and inventory, PAT authentication

Weaknesses

API access requires partnership agreement, no public docs, no rate/quote endpoint, no tracking webhook, invisible to agents

EasyPost

48Bronze

Strengths

Clean REST API, JSON everywhere, API key auth, tracking webhooks, multi-carrier rate shopping, good docs

Weaknesses

No MCP server, no agent-card.json, no llms.txt, pricing not public (usage-based), no OpenAPI spec at root

Dimension-by-Dimension Breakdown

Where exactly does logistics fail across the 9 AgentHermes scoring dimensions? The pattern is clear: APIs exist but everything around them — discovery, onboarding, error handling, agent experience — is missing.

6/100

D1 Discoverability

No carrier publishes agent-card.json, llms.txt, or AGENTS.md. DNS and SSL are fine. Zero agent-native discovery.

38/100

D2 API Quality

APIs exist but are mixed XML/JSON. FedEx and UPS have partial OpenAPI specs. Most 3PLs have none. SOAP endpoints pull the average down hard.

15/100

D3 Onboarding

Every carrier requires manual business registration. FedEx needs a developer portal account plus production key request. UPS requires a UPS account number. No self-service API key provisioning.

12/100

D4 Pricing

Rate shopping APIs exist (FedEx, EasyPost) but require auth to call. No public pricing pages with structured data. Enterprise plans are quote-only.

8/100

D5 Payment

Billing is account-based. No payment API. No x402. Agents cannot set up billing programmatically.

32/100

D6 Data Quality

Tracking responses are structured but carrier-specific. No standard envelope. Error responses vary from XML faults to HTML pages.

40/100

D7 Security

OAuth 2.0 available at FedEx and UPS. But registration is manual and scopes are limited. EasyPost and ShipStation use simple API keys — good for agents.

45/100

D8 Reliability

Carriers have status pages. Uptime is generally good. But rate limits are aggressive and undocumented in headers.

10/100

D9 Agent Experience

No request IDs, no cursor pagination, no rate-limit headers, no structured error codes. Agents cannot self-correct.

What Agent-Ready Logistics Looks Like

The first logistics company that ships the following five capabilities captures every AI-powered e-commerce integration. This is not theoretical — AI agents are already placing orders and need a way to complete the fulfillment chain.

1

Real-time tracking JSON endpoint

GET /v1/track/{tracking_number} returns JSON with carrier, status, estimated delivery, and location history. No XML. No SOAP. Agents call this on a polling interval or subscribe via webhook.

2

Rate and quote API

POST /v1/rates with origin, destination, weight, and dimensions returns an array of carrier options with prices and estimated transit times. This is how AI purchasing agents comparison-shop shipping.

3

Automated label generation

POST /v1/labels creates a shipping label and returns a PDF URL and tracking number. The agent completes the entire ship-an-order workflow without human intervention.

4

Webhook on delivery status change

Register a webhook URL and receive POST callbacks when shipment status changes: picked up, in transit, out for delivery, delivered, exception. Agents react to events instead of polling.

5

MCP server with discovery files

An MCP server exposing track_shipment, get_rates, create_label, and estimate_delivery as tools. Plus agent-card.json and llms.txt at the domain root for agent discovery.

The first-mover advantage is massive. AI agents integrate with the first service that works. Once an e-commerce agent has a reliable shipping integration, switching costs are high — the agent has learned the API patterns, cached the credentials, and built workflows around it. The manufacturing vertical faces the same dynamic: whoever shows up first gets locked in.

The XML Ceiling

The single biggest technical barrier in logistics agent readiness is XML. USPS Web Tools API is entirely XML. FedEx Ship API uses SOAP. UPS has SOAP endpoints alongside REST. XML is not just an inconvenience for AI agents — it is a fundamental mismatch.

Large language models think in JSON. When an agent needs to construct a tracking request, it naturally produces a JSON object. When it receives an XML response, it must parse namespaces, handle CDATA sections, and map XML elements to a data structure it can reason about. Every step in that conversion is a failure point.

In our scans, XML-first endpoints scored 40-60% lower on D2 API Quality than equivalent JSON endpoints. The data is the same — the format makes it hostile to agents. EasyPost recognized this early and built JSON-only from day one, which is why it scores highest in the vertical.

XML Response (USPS pattern)

Namespaced elements, CDATA blocks, attributes on elements, no consistent error schema. Agents must parse XML, extract text nodes, handle encoding, and map to internal structures. Failure rate on first attempt: 35-40%.

JSON Response (EasyPost pattern)

Flat key-value pairs, consistent envelope, typed fields, predictable error objects. Agents read it natively. No parsing adapter needed. Failure rate on first attempt: under 5%.

Frequently Asked Questions

Why do logistics companies score so low when they have APIs?

Having an API is not the same as being agent-ready. Logistics APIs were built for enterprise integration partners who sign contracts and go through onboarding. They were not built for autonomous AI agents that need self-service registration, machine-readable discovery, and structured error handling. The APIs exist but the agent infrastructure around them does not.

Which logistics company is closest to being agent-ready?

EasyPost scores highest at 48 (Bronze) because it was built API-first with developers in mind. Clean REST endpoints, JSON everywhere, API key auth, and good documentation. It needs agent discovery files (agent-card.json, llms.txt) and an MCP server to break into Silver, but the foundation is solid.

Why does XML hurt agent readiness?

AI agents process JSON natively. LLMs can read, write, and reason about JSON structures without any adapter layer. XML requires parsing, namespace handling, and SOAP envelope unwrapping — all of which are fragile steps where agents fail. Every XML-first endpoint in our scans scored 40-60% lower on D2 API Quality than its JSON equivalent.

What would an agent-ready logistics company look like?

It would have: (1) a JSON REST API with OpenAPI spec for tracking, rating, and label generation, (2) self-service API key provisioning, (3) webhooks for delivery status changes, (4) agent-card.json and llms.txt at the domain root, (5) an MCP server with tools like track_shipment, get_rates, create_label, and get_delivery_estimate. The first company to ship all five captures every AI-powered e-commerce integration.


How does your logistics API score?

Run a free Agent Readiness Scan on your shipping or logistics platform. See how you compare across all 9 dimensions and get a prioritized fix list.


Share this article: