manage_basket
Manage Basket
Add orders to the basket for batch processing, view the current basket, send all basket orders, or clear the basket. Use this when sending multiple cards at once — add each card to the basket, then send all at once.
Ask your agent in plain language. Each of these maps to a real tool on the server.
manage_basket
Add orders to the basket for batch processing, view the current basket, send all basket orders, or clear the basket. Use this when sending multiple cards at once — add each card to the basket, then send all at once.
list_gift_cards
Retrieve available gift cards that can be included with handwritten card orders. Returns brands (e.g., Starbucks, Amazon) and their available denominations. Use the denomination ID when sending a card with a gift card.
browse_cards
Browse available card and stationery designs. Filter by category or paginate through results. Returns card IDs needed for sending cards. Use this to find the right card design before sending.
list_inserts
Retrieve available physical inserts (e.g., business cards, magnets) that can be included with card orders. Use the insert ID when sending a card to include a physical insert.
list_orders
Retrieve a list of past and current orders with their status. Each order includes details about the message, recipient, sender, card, and current processing status (processing, written, complete, problem, or cancelled).
list_return_addresses
Retrieve all saved return (sender) addresses on the account. Use the address ID as returnAddressId when adding orders to the basket.
send_card
Send a physical handwritten card or note to a recipient. Provide the message, card design, handwriting style, recipient address, and sender address. Cards can be scheduled for future delivery by specifying a send date. You can also include a gift card or physical insert with the order.
manage_templates
Create, update, delete, or list message templates. Templates store reusable message content for common outreach scenarios such as thank-you notes, birthday cards, etc.
get_card_details
Retrieve detailed information about a specific card design including images (front, inside, envelope, back), pricing, dimensions, character limits, and custom card info.
list_card_categories
Retrieve all available card categories. Use the returned category IDs to filter cards when browsing card designs.
manage_address_book
Create, update, delete, search, or list recipient contacts in the Handwrytten address book. Set the **action** field to choose the operation. When searching, provide a query to match against name, address, or other fields.
list_handwriting_styles
Retrieve all available handwriting styles (fonts). Each style uses a different handwriting appearance written by robotic pens. Use the returned font label when sending cards.
manage_return_addresses
Create or delete a saved sender address, or choose the default sender address for basket orders. Use list_return_addresses to find existing address IDs.
cancel_order
Cancel a paid order before processing starts. Orders that have already been processed cannot be canceled. Check get_order for the current status.
get_order
Retrieve an order and its processing status, addresses, pricing, and delivery information. Use an order ID returned by send_card or manage_basket.
get_current_user
Retrieve the connected Handwrytten account, including available profile and credit information.
list_countries
List supported destination countries with IDs, names, delivery costs, and available states or provinces. Use country IDs in address and card tools.
list_states
List states or provinces for a supported country. Handwrytten documents this for the United States, Canada, and Mexico.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Send physical handwritten notes and cards using robotic pens. Choose from handwriting styles and 100+ card/stationery designs, or create custom cards with uploaded images and logos. Manage an address book of recipients, create reusable message templates, include gift cards or physical inserts with orders, and schedule cards for future delivery. Support batch ordering via baskets for sending multiple cards at once. Track order status and retrieve proof images of completed letters.
Common questions about connecting Handwrytten to AI agents with Metorial.