---
title: "Fix Tool call timed out after 60000ms (TIMEOUT)"
slug: "tool-call-timeout-60s"
code: "TIMEOUT"
category: "Performance & Database"
severity: "Medium"
canonical: "https://mcp-codex.com/errors/tool-call-timeout-60s"
source: "MCP Codex (https://mcp-codex.com)"
dateModified: "2026-09-28"
---

# Fix Tool call timed out after 60000ms (TIMEOUT)

**Category**: Performance & Database | **Severity**: Medium

## Symptom
Long-running database queries, video processing, or web scraping tool calls abort with a timeout error.

## Root Cause
Default client timeouts limit tool execution duration to 60 seconds before concluding the stdio process is unresponsive.

## Remediation & Quick Fix
Split heavy queries into paginated chunks or implement asynchronous polling jobs where the tool returns a job ID immediately.

## OS Remediation Commands

### MAC
```bash
# Check query plan latency before running in MCP:
psql $DATABASE_URL -c "EXPLAIN ANALYZE SELECT ...;"
```

### WINDOWS
```bash
# Check query plan latency:
psql.exe $env:DATABASE_URL -c "EXPLAIN ANALYZE SELECT ...;"
```

### LINUX
```bash
# Check query plan latency:
psql $DATABASE_URL -c "EXPLAIN ANALYZE SELECT ...;"
```

## Correct Configuration Example
```json
// In your MCP server tool handler:
// Return job token immediately rather than hanging for 120 seconds
return {
  content: [{ type: "text", text: "Job submitted with ID: task_9821. Call check_status to poll." }]
};
```

## Canonical Diagnostic Link
https://mcp-codex.com/errors/tool-call-timeout-60s

## Weekly Protocol & Patch Diffs
Subscribe to verified runtime fixes and schema changes: https://mcp-codex.com#newsletter