Auto-generated by
scripts/generate-docs-api.mjsfrompackages/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) | No | ‘apa’ | - |
locale |
string | No | ‘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 | No | 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 | No | 5 | - |
language |
string | No | 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) | No | ‘auto’ | - |
ocr_enabled |
boolean | No | 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 |
object | No | - | Year range as { 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 | No | false | Restrict search terms to title only |
num_results |
number | No | 5 | - |
start |
number | No | 0 | - |
language |
string | No | 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 | No | 5 | Number of results to return |
start |
number | No | 0 | Offset for pagination (0, 10, 20, …) |
language |
string | No | 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 |
object | No | - | Optional publication year range as {start, end}. |
fields_of_study |
array | No | - | Optional field-of-study filters. |
limit |
number | No | 10 | Maximum number of merged results. |
sources |
array | 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) | No | ‘apa’ | - |
k |
number | No | 10 | - |
recency_bias |
number | No | 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 | - | - |