check_testrail_auth
Verify TestRail credentials and diagnose authentication failures with structured error hints.
Instructions
Verify the configured TestRail credentials and report a structured diagnosis.
Calls a lightweight TestRail endpoint (get_priorities, which every
authenticated user can reach) and translates the outcome into an
actionable result the LLM can act on. Use this when:
A user reports the server isn't working
Another tool returns a 401/403/auth error and the cause is unclear
Confirming setup is correct before kicking off a longer workflow
Returns a dict with at least:
ok: bool — True if the credential check succeededconfig: which URL / username / auth method the server is using (never includes the secret itself)
On success, also includes the priorities count and the username TestRail
associates with the credentials. On failure, includes error_class,
error, status_code (when extractable), and a human-readable
hint explaining the most likely cause and remediation.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "check_testrail_auth"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||