essencescholar-mcp 0.5.0

MCP server exposing EssenceScholar deep research and paper workflows as agent tools

EssenceScholar MCP Server

MCP server exposing the EssenceScholar deep research pipeline and paper workflows as agent tools.

Tools

Research pipeline

• deep_research — full literature review pipeline (2–8 min, searches EconPapers/arXiv/SSRN, enriches top papers, generates a structured draft)
• deep_research_chat — follow-up on an existing session (ask questions, expand, dig deeper)
• list_deep_researches — list all past research sessions
• get_deep_research — retrieve any past draft by ID

Search & library

• search_econpapers — raw EconPapers search, returns JSON paper objects
• search_ssrn — raw SSRN search, returns JSON paper objects
• download_paper — download a found paper (EconPapers/SSRN/arXiv/DOI URL) into your library and get its paper_id
• upload_paper — upload a local PDF into your library and get its paper_id
• list_user_papers — list papers in your library (resolve paper_ids; optional title filter)

Workflows

• list_paper_workflows — list available Agent Studio workflows (custom wf_* and system wf_sys_* pipelines)
• run_paper_workflow — run a workflow (by ID) on a paper in your library (server-executed)
• run_workflow_on_pdf — upload a local PDF and run a workflow on it in one call
• get_workflow_definition — fetch a workflow's raw declarative DAG (steps/prompts/deps) as JSON
• compile_workflow_skill — convert a workflow into a portable skill (target=claude|codex|gemini) your own agent runs, instead of executing it server-side

Typical flow: search_econpapers / search_ssrn → download_paper → run_paper_workflow. Or, to reuse a workflow as an agent skill: list_paper_workflows → compile_workflow_skill → save the returned SKILL.md.

Setup

Add to your Claude config (~/.claude/settings.json):

{
  "mcpServers": {
    "essencescholar": {
      "command": "uvx",
      "args": ["essencescholar-mcp"],
      "env": {
        "ESSENCESCHOLAR_API_KEY": "sk_live_..."
      }
    }
  }
}

Get your API key from essencescholar.com.