semantic_scholar_paper_details

Retrieve detailed academic paper information from Semantic Scholar using paper IDs or DOIs to support research and analysis.

Instructions

Get detailed information about a specific paper from Semantic Scholar

Input Schema

TableJSON Schema

Name	Required	Description	Default
`paperId`	Yes	Semantic Scholar paper ID or DOI

Implementation Reference

src/tools/academic/semantic-scholar-tools.ts:209-253 (handler)

The execute handler for the semantic_scholar_paper_details tool. Fetches detailed paper information using SemanticScholarAPIClient.getPaperDetails(paperId), formats the response including metadata, authors, limited references and citations, and handles errors.

execute: async (args: any) => {
  const { paperId } = args;

  try {
    const paper = await client.getPaperDetails(paperId);
    
    const paperDetails = {
      paperId: paper.paperId,
      title: paper.title,
      abstract: paper.abstract || 'No abstract available',
      authors: (paper.authors || []).map((author: any) => ({
        name: author.name,
        authorId: author.authorId
      })),
      venue: paper.venue || 'Unknown venue',
      year: paper.year,
      citationCount: paper.citationCount || 0,
      url: paper.url || `https://www.semanticscholar.org/paper/${paper.paperId}`,
      publicationDate: paper.publicationDate,
      references: (paper.references || []).slice(0, 10).map((ref: any) => ({
        title: ref.title,
        paperId: ref.paperId
      })),
      citations: (paper.citations || []).slice(0, 10).map((cite: any) => ({
        title: cite.title,
        paperId: cite.paperId
      })),
      source: 'Semantic Scholar'
    };

    return {
      success: true,
      data: {
        source: 'Semantic Scholar',
        paper: paperDetails,
        timestamp: Date.now()
      }
    };
  } catch (error) {
    return {
      success: false,
      error: error instanceof Error ? error.message : 'Failed to get paper details from Semantic Scholar'
    };
  }
}

src/tools/academic/semantic-scholar-tools.ts:199-208 (schema)

Input schema for the tool, requiring a 'paperId' string (Semantic Scholar paper ID or DOI).

inputSchema: {
  type: 'object',
  properties: {
    paperId: {
      type: 'string',
      description: 'Semantic Scholar paper ID or DOI'
    }
  },
  required: ['paperId']
},

src/tools/academic/semantic-scholar-tools.ts:194-198 (registration)

Registration of the semantic_scholar_paper_details tool in the ToolRegistry, including name, description, category, and source.

registry.registerTool({
  name: 'semantic_scholar_paper_details',
  description: 'Get detailed information about a specific paper from Semantic Scholar',
  category: 'academic',
  source: 'Semantic Scholar',

src/tools/academic/semantic-scholar-tools.ts:96-100 (helper)

Helper method in SemanticScholarAPIClient class that performs the API request to retrieve detailed paper information, specifying required fields.

  async getPaperDetails(paperId: string) {
    const fields = 'paperId,title,abstract,authors,venue,year,citationCount,url,publicationDate,references,citations';
    return await this.makeRequest(`/paper/${paperId}`, { fields });
  }
}

src/index.ts:232-232 (registration)
Top-level registration call in OpenSearchMCPServer.registerAllTools() that invokes registerSemanticScholarTools, which registers semantic_scholar_paper_details among others.
```
registerSemanticScholarTools(this.toolRegistry);    // 1 tool: search_semantic_scholar
```

Open Search MCP