Skip to main content
Glama
Usama1002

Research Buddy MCP Server

by Usama1002

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SEMANTIC_SCHOLAR_API_KEYNoOptional API key for higher rate limits. Get a free key at https://www.semanticscholar.org/product/api

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_papersA

Search for academic papers by query with advanced filters.

  • query: Keyword or natural language query.

  • limit: Number of results (default 10, max 100).

  • year: Year range (e.g. '2020-2024') or specific year.

  • fields_of_study: Comma-separated fields (e.g. 'Computer Science,Medicine'). Options: Computer Science, Medicine, Chemistry, Biology, Materials Science, Physics, Geology, Psychology, Art, History, Geography, Sociology, Business, Political Science, Economics, Philosophy, Mathematics, Engineering, Environmental Science, Agricultural and Food Sciences, Education, Law, Linguistics.

  • publication_types: Comma-separated types (e.g. 'JournalArticle,Conference'). Options: Review, JournalArticle, CaseReport, ClinicalTrial, Conference, Dataset, Editorial, LettersAndComments, MetaAnalysis, News, Study, Book, BookSection.

  • open_access_pdf: If True, only return papers with a public PDF.

  • min_citation_count: Minimum number of citations (e.g. 50).

  • venue: Comma-separated venue names or ISO4 abbreviations (e.g. 'Nature,Science').

  • publication_date_or_year: Date range in YYYY-MM-DD:YYYY-MM-DD format (e.g. '2023-01-01:2024-06-30').

  • offset: Pagination offset (default 0).

bulk_search_papersA

Comprehensive paper search with boolean queries, sorting, and pagination through up to 10 million results. Use for systematic literature reviews.

  • query: Boolean query string. Supports: + (AND), | (OR), - (NOT), "exact phrase",

    • (wildcard), ~N (fuzzy match), parentheses for grouping. Example: '+"large language model" +hallucination -survey'

  • limit: Results per page (default 100, max 1000).

  • sort: Sort order. Options: 'citationCount:desc', 'citationCount:asc', 'publicationDate:desc', 'publicationDate:asc', 'paperId' (for stable pagination).

  • year: Year or range (e.g. '2023' or '2020-2024').

  • fields_of_study: Comma-separated (e.g. 'Computer Science').

  • publication_types: Comma-separated (e.g. 'JournalArticle,Conference').

  • open_access_pdf: If True, only papers with a public PDF.

  • min_citation_count: Minimum citations.

  • venue: Comma-separated venue names.

  • publication_date_or_year: Date range (e.g. '2023-01-01:2024-06-30').

  • token: Continuation token from previous result for pagination.

search_paper_snippetsA

Search within the full text of papers, not just titles/abstracts. Returns ~500-word text excerpts from papers matching the query, with the section where the match was found (e.g. Introduction, Methods).

  • query: Text to search for within papers (e.g. 'chain-of-thought prompting improves reasoning').

  • limit: Number of results (default 10).

  • fields_of_study: Filter by discipline (e.g. 'Computer Science').

  • min_citation_count: Minimum citations for matched papers.

  • year: Year or range (e.g. '2023' or '2020-2024').

  • venue: Filter by venue (e.g. 'NeurIPS').

match_paper_by_titleA

Find the best-matching paper for a given title string. Useful for resolving plain-text references like 'Attention Is All You Need' to a Semantic Scholar paper ID. Returns the top match with a confidence score.

  • query: The paper title to match (e.g. 'Attention Is All You Need').

get_paper_detailsB

Get full metadata for a specific paper.

  • paper_id: Semantic Scholar ID, DOI, arXiv ID, etc.

get_related_papersA

Get AI-driven paper recommendations based on seed papers.

  • paper_ids: List of paper IDs to base recommendations on (e.g. ['paperid1', 'paperid2']). Can be a single paper or multiple for more refined results.

  • negative_paper_ids: Optional list of paper IDs to use as negative examples. Recommendations will be steered AWAY from these papers. Useful for narrowing a search (e.g. 'find papers like A but not like B').

  • limit: Number of results (default 10).

get_citationsA

Retrieve papers that cited the given paper, with citation context. Returns citation context (the sentence where the paper was cited), intent (methodology, background, result comparison), and whether it's influential.

  • paper_id: The paper ID.

  • limit: Max results (default 20).

  • offset: Pagination offset (default 0).

  • influential_only: If True, only return influential citations.

get_referencesB

Retrieve papers that this paper references, with citation context. Returns citation context (how the reference was used), intent (methodology, background, result comparison), and whether it's influential.

  • paper_id: The paper ID.

  • limit: Max results (default 20).

  • offset: Pagination offset (default 0).

  • influential_only: If True, only return influential references.

search_authorsB

Search for authors by name.

  • query: Author name to search for (e.g. 'Yoshua Bengio').

  • limit: Number of results (default 10).

  • offset: Pagination offset (default 0).

get_author_detailsC

Get author profile and their papers.

  • author_id: Semantic Scholar Author ID.

get_paper_bibtexB

Get the BibTeX citation for a paper.

  • paper_id: The paper ID.

get_paper_citationB

Get a formatted citation for a paper in a specific style.

  • paper_id: The paper ID.

  • style: Citation style. Options: 'apa' (default), 'mla', 'chicago', 'ieee', 'bibtex'.

batch_get_papersC

Retrieve details for multiple papers at once.

  • paper_ids: List of paper IDs.

find_common_citationsA

Find papers that appear in the citation graph of ALL given papers. Reveals the 'intersection' of two or more research threads — papers that bridge multiple topics or are foundational to both.

  • paper_ids: List of 2+ paper IDs to intersect (e.g. ['id1', 'id2']).

  • direction: 'citations' to find papers that cite ALL given papers, 'references' to find papers referenced BY ALL given papers.

read_pdf_textA

Download and extract text from an open-access PDF.

  • url: Direct URL to the PDF.

  • max_chars: Max characters to extract (default 10000).

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 15 tools

Disambiguation4/5

Most tools have clearly distinct purposes, but there is some overlap: get_paper_bibtex and get_paper_citation (which supports a bibtex style) both retrieve BibTeX output, and search_papers vs bulk_search_papers both perform paper search although bulk supports boolean/systematic queries. These are mostly differentiated in descriptions, but the duplication can still cause hesitation.

Naming Consistency4/5

Names mostly follow a snake_case verb_noun pattern (search_papers, get_paper_details, get_citations). Minor deviations include batch_get_papers (verb position) and match_paper_by_title (prepositional phrase), plus get_paper_bibtex vs get_paper_citation being format-specific rather than action-consistent, but the set remains readable.

Tool Count5/5

15 tools is at the high end of the typical 3-15 range but each tool earns its place for a research-paper assistant: search, bulk search, snippets, metadata, citations, references, authors, formatting, and PDF extraction. The scope is broad but coherent and not padded with redundant operations.

Completeness5/5

The surface covers the full research lifecycle: paper search (basic, bulk, full-text snippets), paper identification and metadata, citation graph traversal (citations, references, common citations), author lookup, related-paper recommendation, BibTeX/formatted citation output, batch retrieval, and open-access PDF text extraction. No obvious dead ends for academic literature exploration and citation management.

Maintenance

ActivityInactive
ResponsivenessNo issues