[harshranjan-ftw]

What

Linear: ENG-3329

The MCP page did not list the timeout and retry settings. They were only in the MCP repo's README. This PR adds them to the environment-variable table and adds a short "Timeouts and retries" section. The section explains the whole-call deadline, which writes are not retried after an unclear failure, Retry-After, and cancellation.

Changes

• plugins/mcp.mdx: HYDRADB_TIMEOUT_SECONDS (default 45) and HYDRADB_MAX_RETRIES (default 2) in the environment-variable table, plus a new "Timeouts and retries" section under Configuration.

Testing

• mintlify-hygiene check --deny-warnings: passed.
• No staging or production system was called.

Merge order

1. MCP: ENG-3329 fix(mcp): one deadline per call, no blind write retries, cancel on hosted MCP hydradb-mcp#117
2. This docs PR: merge after that change is released, since the new default (45s for the whole call) and the retry rules describe it.

---

^{Need help on this PR? Tag @codesmith-bot with what you need.}

[github-actions]

✅ Mintlify Hygiene

No issues found.

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
cortex-ai	🟢 Ready	View Preview	Oct 28, 2026, 10:07 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

[openhack-agent]

✅ OpenHack Summary

Security review of docs(mcp): timeout and retry settings (ENG-3329). 1 changed file; 0 findings at or above the low reporting threshold.

0   0   0   0

Confidence Score: 5/5

No reportable security findings were detected in this scan.

Security merge-readiness rubric: 1 = critical, 2 = high, 3 = medium, 4 = low, 5 = no reportable findings. This score reflects scan findings, not a guarantee of correctness or complete coverage.

Files Needing Attention: None

Important Files Changed

• plugins/mcp.mdx (modified)

Last reviewed commit: 603534a · View review on OpenHack

---

TIP: Mention @openhack-agent in a PR comment to request a review or ask a question. Use @openhack-agent fix all for every finding, or @openhack-agent fix unresolved threads for open review threads only.

[openhack-agent]

OpenHack reviewed this commit. See the OpenHack Summary for the confidence score and fix actions.

[greptile-apps]

Confidence Score: 5/5

[Low impact] The documentation appears safe to merge once the author's stated MCP release prerequisite is met.

Summary

Adds timeout and retry guidance to plugins/mcp.mdx.

• MCP users can see how timeout and retry rules affect tool calls.

_{Reviews (1) · Last reviewed commit: "docs(mcp): timeout and retry settings, a..." · Reviewed by Greptile}

[tushar-hydradb]

didn't review thoroughly, approving to unblock. tested per https://hydradb.slack.com/archives/C0BA3AEHPPZ/p1793627799017369?thread_ts=1793579113.482719&cid=C0BA3AEHPPZ