# Goody — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/goody

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_goody?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/goody/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/goody/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/goody/skill.md
Postman collection (v2.1): https://mcp.ai/goody/postman.json

## Tools
- goody_calculate_price_for_order_batch(cart: object, recipients: object[], send_method: string) — 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
- goody_create_webhook(url: string, events?: string[]) — 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.
- goody_delete_webhook(id: string) — 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
- goody_list_all_active_cards(page?: integer, per_page?: integer) — Tool to list all active digital greeting cards. Use when you need to fetch available card options before sending.
- goody_list_all_active_products(page?: integer, per_page?: integer, country_code?: string, use_custom_catalog?: boolean, custom_catalog_show_inactive?: boolean) — Tool to list all active products. Use when you need to fetch available active products with pagination and filters.
- goody_list_all_order_batches(page?: integer, per_page?: integer) — Tool to list all order batches. Use when you need to paginate through your account's order batches.
- goody_list_all_orders(page?: integer, per_page?: integer) — 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
- 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
- goody_list_all_workspaces() — Tool to list all workspaces. Use when you need to retrieve all workspaces associated with the account.
- goody_list_collections(page?: integer, per_page?: integer) — 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 
- goody_list_order_activities(page?: integer, per_page?: integer) — 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
- 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
- goody_retrieve_product(id: string, use_custom_catalog?: boolean) — Tool to retrieve details of a specific product by its ID. Use after obtaining the product ID.

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

## Links
Docs: https://mcp.ai/docs/mcps/goody
Website: https://mcp.ai/mcps/goody