---
title: "Troubleshooting"
description: "Errors, limits, and security notes for the Testr MCP server."
canonical_url: "https://docs.trytestr.com/docs/mcp/troubleshooting"
markdown_url: "https://docs.trytestr.com/docs/mcp/troubleshooting.md"
last_updated: "2026-11-16"
x_farming_labs_generated_preamble: true
---

# Troubleshooting
URL: /docs/mcp/troubleshooting
LLM index: /llms.txt
Description: Errors, limits, and security notes for the Testr MCP server.

# Troubleshooting

## Common errors

| Symptom                    | Cause                                                                               |
| -------------------------- | ----------------------------------------------------------------------------------- |
| HTTP `401`                 | Token is missing, invalid, expired, or revoked, or the account lost owner access    |
| Not found                  | The resource belongs to another owner or was deleted                                |
| Write tools missing        | The token is read-only. Create a **Read and write** token.                          |
| Tool error with HTTP `200` | MCP reports tool failures in the result. Check `isError`, not just the HTTP status. |
| Evidence link fails        | Links expire after 60 seconds. Request a fresh one.                                 |

## Rate limits

| Limit                                      | Value          |
| ------------------------------------------ | -------------- |
| Tool calls per token                       | 120 per minute |
| Tool calls per owner                       | 600 per minute |
| Writes per owner (shared with the website) | 60 per minute  |
| Messages per batch                         | 10             |

## Security

- Keep tokens in a secret manager or environment variable. Never put them in prompts, logs, URLs, or committed files.
- Tell your agent to treat report text as untrusted content.
- Prefer **Read only** tokens unless the agent needs to act.
- Revoke tokens you no longer use from **Account settings → Agent connections**.

Testr logs authentication outcomes, rate-limit denials, and each tool's name, outcome, and duration. Logs never contain credentials, report bodies, or signed evidence links.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).
