Configure an MCP server for Clerk OAuth
configure_mcp_serverRegister an MCP server URL as an OAuth resource on an instance so Clerk issues access tokens with that URL as the audience. The first MCP server on an instance also turns on the audience claim and CIMD client registration; later servers leave OAuth settings as they are and report settings that still block MCP clients. Registering a marked URL changes nothing; an eligible legacy Dashboard registration with the same URL is marked as an MCP server. Pass replace_resource_url to replace a registered URL (the URI of a resource cannot be edited). Pass dry_run: true to see what would change without saving. After a save the tool requests a public discovery check when a checker is available.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"application_id": "<application_id>",
"instance": "<instance>",
"resource_url": "<resource_url>"
},
"name": "configure_mcp_server"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | Preview the change without saving it. | |
| instance | Yes | Instance to target: "development", "production", or a full instance ID (ins_…). | |
| resource_url | Yes | Public https URL of the MCP server, e.g. https://mcp.example.com/mcp. | |
| application_id | Yes | Clerk application ID (app_…). | |
| replace_resource_url | No | A registered MCP server URL to replace with resource_url. Omit to add resource_url. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| check | Yes | ||
| mcp_server | Yes | ||
| next_steps | Yes | ||
| instance_id | Yes | ||
| resource_url | Yes | ||
| setup_prompt | Yes | ||
| configuration | Yes | ||
| application_id | Yes | ||
| end_to_end_verified | Yes | ||
| authorization_server | Yes |