openevidence
Installation
SKILL.md
OpenEvidence (portable)
A stdlib-only Python port of openevidence-mcp. One CLI (scripts/oe.py) with four subcommands matching the MCP tools.
| MCP tool | Skill command | Purpose |
|---|---|---|
oe_auth_status |
python3 scripts/oe.py auth-status |
Confirm cookies.json still authenticates /api/auth/me |
oe_history_list |
python3 scripts/oe.py history |
Paginated question history with optional search |
oe_article_get |
python3 scripts/oe.py article <uuid> |
Fetch an article, extract answer + figures, save artifacts |
oe_ask |
python3 scripts/oe.py ask "<question>" |
Submit a new question, optionally wait, save artifacts |
Output of every command is a single JSON object on stdout - same shape the MCP returns to its client.
Setup (one time)
- Cookies. Export the OpenEvidence cookies from a logged-in browser tab (e.g. "Cookie-Editor" extension → "Export → JSON"). Save as
cookies.jsonnext to thisSKILL.md. The format is either a flat array of cookie objects or{ "cookies": [...] }(Playwright storage state). The file is gitignored. - Verify.
python3 scripts/oe.py auth-statusshould print"authenticated": true. Status401/403means the cookies expired - re-export.
Cookie lookup order: $OE_COOKIES, ./cookies.json, the skill folder, ~/.openevidence/cookies.json.