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) | 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 | - | - |