edit_artwork
Edit Artwork
Update an existing artwork's name, description, or page images. Only provide the fields you want to change.
Ask your agent in plain language. Each of these maps to a real tool on the server.
edit_artwork
Update an existing artwork's name, description, or page images. Only provide the fields you want to change.
delete_artwork
Permanently delete artwork from your organisation. This cannot be undone.
create_contact_list
Create a new contact list with optional custom fields. Custom fields support text, date, number, and url types.
list_templates
Retrieve available message templates configured in the Cardly business portal. Templates define text layout, styling (font, color, size, alignment), writing style, and support variable substitution (e.g. `{{firstName}}`) for personalization.
get_contact
Retrieve a contact by its ID within a contact list. Use list_contact_lists and list_contacts to discover IDs.
send_invitation
Invite a new user to your organisation portal with specific permissions. Available permissions: administrator, artwork, billing, campaigns, developer, lists, orders, templates, use-credits.
generate_preview
Generate a low-quality, watermarked preview PDF of a card and envelope before placing a live order. Use this to verify artwork, template, and recipient details look correct.
sync_contact
Create or update a contact using an upsert operation. Matches existing contacts by external ID or email. If a match is found, the contact is updated; otherwise, a new contact is created. Ideal for keeping Cardly contacts in sync with your CRM.
list_users
Retrieve all users who have access to your organisation portal, including their roles and permissions.
update_webhook
Update an existing webhook's target URL, subscribed events, enabled status, or metadata. Only provide the fields you want to change.
manage_invitation
Resend or revoke a pending invitation by invitation ID or email address.
list_orders
Retrieve orders placed by your organisation. Returns order details including status, line items, and cost information.
get_account_balance
Retrieve the current card credit balance and gift credit balance for your organisation. Optionally include recent credit transaction history.
list_invitations
List organisation invitations and their IDs, email addresses, permissions, and status before resending or revoking an invitation.
list_artwork
List available card artwork for your organisation. Returns both organisation-specific and shared/free artwork. Use the ownOnly filter to see only your uploaded artwork.
list_contacts
List contacts in a specific contact list. Returns paginated results with contact details including name, address, email, and custom fields.
place_order
Place an order to send one or more personalized handwritten cards, postcards, or letters. Each line item specifies artwork, a message template, and recipient details. Cards will be printed and mailed to the recipients. Supports variable substitution in templates, custom sender/return addresses, shipping method selection, and idempotent requests to prevent duplicate orders.
delete_contact_list
Permanently delete a contact list and all contacts within it. This cannot be undone.
list_resources
Browse available design resources including media types (product sizes like greeting cards, postcards, letters), handwriting fonts, writing styles (messiness levels), and doodles (decorative images). Select which resource types to retrieve.
create_contact
Add a new contact to a contact list with their name, address, and optional custom field values.
find_contact
Search for a contact within a list by email address or external ID. Returns the matching contact details.
list_contact_lists
Retrieve all active contact lists for your organisation, including their custom field definitions.
remove_user
Remove a user's access to the organisation portal. This cannot be undone — the user will need to be re-invited.
delete_contact
Remove a contact from a contact list. Can delete by contact ID, email address, or external ID.
delete_webhook
Permanently delete a webhook subscription. The webhook will stop receiving event notifications.
create_webhook
Create a new webhook subscription. The webhook will receive POST requests to the target URL for the specified event types. A secret key is returned once at creation for signature verification. Available events: `contact.order.created`, `contact.order.sent`, `contact.order.refunded`, `giftCard.redeemed`, `qrCode.scanned`, `contact.undeliverable`, `contact.changeOfAddress`, `consignment.undeliverable`, `consignment.changeOfAddress`.
create_artwork
Upload new card artwork with base64-encoded page images. Artwork is associated with a specific media type (product size). Use the list resources tool to discover available media types.
list_webhooks
Retrieve all webhooks configured for your organisation, including their target URLs, subscribed events, and enabled status.
get_order
Retrieve detailed information about a specific order by its ID, including line items, cost, and current status.
edit_contact
Update an existing contact's details. Only provide the fields you want to change.
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 personalized, handwritten greeting cards, postcards, and letters at scale via physical mail. Place orders with customizable artwork, message templates, and recipient details for delivery to 50+ countries. Manage card artwork by uploading page images, and use message templates with variable substitution for personalization. Create and manage contact lists with custom fields, sync contacts via upsert, and configure automation rules for triggers like birthdays. Generate preview PDFs before placing live orders. Browse available media types, handwriting fonts, writing styles, and decorative doodles. Query account credit balances and transaction history. Manage organization users and invitations with configurable permissions. Set up webhooks to receive notifications for order, shipping, gift card redemption, QR code scan, and delivery events.
Common questions about connecting Cardly to AI agents with Metorial.