canonical: https://jentic.com/apis/mrsool.co/mrsool

# Mrsool LAAS API V1

The Mrsool LAAS API (Logistics as a Service) creates and tracks delivery orders across Mrsool's courier network. It calculates delivery prices, places single or bulk orders, retrieves an order and its air waybill, and cancels an order that is no longer needed. A webhook log endpoint lets you replay the delivery events Mrsool has sent, and a test-status operation simulates status changes in the staging environment.

## For AI agents

Create, price, cancel, and track delivery orders across Mrsool's courier network, and replay delivery webhook events.

## Scope

Does not warehouse inventory or handle payments. Use it to price, create, track, and cancel Mrsool delivery orders only.

## Capabilities

- Calculate the price of a delivery before placing it
- Place a single delivery order or submit orders in bulk
- Retrieve a delivery order and download its air waybill
- Cancel a delivery order that is no longer needed
- Replay delivery events from the webhook log and simulate a status change in staging

## Use cases

### AI Agent Delivery Dispatch

Let an AI agent arrange last-mile delivery on demand. The agent discovers the pricing and order operations through Jentic, stores the Mrsool key once, and places a delivery order after checking the quoted price, without bespoke HTTP wiring. Webhook events flowing back let the agent follow the order to completion.

Example prompt: Calculate the price for a pickup and drop-off, place the delivery order, and return the tracking reference

### On-Demand Delivery Pricing

Quote delivery cost before committing an order. The API returns a price for a given pickup and drop-off so a checkout or dispatch flow can show the fee and decide whether to proceed.

Example prompt: Calculate the delivery price for a pickup and drop-off pair and return the quoted amount

### Bulk Order Fulfillment

Dispatch many deliveries in one call for batch fulfillment. The bulk order operation accepts a set of deliveries so a warehouse or marketplace can hand off an entire wave of orders at once.

Example prompt: Submit a batch of delivery orders in a single bulk request and return the created order references

### Shipment Tracking

Follow a delivery from dispatch to drop-off. The API retrieves an order's current record and its air waybill, and the webhook log lets a tracking view replay every status event Mrsool has sent for the order.

Example prompt: Retrieve a delivery order, download its air waybill, and replay its status events from the webhook log

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/api/v1/orders` | Create a delivery order |
| POST | `/api/v1/orders/calculate_price` | Calculate a delivery price |
| GET | `/api/v1/orders/{order_id}` | Retrieve a delivery order |
| POST | `/api/v1/orders/{order_id}/cancel` | Cancel a delivery order |
| GET | `/api/v1/orders/{order_id}/air_waybill` | Retrieve an order's air waybill |

## Key resources

- **Orders** — Create single or bulk delivery orders, retrieve them, and cancel them.
- **Pricing** — Calculate the price of a delivery before placing it.
- **Air Waybill** — Retrieve the air waybill document for an order.
- **Webhook Logs** — Replay the delivery events Mrsool has sent.

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 43 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 58 / 100
  - Developer Experience & Jentic Compatibility: 63 / 100
  - AI-Readiness & Agent Experience: 20 / 100
  - Agent Usability: 94 / 100
  - Security: 75 / 100
  - AI Discoverability: 52 / 100
- **View full report:** https://jentic.com/apis/mrsool.co/mrsool/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Mrsool LAAS API by hand means learning its bearer-token auth, sequencing price checks before order creation, and consuming webhook events yourself. Through Jentic you install once, import the API from the API Directory, store the token, and your agent calls the operation it needs.
- **Permission scoping:** You decide which Mrsool operations your agent may call. A rule can grant pricing and order placement while withholding cancellation, so the agent dispatches deliveries without the ability to void them, and the rule bounds operations rather than a single order.
- **Credential handling:** Your Mrsool API token is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'calculate a delivery price' or 'create a delivery order', and Jentic returns the matching Mrsool operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **ShipEngine** — Buys labels and rates shipments across many carriers.
- **Shippo** — Creates shipping labels and compares carrier rates.
- **ShipBob** — Fulfills and ships ecommerce orders from a warehouse network.
- **AfterShip** — Tracks shipments across hundreds of carriers.

## FAQ

### What authentication does the Mrsool LAAS API use?

The Mrsool LAAS API authenticates with a bearer token in the Authorization header, per its OpenAPI spec. Through Jentic the token is stored encrypted by your own Jentic One instance and injected when a call runs, so it never enters the agent's prompt or logs.

### Can the Mrsool LAAS API give me a price before I place an order?

Yes. The calculate-price operation returns a delivery cost for a given pickup and drop-off, so an agent can quote the fee and decide whether to proceed before creating the order.

### What are the rate limits for the Mrsool LAAS API?

The OpenAPI spec does not publish specific rate limits. Check the Mrsool documentation for current limits, and have your agent back off and retry when it receives a throttling response.

### How do I create a delivery with the Mrsool LAAS API through Jentic?

Search Jentic for an intent like 'create a delivery order', and it returns the matching Mrsool operation with its input schema. Import the connector once, store your token, and your agent places orders without hand-written HTTP code. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Is there a Mrsool MCP server?

You don't need an MCP server to give your agent the Mrsool LAAS API. Jentic connects it directly from the Jentic API Directory: import the API, store your token once, and your agent calls the order and pricing operations. Operations are discovered on demand, so no extra tool definitions are loaded into the agent's context.

### Can I limit what my agent is allowed to do with the Mrsool LAAS API?

Yes. You choose the operations the agent may call, so a rule can allow pricing and order creation while withholding cancellation unless you add it. A rule bounds which operations run rather than which individual order is affected, and every call is logged.