upsert_profile
Create or Update User Profile
Create a Chameleon user profile by external UID, or update an existing profile by profile ID, UID, or email. Send custom user properties and associate the user with a company.
Ask your agent in plain language. Each of these maps to a real tool on the server.
upsert_profile
Create a Chameleon user profile by external UID, or update an existing profile by profile ID, UID, or email. Send custom user properties and associate the user with a company.
who_am_i
Retrieve the Chameleon account and administrator associated with the connected API key.
manage_deliveries
Create, list, or delete experience deliveries in Chameleon. Deliveries trigger tours or microsurveys directly to specific users with configurable time windows. Use this to schedule or send experiences to individual users on demand.
list_tags
List all tags in your Chameleon account, or retrieve a specific tag by ID. Tags are used to group and categorize experiences (e.g., "Upsell", "Feature", "Onboarding").
manage_domains
List, create, or update approved domains where Chameleon experiences can be displayed. Domains must be approved before Chameleon content appears on them.
delete_profile
Permanently delete or reset a Chameleon user profile. Use **clear** mode to reset a profile (clears browser metrics, survey responses, events) while keeping the profile record. Use **forget** mode to permanently remove all user data with no recovery (backup retained for 3 months).
get_profile
Retrieve a single Chameleon user profile by its Chameleon profile ID, external UID, or email address. Returns the full user profile including all custom properties.
list_survey_responses
Retrieve responses for a specific Chameleon microsurvey. Returns response details including button clicks, text inputs, dropdown selections, and the page URL. Optionally expand profile and company data for each response.
list_tour_interactions
Retrieve user interactions for a specific Chameleon tour. Shows how users interacted with the tour, including started, completed, exited, and displayed states. Optionally expand user profile and company data.
list_tours
List all product tours in your Chameleon account, or retrieve a specific tour by ID. Returns tour details including name, status, segment targeting, and interaction statistics.
list_segments
List audience segments used for targeting Chameleon experiences, or retrieve a specific segment with its filter expressions. Optionally list experiences (tours, surveys, launchers) connected to a segment.
upsert_company
Create a Chameleon company by external UID, or update an existing company by Chameleon ID or UID. Send account properties used to target and personalize experiences.
update_experience
Update a Chameleon tooltip or launcher. Publish/unpublish, add/remove environment associations, and manage tags. For tours and microsurveys, use the dedicated update tools instead.
list_microsurveys
List all microsurveys in your Chameleon account, or retrieve a specific microsurvey by ID. Returns microsurvey details including name, status, segment targeting, and response statistics.
list_companies
List and search Chameleon companies (accounts). Supports filtering with segmentation filter expressions. Can also retrieve a specific company by Chameleon ID or external UID.
manage_webhooks
List, create, or delete Chameleon outgoing webhook subscriptions. Webhooks receive POST requests when specified events occur (tour/microsurvey interactions, HelpBar events, etc.). Available topics include: tour.started, tour.completed, tour.exited, tour.snoozed, tour.button.clicked, survey.started, survey.completed, survey.exited, survey.snoozed, survey.button.clicked, response.finished, helpbar.search, helpbar.answer, helpbar.item.action, helpbar.item.error, and more.
update_tour
Update a Chameleon product tour's settings. You can publish/unpublish, add/remove environment associations, and add/remove tags. To add an environment or tag, prefix the ID with "+". To remove, prefix with "-".
manage_environments
List, create, or update Chameleon environments (URL groups). Environments group domains and are used to control which experiences show in which environments (e.g., production, staging, development).
search_profiles
Search and list Chameleon user profiles using filters or segment targeting. Supports filtering by user properties, tour interactions, survey responses, and more. Can also count matching profiles without returning full data.
delete_company
Permanently delete a Chameleon company by its Chameleon ID or external UID. Optionally cascade the deletion to remove all associated user profiles.
update_microsurvey
Update a Chameleon microsurvey's settings. You can publish/unpublish, add/remove environments, and manage tags. To add an environment or tag, prefix the ID with "+". To remove, prefix with "-".
list_experiences
List Chameleon experiences by type: tooltips, launchers, or retrieve a single experience by ID. Returns experience details including name, publish status, segment targeting, and tags. Use this for tooltips and launchers; for tours and microsurveys use the dedicated tools.
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 Chameleon user profiles and companies, publish or unpublish product adoption experiences, retrieve audience segments and interaction data, schedule individual experience deliveries, and configure domains, environments, and outgoing webhooks.
Common questions about connecting Chameleon to AI agents with Metorial.