Question 1

What does the API cover?

Accepted Answer

Orders, shipments, rates, labels, address validation, tracking, invoices, agents, and account management. Endpoints return JSON, and carrier tracking events arrive in the same shape whichever carrier produced the scan.

Question 2

How does MCP integration work?

Accepted Answer

MCP (Model Context Protocol) lets the AI tools you already run connect directly to your CommerceShip data and actions. Implement the protocol once and any MCP-capable model works, so there is no integration to write per model. Each request authenticates with an API key. If you want something else in your stack connected, tell us what it is and we can discuss options.

Question 3

What is agent-to-agent (A2A)?

Accepted Answer

A2A (agent-to-agent) is how autonomous systems find each other and work together without a custom integration in between. CommerceShip publishes a standards-compliant agent card, so your agents can discover the platform and then call it over JSON-RPC. Live skills cover inventory checks, order status, and shipment tracking, authenticated per request with an API key. The traffic runs inbound today, from your agents to ours. If you want it to run the other way, tell us what you want to coordinate and we can talk through where it stands.

Question 4

How do I configure graduated autonomy?

Accepted Answer

Set the autonomy level per agent and per domain in the agent workspace. The engine runs six levels, manual at one end and autonomous at the other. Draft an agent and simulate it against your own data before publishing, set thresholds for what it may act on, and stop it at any time with the kill switch. Every decision, tool call, and outcome is logged on a reviewable timeline.

Question 5

How do webhooks and API keys work?

Accepted Answer

Webhooks push 27+ event types across 7 domains, signed with HMAC so your endpoint can verify the payload came from us. API keys carry a full lifecycle: create, rotate, scope permissions, and track usage per key. The developer portal ships API documentation and an API explorer for working through endpoints before you write the integration.

Orders, shipments, invoices, and the agents, all on the same API

Engineering on CommerceShip

How each surface looks in code

Create an order, request rates, generate the label

Open an MCP session from a desktop AI tool

Drop the components into a React app

Get an API key and try it

Engineering FAQs