Ask your agent in plain language. Each of these maps to a real tool on the server.
campaign_insights
Retrieve performance insights for an ad campaign. Returns total, today, and yesterday stats including spend, reach, clicks, conversions, CTR, and CPC. Optionally includes creative-level (per-ad) analytics for A/B testing analysis.
link_insights
Retrieve performance analytics for a FanLink. Returns both an overview summary and optional time-series data with flexible aggregation options. The overview includes total clicks, clickthroughs, CTR, email stats, RSVPs, and unique visitor counts. Time-series data supports aggregation by time interval, geography, referrer, and service.
manage_campaign
Create, retrieve, update, or delete an ad campaign on Facebook or Google. When creating, specify platform, objective, budget, targeting, and creatives. When updating, only the fields you provide will be changed. Supports A/B testing through multiple creative variations in the creatives field.
manage_user_list
Create custom user lists for ad targeting, list existing user lists, and add or remove contacts from a list. User lists are linked to Facebook custom audiences and can be used for targeting in ad campaigns.
list_attachments
List all social unlocks or contests for the authenticated user profile. The attachment type (unlock or contest) is required to filter results.
upload_offline_conversions
Upload offline conversion events to track actions that happen outside of digital platforms. This data is used to optimize ad campaign performance by feeding conversion data back to ad platforms.
get_profile
Retrieve the user profile for the authenticated artist or a specific user by ID. Returns profile details including display name, email, avatar, location, and account type.
list_campaigns
List all ad campaigns for the authenticated user profile. Supports filtering by campaign status and pagination. Returns campaign details including performance metrics.
manage_attachment
Create, retrieve, update, or delete a social unlock or contest attachment. **Social Unlocks** gate content (file downloads, coupon codes, URLs, unlisted YouTube videos) behind social actions - every fan who completes the action receives the reward. **Contests** incentivize fans to perform social actions for a chance to win - more actions increase the chance of winning.
update_profile
Update the user profile for a specific user. Allows changing display name, username, bio, avatar, location, and notification settings.
attachment_insights
Retrieve performance analytics for a social unlock or contest. Returns entry totals, unlock totals, platform breakdowns, and optional time-series data. For **contests**, entry data shows how many fans entered over time. For **social unlocks**, unlock data shows how many fans completed the required action and received the reward.
manage_link
Create, retrieve, update, or delete a smart link (FanLink). FanLinks are customizable landing pages that aggregate links to content across multiple platforms. Supports music links, podcast episodes, events, tours, big links (multiple URLs), livestreams, fundraisers, and custom redirects. Links can include tracking pixels, email capture forms, social sharing metadata, and affiliate codes.
list_links
List all smart links (FanLinks) for the authenticated user profile. Supports filtering by link type and pagination.
manage_playbook
Create, retrieve, update, or delete a playbook campaign. Playbooks are pre-structured campaign templates (e.g., Spotify Growth, Instagram Growth, Remarketing Dynamic Event Ads) that automate common marketing strategies. Each playbook campaign can contain subcampaigns of type ad, attachment, link, or message.
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 repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.
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.
Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.
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.
Create, read, update, and delete records in Airtable bases and tables. Manage base schemas including creating tables and fields. Filter records using formulas, sort by fields, and scope queries to specific views. Upsert records to find, create, or update in a single call. Upload attachments to records, read and write record comments, list accessible bases, and receive real-time base change events through webhooks.
Create, manage, and monitor advertising campaigns on Facebook and Google with unified audience targeting, budgeting, and A/B testing. Build smart links (FanLinks) that aggregate content across streaming platforms for music, podcasts, events, and tours. Set up social unlocks to gate content behind social actions and run contests to incentivize fan engagement. Use playbook-based campaign templates for automated marketing strategies like Spotify Growth and remarketing. Create custom user lists for ad targeting, upload offline conversion data, and retrieve campaign performance insights and creative-level analytics. Manage user profiles and list associated campaigns, links, and attachments.
Common questions about connecting Toneden to AI agents with Metorial.
