# Goody — how to use (mcp.ai)

Connect your Goody account and use 13 tools for ecommerce straight from your AI agent. Connect with your own API key. Goody is a platform that enables users to send gifts and physical products without handling logistics, offering APIs for commerce and automation.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_goody?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `goody_calculate_price_for_order_batch`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/goody`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/goody/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/goody/calculate/price/for/order/batch` — Calculate price estimate for an order batch before creation. Returns per-recipient cart pricing (product, shipping, processing, tax) and total batch cost. All prices are in USD cents (e.g., 100 = $1.0
  - body: { cart: object, recipients: object[], send_method: string }
- `POST https://api.mcp.ai/api/goody/create/webhook` — Tool to create a webhook endpoint to receive notifications about order events. Use when you need to set up automated notifications for order lifecycle events like creation, shipment, or delivery.
  - body: { url: string, events?: string[] }
- `POST https://api.mcp.ai/api/goody/delete/webhook` — Delete a webhook endpoint to stop receiving notifications from Goody API. Use this when you need to remove a webhook endpoint that is no longer needed or needs to be reconfigured. The operation return
  - body: { id: string }
- `POST https://api.mcp.ai/api/goody/list/all/active/cards` — Tool to list all active digital greeting cards. Use when you need to fetch available card options before sending.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/goody/list/all/active/products` — Tool to list all active products. Use when you need to fetch available active products with pagination and filters.
  - body: { page?: integer, per_page?: integer, country_code?: string, use_custom_catalog?: boolean, custom_catalog_show_inactive?: boolean }
- `POST https://api.mcp.ai/api/goody/list/all/order/batches` — Tool to list all order batches. Use when you need to paginate through your account's order batches.
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/goody/list/all/orders` — Retrieves a paginated list of all orders across all order batches in your Goody account. Returns order details including recipient information, cart items, amounts, status, and gift links. Supports pa
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/goody/list/all/payment/methods` — Retrieves all saved payment methods for the authenticated account. Payment methods include credit cards and other payment types that can be used when creating orders. No parameters required - simply c
- `POST https://api.mcp.ai/api/goody/list/all/workspaces` — Tool to list all workspaces. Use when you need to retrieve all workspaces associated with the account.
- `POST https://api.mcp.ai/api/goody/list/collections` — Tool to list all collections across accessible workspaces. Use when you need to retrieve product collections available in Goody. This endpoint is limited to Automation API usage and returns paginated 
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/goody/list/order/activities` — Tool to list all order activities (events) in your workspace. Returns a paginated list of order status transitions and related events. Use when you need to track order lifecycle events, monitor status
  - body: { page?: integer, per_page?: integer }
- `POST https://api.mcp.ai/api/goody/retrieve/current/user` — Retrieve the current authenticated user's profile information from Goody API. This endpoint returns the email and public app ID associated with the authenticated account. Use this to verify authentica
- `POST https://api.mcp.ai/api/goody/retrieve/product` — Tool to retrieve details of a specific product by its ID. Use after obtaining the product ID.
  - body: { id: string, use_custom_catalog?: boolean }

## Example prompts
- "What can I do in Goody?"
- "Show me a summary of my Goody account"

## More
- Page: https://mcp.ai/goody
- Agent spec (llms.txt): https://mcp.ai/goody/llms.txt
- Postman collection: https://mcp.ai/goody/postman.json