manage_tags
Manage Tags
Create, delete, or list tags. Also apply or remove tags from contacts in bulk. Tag names are case-insensitive and automatically de-duplicated.
Ask your agent in plain language. Each of these maps to a real tool on the server.
manage_tags
Create, delete, or list tags. Also apply or remove tags from contacts in bulk. Tag names are case-insensitive and automatically de-duplicated.
get_contact
Retrieve a single contact from Gist by their ID, email address, or user ID. Returns the full contact profile including tags, segments, custom properties, and location data.
get_conversation
Retrieve a single conversation by ID, including its messages. Returns conversation metadata, assignment info, and the message thread.
create_or_update_contact
Create a new contact or update an existing one in Gist. Contacts are de-duplicated by email address. If a contact with the given email already exists, it will be updated. Supports setting custom properties, tags, and subscription types.
list_articles
List or search knowledge base articles. Filter by status, collection, or author. Also supports text search by keyword and locale.
get_conversation_counts
Get conversation counts globally, per team, or per teammate. Useful for monitoring workload and queue sizes.
create_conversation
Start a new conversation in Gist with a contact. Optionally assign it to a teammate or team and provide the acting teammate.
manage_article
Create, update, or delete a knowledge base article in Gist. Articles support multi-language translations and can be organized into collections.
batch_import_contacts
Import multiple contacts at once into Gist. Returns a batch ID that can be used to check import status. Contacts are de-duplicated by email address.
list_events
List all tracked event types in your Gist workspace. Returns the names and IDs of all custom events that have been tracked.
reply_to_conversation
Send a reply or add an internal note to a Gist conversation. Replies are visible to the contact; notes are visible only to teammates.
track_event
Track a custom event for a contact in Gist. Events record product interactions like "Clicked Signup Button" or "Viewed Pricing Page". Identify the contact by email or user ID.
delete_contact
Permanently delete a contact from Gist by their ID. This action cannot be undone.
list_contacts
List and filter contacts in your Gist workspace. Supports filtering by status, tag, segment, campaign, form, and email pattern. Results are paginated.
manage_campaign
Subscribe or unsubscribe a contact from a drip campaign. Optionally specify a starting email index or force-resubscribe contacts who previously unsubscribed.
manage_conversation
Perform actions on a Gist conversation: assign/unassign, close, snooze/unsnooze, prioritize, or tag/untag. Use this to manage conversation state and routing.
list_campaigns
List drip email campaigns in your Gist workspace with their performance metrics including open rate, click rate, and subscriber counts.
manage_collection
Create, update, delete, or list knowledge base collections. Collections organize articles into groups with support for nested parent/child hierarchies and multi-language translations.
search_conversations
Search and filter conversations in Gist. Filter by assignee, team, channel, tags, and contact.
manage_product
Create, update, or retrieve e-commerce products and product variants in Gist. Products support categories, pricing, inventory, and SKUs.
manage_form
List forms, view form details and submissions, or subscribe a contact to a form. Forms capture lead data and can trigger automations.
manage_store
Create, update, or list e-commerce store connections in Gist. Stores define the currency, abandoned cart interval, and auto-tagging settings for your e-commerce integration.
list_teams
List all teams and teammates in your Gist workspace. Returns team members, online status, and role information.
manage_customer
Create, update, or retrieve an e-commerce customer in Gist. Customers have billing/shipping addresses and are linked to Gist contacts.
manage_order
Create or update an e-commerce order in Gist. Orders track financial status, fulfillment, and line items. Status changes automatically update contact lifetime value (LTV) and trigger timeline events.
manage_subscription_type
List subscription types, or attach/detach a contact to control which communication categories they receive.
manage_cart
Create, update, or delete an e-commerce shopping cart in Gist. Carts track line items and checkout URLs to power abandoned cart automations.
list_segments
List all contact segments in your Gist workspace. Optionally include contact counts for each segment.
list_conversation_messages
Read a page of conversation messages with optional internal notes. Use pagination to read beyond the first page.
get_batch_import_status
Check a batch_import_contacts job and inspect completed import errors. Queued jobs may omit import counts and errors.
get_article
Retrieve a knowledge base article, including its language translations, author details, content, collection IDs, and statistics.
get_workspace
Identify the Gist workspace authorized by this connection and inspect the token scopes and metadata.
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 Gist workspace contacts, conversations, marketing subscriptions, knowledge base articles, teams, and commerce data. Import contacts and inspect batch status, read paginated conversation messages, manage tags and forms, and sync store-scoped customers, products, carts, and orders.
Common questions about connecting Gist to AI agents with Metorial.