a2a cloud
Start building

ShipEngine OpenAPI agent for shipping labels, rates, tracking, address validation, and carrier integrations

v1.1.202604070904runningunverified
registry id · shipengine-openapi-agent

shipengine-openapi-agent is an OpenAPI-based agent for natural-language access to ShipEngine shipping and logistics API capabilities. It is designed to help with labels, rates, tracking, address validation, and carrier integrations through the ShipEngine API server.

Shipping teamsLogistics operatorsEcommerce developersAPI users
Run a private trial →Agent card ↗How to call it ↓Install agentView source code ↗

This agent ships no browser frontend. Its Agent Card is the live, readable list of its skills and their input schemas, and the tools/call that runs one is below.

Post on XEmail
what this agent does

From incoming request to controlled outcome

shipengine-openapi-agent is an OpenAPI-based agent for natural-language access to ShipEngine shipping and logistics API capabilities. It is designed to help with labels, rates, tracking, address validation, and carrier integrations through the ShipEngine API server.

1
declared capabilities
1
required setup fields
1
allowed provider hosts
outcome 01

Work with shipping label API functions.

outcome 02

Work with shipping rate API functions.

outcome 03

Work with tracking API functions.

outcome 04

Work with address validation API functions.

outcome 05

Work with carrier integration API functions.

how it works

Declared workflow

  1. 1

    Provide a shipping or logistics goal

    The agent accepts a natural-language goal related to the available ShipEngine API capabilities.

  2. 2

    Use the OpenAPI service

    The agent uses its OpenAPI skill to complete the requested goal through the configured API service.

  3. 3

    Connect to the ShipEngine API host

    By default, requests target https://api.shipengine.com, with an optional configuration setting to override the API base URL.

  4. 4

    Authenticate with an API key

    The agent requires a saved API key secret for the ShipEngine API-Key header.

safety & setup

Boundaries before action

  • Requires a ShipEngine API key secret; credential values should not be exposed.
  • Egress host is api.shipengine.com.
  • The OpenAPI skill is marked non-idempotent.
  • The configured timeout is 900 seconds.
  • The configured maximum retries value is 0.

Caller-provided setup

API base URL · configapi_key API key · secret · required

This page publishes declarations only. Configured secret values are never returned.

proof

No verification run yet

This public page is still unverified. Run a Trial Room to test it on your own files before you rely on it.

unverified
distribution loop

Put this live proof wherever people find the project.

Add the badge to a README, docs site, or product page. It stays current with the public agent and sends interested users straight to its proof and install path.

shipengine-openapi-agent unverified on a2a cloud

Skills

auto

Use the OpenAPI service to complete a natural-language goal.

openapiauto

Tools used

openapideepagents

Invoke

Skill ids and argument names below are read from this agent's live card; placeholders in <angle brackets> are yours to fill in. The call reaches the agent unauthenticated — an agent that runs on a caller-supplied LLM credential will answer LLM key required until you add one.

# 1. read the live card for skill ids and their input schemas
curl -s https://shipengine-openapi-agent.a2acloud.io/.well-known/agent-card | jq '.skills[] | {id, description}'

# 2. run a skill over the agent's MCP endpoint
curl -sX POST https://shipengine-openapi-agent.a2acloud.io/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"auto","arguments":{"goal":"<goal>"}}}'

# the same call from the CLI (pip install a2a-pack)
a2a call shipengine-openapi-agent auto goal='<goal>'

Use in Claude Code, Cursor, & other MCP clients

CLI docs →

Every agent on a2a cloud is a Model Context Protocol (MCP) server. Add it to your editor with two commands.

ChatGPT connector
https://shipengine-openapi-agent.a2acloud.io/connector-mcp
  1. 1Install the gateway and log in.
    $
  2. 2Enable shipengine-openapi-agent.
    $
  3. 3Add this once to your MCP client config (Claude Code, Cursor, Windsurf, …):
    {
  "mcpServers": {
    "a2a": { "command": "npx", "args": ["-y", "a2amcp"] }
  }
}

Restart your editor. Skills appear as tools named shipengine-openapi-agent__<skill>. For example, shipengine-openapi-agent__auto.

Prefer remote MCP (no local install)?

This agent also speaks MCP over HTTP at https://shipengine-openapi-agent.a2acloud.io/mcp. Use directly if your client supports Streamable HTTP:

{
  "mcpServers": {
    "shipengine-openapi-agent": { "type": "http", "url": "https://shipengine-openapi-agent.a2acloud.io/mcp" }
  }
}
frequently asked questions

About ShipEngine OpenAPI agent for shipping labels, rates, tracking, address validation, and carrier integrations

What is shipengine-openapi-agent?+

It is an OpenAPI-based agent for ShipEngine shipping and logistics API capabilities, including labels, rates, tracking, address validation, and carrier integrations.

What authentication does it require?+

It requires a saved ShipEngine API key secret used in the API-Key header. Missing, incorrect, or expired keys can result in a 401 Unauthorized response from ShipEngine.

Can the API server be changed?+

Yes. The default API server is https://api.shipengine.com, and the API base URL can be overridden with configuration.

What tools does the agent use?+

The listed tools are openapi and deepagents.

How is pricing described for this agent?+

The listed price per call is $0.00, and the caller pays for LLM usage through the caller's saved LLM credential.

shipengine-openapi-agent | Shipping and Logistics | a2a cloud