Check an MCP server Clerk OAuth setup
check_mcp_serverRead an instance's registered MCP servers, the OAuth settings MCP clients depend on, and the latest public discovery check for one registered MCP server URL. Never changes Clerk OAuth settings. Pass force_recheck: true to start a new checker observation instead of reading the cached one: the checker sends unauthenticated GET requests to the MCP endpoint and reads public protected-resource metadata and Clerk issuer discovery documents. It never forwards Clerk credentials to the resource URL and is not end-to-end OAuth verification.
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>"
},
"name": "check_mcp_server"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| check_id | No | A specific check to read instead of the latest one. Cannot be combined with force_recheck. | |
| instance | Yes | Instance to target: "development", "production", or a full instance ID (ins_…). | |
| resource_url | No | Registered MCP server URL to check. Optional when exactly one is registered. | |
| force_recheck | No | Start a new public discovery check instead of reading the cached one. Defaults to false. | |
| application_id | Yes | Clerk application ID (app_…). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| check | Yes | ||
| mcp_server | No | ||
| next_steps | Yes | ||
| instance_id | Yes | ||
| resource_url | No | ||
| setup_prompt | No | ||
| configuration | Yes | ||
| application_id | Yes | ||
| end_to_end_verified | Yes | ||
| authorization_server | No |