track_sale
Track Sale
Track a sale conversion event. Records a purchase attributed to a customer, with amount, currency, and optional payment processor details. Supports Stripe, Shopify, Polar, Paddle, RevenueCat, or custom processors.
Ask your agent in plain language. Each of these maps to a real tool on the server.
track_sale
Track a sale conversion event. Records a purchase attributed to a customer, with amount, currency, and optional payment processor details. Supports Stripe, Shopify, Polar, Paddle, RevenueCat, or custom processors.
upsert_link
Create a new short link or update an existing one. If a link with the same destination URL already exists, it will be returned or updated. Otherwise, a new link is created. Useful for idempotent link creation.
get_link
Retrieve details about a specific short link. Look up a link by its Dub link ID, external ID, or domain + slug combination. Returns full link details including click counts, tags, and configuration.
list_events
Retrieve a list of tracked events (clicks, leads, sales) from your workspace. Filter by event type, link, domain, or time range to inspect individual conversion events.
manage_domains
List, create, update, or delete custom domains for your short links. Deleting a domain also deletes all its associated links. Domains let you use your own branded URLs instead of the default dub.sh domain.
delete_link
Permanently delete a short link. Use the Dub link ID or an external ID prefixed with `ext_`.
list_links
Retrieve a list of short links from your workspace. Filter by domain, tags, folder, search query, and more. Supports pagination and sorting.
create_link
Create a new short link in your Dub workspace. Supports custom domains, slugs, UTM parameters, device targeting, geo targeting, expiration, password protection, conversion tracking, and custom social media cards.
get_metatags
Retrieve Open Graph metadata (title, description, image) for any URL. Useful for generating link previews or populating social media card fields when creating links.
list_customers
Retrieve customers tracked through the conversion funnel. Filter by email, external ID, country, referral link, or search query. Returns customer details with sales data.
track_lead
Track a lead conversion event attributed to a link click. Requires the click ID (obtained from the `dub_id` cookie) and a customer identifier. Use this when a user performs a significant action like signing up.
update_link
Update an existing short link's properties. You can modify the destination URL, slug, UTM parameters, targeting rules, social media card, and more. Identify the link by its Dub link ID or external ID (prefixed with `ext_`).
get_analytics
Retrieve analytics for your links, workspace, or specific resources. Get click, lead, and sale data grouped by various dimensions like country, device, browser, referrer, timeseries, and more. Use `groupBy` to control the aggregation (e.g., "count" for totals, "timeseries" for time-based data, "countries" for geographic breakdown).
manage_tags
Create, update, delete, or list tags used to categorize and organize links. Tags have a name and a color. Use the `action` field to specify what operation to perform.
who_am_i
Retrieve the current OAuth user and connected Dub workspace.
download_qr_code
Generate a downloadable PNG or SVG QR code for a URL, including a Dub short link. Customize the size, colors, margin, and error correction.
manage_customer
Retrieve, update, or delete a customer by Dub customer ID or an external ID prefixed with ext_. Use List Customers to discover IDs. Deleting a customer removes it from the workspace.
manage_folders
List, create, rename, or delete folders used to organize short links. Deleting a folder keeps its links working and removes their folder association.
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.
Create and manage short links with custom domains, UTM parameters, targeting, expiration, and conversion tracking. Retrieve click and conversion analytics, inspect events, track leads and sales, manage customers, organize links with tags and folders, download QR codes, and retrieve URL metatags.
Common questions about connecting Dub to AI agents with Metorial.