# Easy Box Packaging agent integration guide

> Custom printed packaging for growing product brands.

Updated: 2026-11-09

## When to use this site

- Custom printed packaging for physical product brands, such as candles, cosmetics, skincare, food, gift, and subscription-box companies
- Brands that need custom box sizes, printing, or branding beyond generic stock packaging
- Wholesale and bulk orders (minimum order quantities apply and are confirmed during the quote process)
- Mailer boxes, shipping boxes, rigid boxes, and folding cartons
- Brands wanting a sample kit before committing to a full production order
- Buyers who can specify (or want help specifying) material, finish, and dimensions
- E-commerce brands building a branded unboxing experience
- AI agents or assistants sourcing a packaging quote on behalf of a customer

## When this site is not a fit

- Orders below the minimum order quantity, such as single-unit or small retail-scale purchases
- Products or services outside packaging manufacturing

This guide describes the public agent interfaces exposed by the current deployment. Capability status is read from Payload Agent Commerce Controls whenever this document is regenerated.

## Current availability

- MCP transport: enabled
- A2A JSON-RPC: enabled
- Product feeds: enabled
- ACP checkout: enabled for eligible fixed-price SKUs
- Live pricing guide: https://easyboxpackaging.com/pricing.md

## MCP

Endpoint: `POST https://easyboxpackaging.com/mcp`

The server uses stateless Streamable HTTP. Send JSON-RPC requests with `Content-Type: application/json`, `Accept: application/json, text/event-stream`, and an MCP protocol-version header.

Currently enabled tools:

- `search_products` — Search published custom-packaging products.
- `get_product` — Retrieve specifications, materials, finishes, and pricing context by slug.
- `request_quote` — Submit a packaging quote lead through the protected quote workflow.
- `order_sample_kit` — Start a human-completed Stripe-hosted Sample Kit checkout.
- `search_shop_items` — Search checkout-eligible fixed-configuration shop items.
- `get_shop_item` — Retrieve public pricing and shipping details for a shop item.
- `order_shop_item` — Start a human-completed Stripe-hosted checkout for an eligible shop item.

Example product search:

```bash
curl --request POST 'https://easyboxpackaging.com/mcp' \
  --header 'Content-Type: application/json' \
  --header 'Accept: application/json, text/event-stream' \
  --header 'MCP-Protocol-Version: 2025-11-25' \
  --data-raw '{"jsonrpc":"2.0","id":"search-1","method":"tools/call","params":{"name":"search_products","arguments":{"query":"cosmetic boxes","limit":5}}}'
```

## A2A JSON-RPC

Endpoint: `POST https://easyboxpackaging.com/a2a`

Send a `message/send` JSON-RPC request containing one or more plain-text message parts.

```http
POST https://easyboxpackaging.com/a2a
Content-Type: application/json

{"jsonrpc":"2.0","id":"message-1","method":"message/send","params":{"message":{"role":"user","parts":[{"kind":"text","text":"search for cosmetic boxes"}]}}}
```

Example shop search:

```http
POST https://easyboxpackaging.com/a2a
Content-Type: application/json

{"jsonrpc":"2.0","id":"shop-1","method":"message/send","params":{"message":{"role":"user","parts":[{"kind":"text","text":"shop for sample kits"}]}}}
```

Discovery card: https://easyboxpackaging.com/.well-known/agent-card.json

## Product feeds

- OpenAI JSONL: https://easyboxpackaging.com/feeds/openai-products.jsonl
- Google Merchant XML: https://easyboxpackaging.com/feeds/google-merchant.xml

## ACP checkout

Canonical checkout URL: `https://easyboxpackaging.com/checkout_sessions`

ACP checkout is limited to fixed-price Commerce SKUs that are currently eligible. Every request requires an issued Bearer API key, and every POST requires an `Idempotency-Key` header.

```http
POST https://easyboxpackaging.com/checkout_sessions
Authorization: Bearer <issued-api-key>
API-Version: 2026-04-17
Idempotency-Key: <unique-request-key>
Content-Type: application/json

{"currency":"usd","capabilities":{},"line_items":[{"id":"EBP-SAMPLE-KIT","quantity":1}]}
```

A checkout session must be updated with buyer and fulfillment selections before completion. Payment completion uses a delegated Stripe Shared Payment Token; never place credentials in a URL.

## Commercial behavior

- Catalogue products are normally quote-based and do not become binding orders through search or quote tools.
- `request_quote` creates a sales lead, not a payment or order.
- `order_sample_kit` starts a Stripe-hosted browser checkout; the tool itself does not collect card data.
- ACP checkout applies only to explicitly eligible fixed-price Commerce SKUs.
- Do not include personal information, API keys, payment credentials, or delegated tokens in URLs.