clerk

Clerk through One

Clerk provides user authentication and user management solutions for modern web applications, including features like sign-in, sign-up, user profiles, and session handling out-of-the-box.

One exposes Clerk through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform clerk if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm Clerk is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real Clerk account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Users

Action	Method	Path	Action id
Count Users	GET	/users/count	conn_mod_def::GJ1L3NtHkXI::hDXsAQrkSa27qnqU1SvwQg
List Users	GET	/users	conn_mod_def::GJ1L4sXQ2AE::S0As9aD3QU63FtiTBpAA_w
Retrieve a User	GET	/users/{{userId}}	conn_mod_def::GJ1L5DdgkqE::UgwnohPiR-GpoHvFkZdB8A
Retrieve a User’s Billing Credit Balance	GET	/users/{{userId}}/billing/credits	conn_mod_def::GJ1L5VNrzXE::Lt02peI1TKOi8hdQNC-krQ
Retrieve a User’s OAuth Access Token (by Provider)	GET	/users/{{userId}}/oauth_access_tokens/{{provider}}	conn_mod_def::GJ1L53IyQ9Y::780xRf4tQOKl3lgbNVAz-w
Ban a User	POST	/users/{{userId}}/ban	conn_mod_def::GJ1L23UMYGY::mhmyjEQpRZi5-p5qdOpYgw
Ban Multiple Users	POST	/users/ban	conn_mod_def::GJ1L2_Z0Aow::KTsP3NrfRwSRqGVMIwXM2g
Create a New User	POST	/users	conn_mod_def::GJ1L3YJ_Mro::bJYRwmT6SzSMNudDD1LgDQ
Delete a User	DELETE	/users/{{userId}}	conn_mod_def::GJ1L3fJE1xk::0dn082cwTzKfBX8MW4EiCA
Delete a User’s Profile Image	DELETE	/users/{{userId}}/profile_image	conn_mod_def::GJ1L4Pa8ZH0::Ntixk43OSWK7smXUW6Lx0Q
Delete a User's TOTPs	DELETE	/users/{{userId}}/totp	conn_mod_def::GJ1L3-zGrL0::6nSaJaRxRSy_V-zmOoA9Jg
Delete a User's Web3 Wallet	DELETE	/users/{{userId}}/web3_wallets/{{web3WalletIdentificationId}}	conn_mod_def::GJ1L3u_jdW8::Rh2ykuVvQ2GuvovOHWyNwQ