Skip to main content
The server exposes 28 tools. Each is named goody_<resource>_<verb> and requires one of three permissions — Read, Write, or Send gifts (see Authentication). Select a tool for its parameters, returns, and a worked prompt → tool call → result example.

Account & workspaces

ToolPermissionDescription
goody_me_getReadGet the connected account’s profile and the server’s current time.
goody_workspaces_listReadList the workspaces you can gift from.

Discover gifts & cards

ToolPermissionDescription
goody_products_searchReadSearch the catalog by intent, budget, and filters (up to 5 matches).
goody_products_getReadRetrieve full detail for a single product.
goody_collections_listReadList curated gift collections.
goody_gift_of_choice_listReadList “let them pick” Gift of Choice options, optionally budget-framed.
goody_cards_listReadList greeting cards, filterable by occasion.

Contacts

ToolPermissionDescription
goody_contacts_searchReadSearch workspace contacts by name or email.
goody_contacts_getReadRetrieve a single contact, with event dates.
goody_contacts_createWriteAdd a workspace contact.
goody_contacts_updateWriteUpdate an existing contact.
goody_contact_lists_listReadList contact lists.
goody_contact_lists_createWriteCreate a contact list, optionally with members.

Messages

ToolPermissionDescription
goody_messages_generateReadDraft three card-message options for an occasion.

Payment methods

ToolPermissionDescription
goody_payment_methods_listReadList saved payment methods, Goody Balance, and Corporate Account (display names only — never card numbers).

Send & track gifts

ToolPermissionDescription
goody_order_batches_previewWriteBuild a shareable preview link and price a gift that hasn’t been sent. The confirmation step.
goody_order_batches_priceWriteEstimate the full price of a gift. A quick estimate; needs Write because it builds a draft order (see Authentication).
goody_order_batches_createSend giftsSend a gift. Requires explicit confirmation of the price.
goody_order_batches_listReadList past gift batches.
goody_order_batches_getReadRetrieve a single gift batch.
goody_orders_listReadList individual orders, optionally within a batch.
goody_orders_cancelWriteCancel a single order the recipient hasn’t accepted yet.

Autogifts

ToolPermissionDescription
goody_autogift_rules_listReadList autogift rules.
goody_autogift_rules_createSend giftsCreate a recurring autogift — clone a past send or build from scratch (always created paused).
goody_autogift_rules_previewReadPreview a paused rule’s gift and per-send cost before activating.
goody_autogift_rules_activateSend giftsActivate a paused autogift rule.
goody_autogift_rules_pauseWritePause an active autogift rule.

Feedback

ToolPermissionDescription
goody_feedback_createWriteSend the user’s feedback about Goody to the Goody team. Never charges.