ssrn-mcp
Formats public SSRN abstract-page links from user-supplied abstract IDs for manual browsing. It does not query SSRN, verify links, scrape content, or download papers.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ssrn-mcp Search OpenAlex for recent papers on factor momentum and list their DOIs"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ssrn-mcp
An unofficial local MCP server for scholarly bibliography from OpenAlex and Crossref, SSRN links for manual browsing, and a quant-research checklist from your own authorized notes. The Python package is quant-paper-mcp; both ssrn-mcp and quant-paper-mcp start the server.
한국어 · Rights and access policy · Contributing
This project is not affiliated with or endorsed by SSRN, Elsevier, OpenAlex, or Crossref. It uses no SSRN/Elsevier logo.
Scope
Search official OpenAlex/Crossref metadata APIs and look up a DOI.
Return titles, authors, years, DOI/provider identifiers, citation/OA indicators where available, and manual landing-page links.
Format an SSRN public abstract-page link from an ID you supply, without visiting or verifying it.
Create a research checklist from user-authored notes or notes with separate, verified permission for the intended AI use. This tool returns the supplied notes locally; it does not retrieve a paper.
Make no requests to SSRN or Elsevier. There is no SSRN search, scraper, login, PDF download, bulk harvest, or automatic paper-text analysis.
Exclude abstracts and full text from provider-derived tool outputs. Upstream API responses may include additional fields; parsers discard unexposed fields.
The official SSRN Terms of Use prohibit automated queries to SSRN and limit content reuse, including certain AI uses. Reviewed on 2026-10-25; the page footer displayed “Last updated June 2017.” This server adopts the narrower scope above. It does not establish permission for every downstream use of metadata, notes, or linked papers. See RIGHTS.md for relevant sections and implementation limits.
Related MCP server: ares-mcp
Install
Requires Python 3.11+, internet access to the metadata providers, and a local MCP client.
git clone https://github.com/seungtaeio/ssrn-mcp.git
cd ssrn-mcp
python -m venv .venv
source .venv/bin/activate
python -m pip install -e .On Windows, activate with .venv\Scripts\activate.
Provider settings:
OPENALEX_API_KEY— optional. OpenAlex permits basic anonymous queries; a free key raises the available budget. See OpenAlex authentication.CROSSREF_EMAIL— recommended contact email for Crossref's polite pool. See Crossref metadata access.
Pass settings in the MCP server process environment, as in the example below. .env.example lists the variables; the server does not automatically load .env files. Never commit credentials.
Connect an MCP client
For a client that accepts an mcpServers configuration:
{
"mcpServers": {
"ssrn-mcp": {
"command": "/ABSOLUTE/PATH/TO/ssrn-mcp/.venv/bin/ssrn-mcp",
"env": {
"OPENALEX_API_KEY": "",
"CROSSREF_EMAIL": "you@example.edu"
}
}
}
}Replace the absolute executable path and email. Add an OpenAlex key if desired, or leave it empty. On Windows, use the executable under .venv\Scripts. Restart the client after updating its configuration.
The executable uses stdio and waits for an MCP client on standard input. It does not open a network port or show an interactive prompt.
Tools
search_papers(query, source, limit)— searchopenalexorcrossref; at most 20 results.get_paper_by_doi(doi, source)— retrieve one paper's bibliography.find_open_access_link(doi)— return an OpenAlex landing-page link/OA indication; no download.get_ssrn_reference_link(abstract_id)— format a manual SSRN link; no request.make_quant_research_checklist(paper_title, original_user_notes)— return checklist questions alongside your own or expressly licensed notes.source_and_rights_policy()— inspect the access restrictions.
Example requests:
Search Crossref for five papers about earnings announcement drift and return their titles and DOI links.
Look up DOI 10.2139/ssrn.1234567 through Crossref. If the external index has no record, report that without visiting SSRN.
Format an SSRN reference link for abstract ID 1234567 without visiting it.
The DOI above illustrates the SSRN DOI pattern; a corresponding record is not guaranteed. Coverage of SSRN papers depends on the external indexes. A DOI, public link, or OA flag does not grant automated access, redistribution, or AI-use rights. This project does not provide market data, backtesting, or trade execution.
Development
python -m pip install -e '.[dev]'
pytest -qTests use mocked HTTP transports. See CONTRIBUTING.md.
License
MIT covers the original source code. Third-party metadata, papers, names, and linked materials retain their own rights and terms.
Available Tools
6 toolsfind_open_access_linkB
Find an OpenAlex OA landing-page link only; never retrieve the paper itself.
A reported OA status / link does NOT automatically grant AI-processing or redistribution permission. Check the source license before accessing text.
Inputs: doi (required).
get_paper_by_doiC
Look up one DOI using official OpenAlex or Crossref metadata APIs.
Inputs: doi (required), source.
get_ssrn_reference_linkA
Generate SSRN's public abstract-page link from an ID the user supplies.
Does not verify, browse, scrape, search, download or process SSRN data.
Inputs: abstract_id (required).
make_quant_research_checklistB
Create a quant-paper review template from the user's OWN notes only.
Never paste SSRN/Elsevier text unless your separate license or permissions expressly allow the AI use. No paper or remote URL is fetched by this tool.
Inputs: paper_title (required), original_user_notes.
search_papersA
Search OpenAlex or Crossref research metadata; never search SSRN directly.
Results contain only bibliographic metadata and manual landing-page links. Dedicated abstract, full-text, attachment and PDF fields are omitted. Provider landing links are unverified and are never followed by this server.
Inputs: query (required), limit, source.
source_and_rights_policyB
Return the project's hard-coded SSRN/Elsevier access safeguards.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
The tools split cleanly into metadata search, DOI lookup, SSRN reference-link construction, OA-link discovery, checklist creation, and policy retrieval. The only mild overlap is between the two link-oriented tools, but their inputs and outputs differ enough for an agent to choose correctly.
Five tools follow a readable verb_noun pattern such as get_ssrn_reference_link, search_papers, get_paper_by_doi, find_open_access_link, and make_quant_research_checklist. source_and_rights_policy is a noun phrase and breaks the pattern slightly, but the overall convention remains clear.
Six tools is well within the appropriate range for a focused metadata/reference-safety server. Each tool maps to a distinct capability, and there is no obvious bloat.
The surface covers search, DOI lookup, SSRN reference links, OA link discovery, checklist creation, and rights policy, which is solid for the stated constrained purpose. Minor gaps remain, such as citation export/formatting or per-paper license lookup, but the deliberate limitations are documented and workable.
Related MCP Connectors
Search arXiv/Semantic Scholar/OpenAlex + medical evidence (PubMed/Europe PMC) + LaTeX/PDF tools.
Academic literature search, retrieval, and private library management on top of OpenAlex.
Check AI references against Crossref and DataCite. DOI/arXiv metadata checks, plus tool discovery.
Checks AI-written references against Crossref, PubMed and OpenAlex. Formats citations, PRISMA.
Related MCP Servers
- AlicenseBqualityBmaintenanceAI-operable research workspace integrating Zotero, Obsidian, and NotebookLM. Search papers (arXiv/Semantic Scholar/PubMed/CrossRef), ingest into Zotero, sync per-paper notes to Obsidian, verify NotebookLM briefs. All three external tools optional.76117 PyPI68MIT
- AlicenseAqualityCmaintenanceProvides local academic literature search and writing support by querying OpenAlex, arXiv, and Crossref, downloading open-access PDFs, extracting IMRaD sections, and appending BibTeX references.42MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to verify bibliographic existence and metadata consistency, convert DOI/PMID/PMCID/arXiv identifiers to BibTeX, and check .bib files against multiple sources without destructive edits.-
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to verify bibliographic existence and metadata consistency, query DOI/PMID/PMCID/arXiv records, and review explainable multi-source matches without destructive edits to source files.-