1. Conduid
  2. Blockchain
  3. Openevidence MCP
MCP server · Blockchain

Openevidence MCP

· github.com/bakhtiersizhaev/openevidence-mcp

Unofficial OpenEvidence MCP server with cookies.json auth, Claude/Codex/Gemini install helpers, BibTeX citation export, and Crossref validation.

Unclaimed bibtexclaude-codecodex-clicrossrefgemini-climcpmedical-aiopenevidence
InstallView source
39Low

Scored 6 months ago · breakdown

About Openevidence MCP

Openevidence MCP is an MCP server in the Blockchain category: unofficial OpenEvidence MCP server with cookies.json auth, Claude/Codex/Gemini install helpers, BibTeX citation export, and Crossref validation.

Install

From source
git clone https://github.com/bakhtiersizhaev/openevidence-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (5)

oe_article_getFetches an article by ID and returns normalized fields (`status`, `is_complete`, `question`, `answer_text`). Raw payload is opt-in with `include_raw=true`.

Parameters not published.

oe_article_waitWaits for an existing article ID to complete; useful after non-blocking `oe_ask`.

Parameters not published.

oe_askCreates an OpenEvidence research question and optionally waits for the article to complete.

Parameters not published.

oe_auth_statusChecks whether the saved OpenEvidence browser session is authenticated.

Parameters not published.

oe_history_listLists prior OpenEvidence articles with optional pagination and search. Returns a privacy-reduced list unless `include_raw=true` is explicitly requested.

Parameters not published.

Ask AI

✦

Ask AI about Openevidence MCP

Powered by Claude · Grounded in docs

I know everything about Openevidence MCP. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

What Is OpenEvidence MCP

OpenEvidence MCP is an unofficial Model Context Protocol server that uses your own OpenEvidence browser session. No official OpenEvidence API token is required.

This is usually used by:

  • physicians
  • clinical teams
  • medical researchers
  • AI operators building evidence-based medical workflows

Feature Surface

Tool Purpose
oe_auth_status Check auth via /api/auth/me
oe_history_list Read history via /api/article/list
oe_article_get Fetch full article payload by id
oe_ask Ask a question and optionally wait for completion
npm run login Run local login flow and save reusable session state

Platform Support

  • macOS
  • Windows
  • Ubuntu/Linux

Requirements

  • Node.js 20+
  • npm 10+
  • OpenEvidence account

Quick Start

macOS

cd /path/to/openevidence-mcp
./scripts/setup-macos.sh
npm run login
npm run smoke

Ubuntu/Linux

cd /path/to/openevidence-mcp
./scripts/setup-ubuntu.sh
npm run login
npm run smoke

Windows (PowerShell)

cd C:\path\to\openevidence-mcp
.\scripts\setup-windows.ps1
npm run login
npm run smoke

Login Flow

Run:

npm run login

Browser opens, user signs in, then presses Enter in terminal. The tool validates /api/auth/me and saves local state.

Import existing state:

npm run login -- --import /absolute/path/storage-state.json

Default state path:

  • macOS/Linux: ~/.openevidence-mcp/auth/storage-state.json
  • Windows: %USERPROFILE%\\.openevidence-mcp\\auth\\storage-state.json

MCP Setup

Codex (~/.codex/config.toml)

[mcp_servers.openevidence]
command = "node"
args = ["/ABSOLUTE/PATH/openevidence-mcp/dist/server.js"]
startup_timeout_sec = 60

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "openevidence": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/openevidence-mcp/dist/server.js"]
    }
  }
}

Templates:

  • examples/codex-config.toml
  • examples/codex-config-full.toml
  • examples/claude-desktop-config.json
  • examples/claude-desktop-config-full.json

Verify

npm run smoke

Expected:

  • ok: true
  • authenticated: true
  • history results returned

Session Notes

  • Cookie/session lifetime can vary.
  • If auth fails, run npm run login again.

AI-Agent Install Guide

Use README.AI.md when setup is performed by Codex, Claude Code, or another AI agent.

SEO / GEO / AI Parser Files

  • docs/index.html
  • docs/i18n/ru/index.html
  • docs/i18n/es/index.html
  • docs/i18n/zh/index.html
  • docs/i18n/hi/index.html
  • docs/SEMANTIC_CORE.md
  • docs/robots.txt
  • docs/sitemap.xml
  • docs/llms.txt
  • docs/llms-full.txt

Environment Variables

Copy .env.example to .env if custom paths are needed.

  • OE_MCP_BASE_URL
  • OE_MCP_ROOT_DIR
  • OE_MCP_AUTH_STATE_PATH
  • OE_MCP_USER_DATA_DIR
  • OE_MCP_POLL_INTERVAL_MS
  • OE_MCP_POLL_TIMEOUT_MS

License

Apache-2.0 (LICENSE) + NOTICE.

Attribution Requirement

This repository uses Apache-2.0 with a NOTICE file.

If you redistribute, fork, or build derivative versions, keep attribution to:

  • Original author: Bakhtier Sizhaev
  • Original repository: https://github.com/bakhtiersizhaev/openevidence-mcp

In practice:

  • do not remove LICENSE
  • do not remove NOTICE

Suggested attribution line: Based on OpenEvidence MCP by Bakhtier Sizhaev — https://github.com/bakhtiersizhaev/openevidence-mcp

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About Openevidence MCP

How do I install Openevidence MCP?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Openevidence MCP safe to use with an AI agent?

Its trust score is 39 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Openevidence MCP still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.