Ask your agent in plain language. Each of these maps to a real tool on the server.
update_contact
Update a contact's attributes such as name, phone, birthdate, or any custom attributes. Call list_contact_attributes to discover field names. System-managed values like credit balance and creation date cannot be updated through this tool.
delete_contact
Delete a contact from the loyalty system. Supports standard deletion or GDPR-compliant deletion which ensures full data removal. This is an asynchronous operation.
list_contacts
List loyalty program contacts with filtering and pagination. Use this to browse contacts, find recently created contacts, or retrieve a paginated list of all contacts in the system.
create_contact
Create a new contact in the loyalty system. Supports creating a contact by email, finding or creating by email (idempotent), or creating an anonymous contact. Use **findOrCreate** mode to avoid duplicates.
manage_giftcards
Create, list, get, and find gift cards. Also supports creating transactions (adding/deducting balance) on gift cards. Gift cards are anonymous and not linked to contacts.
list_rewards
List available rewards in the loyalty program. Optionally filter by shop or contact to see which rewards are claimable by a specific contact.
list_loyalty_transactions
List loyalty transactions including credit receptions and reward receptions. Filter by contact, shop, type, and date range to track credit activity.
get_loyalty_program
Retrieve the loyalty program configuration including program name, max credit amount, custom credit name, and unit settings. Also lists available tiers and gift card programs.
list_shops
List all shops connected to the account. Shops represent physical locations or web shops and are required for many operations like awarding credits, redeeming vouchers, and gift card transactions.
manage_vouchers
Create, list, find, update, or redeem vouchers. Vouchers are tied to promotions and can be assigned to contacts. Use this tool to manage the entire voucher lifecycle.
manage_prepaid
Manage a contact's prepaid balance. Create transactions to top up or deduct from prepaid balance, list transaction history, or check current balance. Prepaid balances are linked directly to contacts.
manage_contact_identifiers
Create, find, link, or unlink contact identifiers. Contact identifiers are used to associate physical cards, QR codes, or other identifiers with contacts in the loyalty system.
list_promotions
List all promotions in the account. Promotions define voucher campaigns and are required when creating vouchers. Optionally retrieve a single promotion by UUID.
claim_reward
Claim a reward for a contact, deducting the required credits from their balance. Also supports reversing a previously claimed reward to restore credits.
get_contact
Retrieve a single contact by UUID or email address. Also returns the contact's credit balance, prepaid balance, and tier in a single call.
trigger_automation
Trigger a contact_updated automation run for a specific contact. Automations are workflows configured in the Piggy dashboard that can send emails, award credits, or perform other actions. Optionally list available automations.
award_credits
Award loyalty credits to a contact. Credits can be awarded directly by specifying a credit amount, or calculated from a unit value (e.g. purchase amount). Use this to reward customers for purchases or other activities.
list_giftcard_transactions
Retrieve gift card transaction history with gift card, program, shop, date, sorting, and pagination filters. Older transactions may have no UUID and cannot be reversed by UUID.
reverse_transaction
Reverse a credit reception, prepaid transaction, or gift card transaction by its UUID. Creates a compensating transaction using the original values. Gift card reversal is limited to the latest transaction.
calculate_credits
Preview the loyalty credits for a unit value without awarding them. Time-based loyalty rules can make the final award differ from this preview.
list_contact_attributes
Discover contact attribute names and data types before updating contact attributes.
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.
Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.
Search and prospect B2B contacts and companies from a database of over 275 million people and 70 million organizations. Enrich people and company data with emails, phone numbers, and firmographic details. Create and manage contacts, accounts, deals, and tasks. Add contacts to email sequences and manage sequence statuses. Log and search call records. Perform bulk operations for contact creation, account creation, task creation, and data enrichment.
Create, read, update, and delete CRM objects including contacts, companies, deals, tickets, and custom objects. Manage associations between CRM records. Track engagements such as calls, emails, meetings, notes, and tasks. Send transactional and marketing emails, manage campaigns, and handle subscription preferences. Build and manage marketing workflows, sequences, and automation actions. Manage CMS content including blog posts, landing pages, and HubDB tables. Handle commerce data including products, orders, invoices, quotes, and payments. Create and manage contact lists for segmentation. Configure deal, ticket, and order pipelines with custom stages. Search and filter CRM records. Bulk import and export CRM data. Manage users, teams, and account settings.
List, retrieve, and cancel scheduled events. Book meetings programmatically on behalf of invitees using available time slots. Retrieve event types and their configurations. Query user availability, available time slots, busy times, and availability schedules. Create single-use scheduling links with optional overrides. List and manage invitees, mark no-shows, and access custom question responses and UTM tracking data. Manage organization memberships, invite or remove users. Retrieve routing form configurations and submissions. Subscribe to webhooks for new bookings, cancellations, and routing form submissions.
Authenticate LinkedIn members with OpenID Connect, fetch the authenticated member profile, and create self-serve LinkedIn shares with text, article links, and uploaded images. Organization and Community Management workflows should move to a separate slate because LinkedIn restricts combining those products in one app.
Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.
Manage customer loyalty programs, rewards, gift cards, promotions, and vouchers. Create, update, and look up CRM contacts with custom attributes. Track loyalty credits and transactions, issue credit receptions, and manage credit balances. Create and redeem vouchers and promotions. Manage gift cards and prepaid balances. Configure rewards including digital and collectable types. Track orders, products, bookings, and visits. Manage shops, forms, automations, and portal sessions.
Common questions about connecting Piggy to AI agents with Metorial.
