Clerk
Server Details
Access Clerk authentication docs, SDK snippets, and quickstart guides
- Status
- Healthy
- Uptime
- 100.0% over 47 days
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one retrieves a specific snippet, the other lists all snippets. No overlap in functionality or ambiguity.
Naming is inconsistent: 'clerk_sdk_snippet' is a noun phrase without a verb, while 'list_clerk_sdk_snippets' follows a verb_noun pattern. Also mixes singular and plural forms, breaking predictability.
With only 2 tools, the server feels thin but is arguably sufficient for a read-only snippet retrieval service. It falls in the borderline range for low tool counts.
The surface covers listing and fetching snippets, including tag filtering for discovery. No create/update/delete operations are expected for a static snippet repository, so the read-only coverage appears complete.
Available Tools
2 toolsclerk_sdk_snippetClerk SDK snippetBInspect
Get Clerk SDK code snippets and patterns.
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | SDK snippet slug (e.g. "use-user", "use-auth") OR bundle name (e.g. "b2b-saas", "organizations"). | b2b-saas |
Output Schema
| Name | Required | Description |
|---|---|---|
| text | Yes | Requested Clerk SDK snippet or bundle in Markdown. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The annotations provide no helpful safety hints since all three hints are false, so the description carries the transparency burden. It only says 'get' and adds no context about side effects, authentication, rate limits, or the fact that a whole bundle may be returned rather than a single snippet.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, front-loaded sentence that immediately communicates the core action. It contains no filler or unnecessary detail, though it does repeat 'Clerk SDK' from the title.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a low-complexity tool with one optional parameter, a detailed slug schema, and an output schema, the definition is mostly sufficient for invocation. The main gap is that it does not point the agent to list_clerk_sdk_snippets for discovering valid slugs, though the schema already covers the default value.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema already documents the 'slug' parameter thoroughly with examples of both snippet slugs and bundle names, so schema description coverage is 100%. The tool description adds no parameter-specific meaning beyond this, making the baseline score appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a clear action ('Get') and a resource ('Clerk SDK code snippets and patterns'), so the basic purpose is understandable. However, it does not specify that a particular snippet or bundle is retrieved by slug, which leaves it less distinct from the sibling list_clerk_sdk_snippets.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to use this tool instead of list_clerk_sdk_snippets, or that the sibling should be used to discover available slugs. An agent must infer the intended usage entirely from the tool name and schema.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_clerk_sdk_snippetsList Clerk SDK snippetsBInspect
List all available Clerk SDK snippets and bundles. Filter by tag to find specific functionality.
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Filter snippets by tag (e.g. "auth", "organizations", "b2b", "billing") |
Output Schema
| Name | Required | Description |
|---|---|---|
| text | Yes | Available Clerk SDK snippets and bundles in Markdown. |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations are all false, so the description carries the burden of behavioral disclosure. It states the tool lists snippets and bundles and can filter by tag, but doesn't disclose return format, pagination, or whether bundles are included by default. It adds some context beyond annotations but not rich behavioral detail.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, front-loaded with the main purpose and a clear filter instruction. No wasted words, though it could be slightly more specific about the relationship to the sibling tool.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple list tool with one optional parameter and an output schema, the description is mostly complete. However, it doesn't clarify whether bundles are separate from snippets, how tags map to results, or any pagination/limits. The output schema exists, so return values are covered, but the tag filtering semantics could be clearer.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the schema already documents the tag parameter. The description adds the example tags and the filtering behavior, but doesn't add significant meaning beyond the schema. Baseline 3 is appropriate.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool lists all available Clerk SDK snippets and bundles, with a filter by tag. It distinguishes itself from the sibling tool clerk_sdk_snippet by focusing on listing rather than retrieving a single snippet, though it doesn't explicitly name the sibling.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies usage: use this tool to list snippets and filter by tag. It doesn't explicitly state when to use this tool versus clerk_sdk_snippet, but the listing vs. single-snippet distinction is inferable from the name and description.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
2 tool updates
- Changed
clerk_sdk_snippet1 field changed- changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, + "properties": { + "text": { + "description": "Requested Clerk SDK snippet or bundle in Markdown.", + "type": "string" + } + }, + "required": [ + "text" + ], + "type": "object" +}
- Changed
list_clerk_sdk_snippets1 field changed- changed
Output schema / (root)Previous value: -nullNew value: +{ + "$schema": "https://json-schema.org/draft/2020-12/schema", + "additionalProperties": false, + "properties": { + "text": { + "description": "Available Clerk SDK snippets and bundles in Markdown.", + "type": "string" + } + }, + "required": [ + "text" + ], + "type": "object" +}
2 tool updates
- Changed
clerk_sdk_snippet2 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false
- Changed
list_clerk_sdk_snippets2 fields changed- changed
Input schema / $schemaPrevious value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema" - removed
Input schema / additionalPropertiesRemoved value: -false
2 tool updates
- First observed
clerk_sdk_snippet - First observed
list_clerk_sdk_snippets
Related MCP Connectors
Provides access to Avalara developer documentation, integration guides, and code examples
Search PayU docs, browse the payment integration catalog, and fetch production-ready code.
Search Checkout.com docs and API reference, plus manage payments, refunds, and payment links.
Read-only access to Communicate developer guides, OpenAPI summaries, and support contact.
Related MCP Servers
- FlicenseAqualityDmaintenanceProvides access to Better Auth framework documentation, authentication provider configurations, database adapter setup, and generates production-ready authentication configs for modern web frameworks.62-
- AlicenseBqualityNot gradedmaintenanceProvides AI agents with access to Statly SDK and API documentation, enabling search across docs, retrieval of language-specific SDK references, code examples, and REST API information.4-
- FlicenseAqualityDmaintenanceProvides access to 600+ documentation libraries from DevDocs.io including Python, JavaScript, React, Django, and more. Enables searching, browsing, and retrieving documentation content directly through Claude Desktop.55-
- AlicenseAqualityDmaintenanceEnables interaction with AIApp BaaS authentication system through keyword-based document search and automatic generation of framework-specific client code. Supports React, Next.js, Vue, and Vanilla JS with TypeScript integration and automatic project ID injection.324 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.