MCP Tools Reference

Auto-generated by scripts/generate-docs-api.mjs from packages/scholar-mcp/src/mcp/create-scholar-mcp-server.ts.

Total tools: 10.

build_reference_list

Generate CSL-formatted bibliography and BibTeX entries from manuscript context or explicit works.

• Title: Build Reference List
• Annotations: {"readOnlyHint":true,"openWorldHint":true}

Parameter	Type	Required	Default	Description
style	enum (apa, ieee, chicago, vancouver)	Yes	’apa’	-
locale	string	Yes	’en-US’	-
manuscript_text	string	No	-	-
works	array	No	-	-

extract_granular_paper_details

Extract claims, methods, limitations, datasets, metrics, and section-aware summaries from a parsed document.

• Title: Extract Granular Paper Details
• Annotations: {"readOnlyHint":true,"openWorldHint":false}

Parameter	Type	Required	Default	Description
document_id	string	Yes	-	-
sections	array	No	-	-
include_references	boolean	Yes	true	-

get_author_info

Retrieve a Google Scholar author profile and top publications by author name.

• Title: Get Author Info
• Annotations: {"readOnlyHint":true,"openWorldHint":true}

Parameter	Type	Required	Default	Description
author_name	string	Yes	-	Full author name to resolve in Google Scholar
max_publications	number	Yes	5	-
language	string	Yes	config.scholarLanguage	-

get_ingestion_status

Get the status of a previously started ingest_paper_fulltext job.

• Title: Get Full-Text Ingestion Status
• Annotations: {"readOnlyHint":true,"openWorldHint":false}

Parameter	Type	Required	Default	Description
job_id	string	Yes	-	Ingestion job id returned by ingest_paper_fulltext.

ingest_paper_fulltext

Resolve and ingest a full-text PDF from DOI/URL/local file, then parse into a structured document using GROBID/simple fallback pipeline.

• Title: Ingest Full-Text Paper
• Annotations: {"readOnlyHint":false,"openWorldHint":true}

Parameter	Type	Required	Default	Description
doi	string	No	-	DOI (recommended for OA PDF discovery).
paper_url	string	No	-	Landing page URL for the paper.
pdf_url	string	No	-	Direct PDF URL.
local_pdf_path	string	No	-	Local absolute or workspace-relative PDF path.
parse_mode	enum (auto, grobid, simple)	Yes	’auto’	-
ocr_enabled	boolean	Yes	true	Reserved for OCR-capable parser modes.

search_google_scholar_advanced

Search Google Scholar using keyword, author, year-range, phrase, and exclusion filters.

• Title: Search Google Scholar with Advanced Filters
• Annotations: {"readOnlyHint":true,"openWorldHint":true}

Parameter	Type	Required	Default	Description
query	string	Yes	-	General search query
author	string	No	-	Author filter value
year_range	number	No	-	Year range as [start, end] or { start, end }
exact_phrase	string	No	-	Exact phrase that must appear in results
exclude_words	string	No	-	Words that should be excluded from results
title_only	boolean	Yes	false	Restrict search terms to title only
num_results	number	Yes	5	-
start	number	Yes	0	-
language	string	Yes	config.scholarLanguage	-

search_google_scholar_key_words

Search Google Scholar using keywords and return paper metadata.

• Title: Search Google Scholar by Keywords
• Annotations: {"readOnlyHint":true,"openWorldHint":true}

Parameter	Type	Required	Default	Description
query	string	Yes	-	Search query string
num_results	number	Yes	5	Number of results to return
start	number	Yes	0	Offset for pagination (0, 10, 20, …)
language	string	Yes	config.scholarLanguage	Google Scholar language code (e.g., en)

search_literature_graph

Search multiple scholarly metadata providers (OpenAlex, Crossref, Semantic Scholar, optional Scholar scrape) and return canonicalized paper records.

• Title: Search Federated Literature Graph
• Annotations: {"readOnlyHint":true,"openWorldHint":true}

Parameter	Type	Required	Default	Description
query	string	Yes	-	Research query string.
year_range	number	No	-	Optional publication year range as [start, end] or {start, end}.
fields_of_study	array	No	-	Optional field-of-study filters.
limit	number	Yes	10	Maximum number of merged results.
sources	enum (openalex, crossref, semantic_scholar, scholar_scrape)	No	-	Optional source allow-list.

suggest_contextual_citations

Recommend citations from the federated literature graph based on manuscript context.

• Title: Suggest Context-Aware Citations
• Annotations: {"readOnlyHint":true,"openWorldHint":true}

Parameter	Type	Required	Default	Description
manuscript_text	string	Yes	-	-
cursor_context	string	No	-	-
style	enum (apa, ieee, chicago, vancouver)	Yes	’apa’	-
k	number	Yes	10	-
recency_bias	number	Yes	0.5	-

validate_manuscript_citations

Validate inline citations against reference entries and detect missing or uncited references.

• Title: Validate Manuscript Citations
• Annotations: {"readOnlyHint":true,"openWorldHint":false}

Parameter	Type	Required	Default	Description
manuscript_text	string	Yes	-	-
style	enum (apa, ieee, chicago, vancouver)	No	-	-
references	array	No	-	-