jeremylongshore / openevidence-common-errors
Install for your project team
Run this command in your project directory to install the skill for your entire team:
mkdir -p .claude/skills/openevidence-common-errors && curl -L -o skill.zip "https://fastmcp.me/Skills/Download/3067" && unzip -o skill.zip -d .claude/skills/openevidence-common-errors && rm skill.zipProject Skills
This skill will be saved in .claude/skills/openevidence-common-errors/ and checked into git. All team members will have access to it automatically.
Important: Please verify the skill by reviewing its instructions before using it.
Diagnose and resolve common OpenEvidence API errors. Use when encountering error codes, debugging failed requests, or implementing error handling for clinical queries. Trigger with phrases like "openevidence error", "openevidence failing", "fix openevidence", "openevidence debug", "openevidence 4xx", "openevidence 5xx".
0 views
0 installs
Skill Content
---
name: openevidence-common-errors
description: |
Diagnose and fix OpenEvidence common errors.
Trigger: "openevidence error", "fix openevidence", "debug openevidence".
allowed-tools: Read, Grep, Bash(curl:*)
version: 1.0.0
license: MIT
author: Jeremy Longshore <jeremy@intentsolutions.io>
tags: [saas, openevidence, healthcare]
compatible-with: claude-code
---
# OpenEvidence Common Errors
## Overview
Quick reference for OpenEvidence API errors with solutions.
### 401 — Authentication Failed
**Fix:** Verify API key at OpenEvidence developer portal.
### 403 — Organization Access Denied
**Fix:** Verify org ID and API key permissions.
### 422 — Invalid Query
**Fix:** Clinical question must be medical in nature.
### 429 — Rate Limited
**Fix:** Implement backoff. Check `Retry-After` header.
### 503 — Service Unavailable
**Fix:** DeepConsult queue may be full. Retry after delay.
## Quick Diagnostic
```bash
# Check API connectivity
curl -s -w "\nHTTP %{http_code}" https://api.openevidence.com/v1/health 2>/dev/null || echo "Endpoint check needed"
echo $OPENEVIDENCE_API_KEY | head -c 10
```
## Resources
- [OpenEvidence Docs](https://www.openevidence.com)
## Next Steps
See `openevidence-debug-bundle`.