Connect Userlist to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the manage relationship tool in Userlist
Use the delete company tool in Userlist
Use the create or update company tool in Userlist
Use the create or update user tool in Userlist
Use the track event tool in Userlist
Use the send transactional message tool in Userlist
Supported Tools
manage_relationship
Manage Relationship
Creates, updates, or deletes a many-to-many relationship between a user and a company in Userlist. Relationships can carry custom properties such as the user's role within a company.
Use `action: "delete"` to remove the relationship, or omit/set to `"upsert"` to create or update it.
delete_company
Delete Company
Deletes a company from Userlist. The company is identified by its unique identifier. If the company does not exist, the request is silently ignored.
create_or_update_company
Create or Update Company
Creates a new company in Userlist or updates an existing one. Companies represent accounts or organizations that users belong to. If the company already exists (matched by identifier), only the specified fields will be updated.
Set a property to `null` to remove it. Supports custom properties and user relationships.
create_or_update_user
Create or Update User
Creates a new user in Userlist or updates an existing one. If the user already exists (matched by identifier or email), only the specified fields will be updated; omitted fields remain unchanged.
Set a property to `null` to remove it. Supports custom properties, company relationships, and subscription preferences.
track_event
Track Event
Tracks a custom behavioral event in Userlist. Events represent actions performed by users or companies within your product. Events can be associated with a user, a company, or both.
Event names are normalized to `snake_case` internally.
send_message
Send Transactional Message
Sends a one-off transactional message to a user via email or in-app (web) channel. You can use a predefined template or compose a custom message with subject, body, and sender configuration.
When using a template, pass the template identifier along with any custom properties for Liquid personalization.
delete_user
Delete User
Deletes a user from Userlist. The user is identified by their unique identifier or email address. If the user does not exist, the request is silently ignored.
Enable Userlist in Metorial. In your Metorial portal, enable the Userlist MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Userlist tools.
Enable Userlist in Metorial. In your Metorial portal, enable the Userlist MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Userlist tools.
Enable Userlist in Metorial. In your Metorial portal, enable the Userlist MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Userlist tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Userlist in Metorial. In your Metorial portal, enable the Userlist MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Userlist tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Userlist in Metorial. In your Metorial portal, enable the Userlist MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Userlist tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Userlist through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Userlist and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Userlist tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Manage users, companies, and their relationships for SaaS email marketing automation. Create, update, and delete user and company records with custom properties. Track behavioral events performed by users or companies. Send transactional emails and in-app messages using templates or custom content. Manage user subscription preferences for messaging topics.
Frequently asked questions
Common questions about connecting Userlist to AI agents with Metorial.
How many tools does the Userlist MCP server have?
The Userlist MCP server exposes 7 tools, including Manage Relationship, Delete Company, Create or Update Company. Each one is governed and traced through Metorial.
Does the Userlist MCP server support triggers?
Userlist exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Userlist MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Userlist MCP server through the same Metorial URL.
How do I give only some teams access to Userlist?
Use role-based access control to decide which teams, users, and agents can use Userlist and which of its tools they can call.
Can I self-host the Userlist MCP server?
Yes. Metorial is open source, so you can run the Userlist MCP server yourself or use the hosted gateway.
Connect Userlist to production AI agents
See how Metorial gives your team governed access to Userlist, with tracing and security controls built in.