openevidence-mcp

Name: openevidence-mcp
Author: htlin222

data-ai MCP Server

Unofficial OpenEvidence MCP server — query OpenEvidence from Claude Code, Codex, and any MCP client through your own logged-in browser tab (no API key). Fire-and-forget asks, a shared relay daemon for concurrent sessions, BibTeX + Crossref citations.

byhtlin222

VerifiedFreshInstall Ready

data-aidata-ai

2 views77 stars17 forksv0.4.4Apache-2.0

View on GitHub Homepage Docs

Why This Matters

Discovered via github-topic:mcp and last synced 2d ago.

VerifiedFreshInstall Ready

Source: github-topic:mcp
Stars: 77
Last synced: 2d ago
Install: Instructions detected

Install

1. Install the package

npx openevidence-mcp

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "openevidence-mcp": {
      "command": "npx",
      "args": [
        "openevidence-mcp"
      ]
    }
  }
}

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

Tools

Resources

Prompts

Standard I/O

Transport

Available Tools (48)

Client

Status

Target

Purpose

Tool

Purpose

Cursor

Compatible

oe_article_get

Fetch an article by id or `/ask/` URL (the fetch-later half of `oe_ask`); returns `follow_up_questions`; saves artifacts; `wait_for_completion` to block until ready

Cline

Compatible

Continue

Compatible

Command

Purpose

Experimental

Watchlist/ecosystem target, not a maintained example.

oe_auth_status

Check `/api/auth/me` through the relay (full network round-trip)

oe_history_list

Read your OpenEvidence question history

oe_ask

Ask a question — fire-and-forget by default (returns a pending `article_id`); `wait_for_completion:true` to block; `original_article_id` to follow up in the same thread

oe_collections_list

List your collections

oe_collections_bulk_apply

Mint missing `#`-collections + add memberships per `[{article_id, hashtags}]` plan

OE_MCP_BASE_URL

`https://www.openevidence.com`

oe_collections_get

Get a collection (incl. nested `questions[]` = membership list)

Mode

Behavior

File

Purpose

OE_MCP_CROSSREF_MAILTO

unset

oe_collections_add_article

Add a chat to a collection

OE_MCP_CROSSREF_VALIDATE

`1`

oe_collections_db_init

Create the local SQLite mirror (idempotent)

Variable

Default

oe_collections_sync_history

Pull `/api/article/list` into the local SQLite chats table

OE_MCP_RELAY

`1`

oe_collections_unsorted

Chats with no `#`-collection membership; structured JSON

OE_MCP_RELAY_PORT

`8787`

OE_MCP_FINGERPRINT_PATH

`./openevidence-fingerprint.json` if present

oe_collections_summary

Counts + last sync timestamps

OE_MCP_RELAY_PID_PATH

`~/.openevidence-mcp/relay.pid`

OE_MCP_DB_PATH

`~/.openevidence-mcp/db/oe.sqlite`

oe_collections_classify

Auto-classify unsorted chats using log-odds-ratio signatures learned from your memberships + curated keyword rules

OE_MCP_RELAY_LOG_PATH

`~/.openevidence-mcp/relay.log`

OE_MCP_PYTHON

`python3`

OE_MCP_ARTIFACT_DIR

OS temp dir + `openevidence-mcp`

oe_article_wait

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

oe_public_get

Read a conversation page from an `/ask/<id>` link as Q&A markdown turns — public links need zero setup; private ones use the relay tab or `cookies.json`

oe_article_set_access

Toggle a conversation's share visibility — `public:true` → link-shareable (`ANYONE_WITH_LINK`), `public:false` → private (`CREATOR_ONLY`); returns the `/ask/<id>` URL (you must own it; relay required)

oe_answers_search

Full-text search (SQLite FTS5) over every answer this MCP has fetched — offline, zero rate-limit cost; returns highlighted snippets

oe_health

Millisecond-fast local check of the relay pipeline (daemon + extension) — no network call, unlike `oe_auth_status`

oe_collections_create

Create a collection (agent-managed names should start with `#`)

OE_MCP_ASK_MIN_INTERVAL_MS

`1000`

oe_collections_sync_db

Refresh collections + memberships into SQLite

OE_MCP_RELAY_TRANSPORT

`all`

OE_MCP_POLL_TIMEOUT_MS

`180000`

OE_MCP_LEGACY_ACCOUNT

`legacy`

OE_MCP_POLL_INTERVAL_MS

`1200`

OE_MCP_COOKIES_PATH

`./cookies.json` if present, else `~/.openevidence-mcp/auth/cookies.json`

Browse all MCP servers