Error Codes

LawForge returns structured error responses for all failure cases.

Error Response Format

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please wait 60 seconds."
  }
}

Error Codes

Handling Errors

Rate Limits

When you receive rate_limit_exceeded:

1. Check the Retry-After header for wait time
2. Implement exponential backoff
3. Consider upgrading your plan for higher limits

if (error.code === "rate_limit_exceeded") {
  const retryAfter = response.headers.get("Retry-After") || "60";
  await sleep(parseInt(retryAfter) * 1000);
  // Retry request
}

Not Found

When document_not_found is returned:

• Verify the document ID is correct
• The document may not exist in our database
• Try searching by case name instead

Invalid Query

When invalid_query is returned:

• Check query syntax
• Verify parameter types match the schema
• Review the specific error message for details

MCP Error Responses

MCP tools return errors in this format:

{
  "isError": true,
  "content": [
    {
      "type": "text",
      "text": "Error: Rate limit exceeded. Please wait 60 seconds."
    }
  ]
}