{
  "info": {
    "name": "Semantic Scholar — mcp.ai",
    "description": "REST API for the Semantic Scholar MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/semanticscholar",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "semanticscholar_details_about_a_paper",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/details/about/a/paper",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "details",
            "about",
            "a",
            "paper"
          ]
        },
        "description": "Examples: <ul> <li><code>https://api.semanticscholar.org/graph/v1/paper/649def34f8be52c8b66281af98ae884c09aef38b</code></li> <ul> <li>Returns a paper with its paperId and title. </li> </ul> <li><code>",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"fields\": \"\",\n  \"paper_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_details_about_a_paper_s_authors",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/details/about/a/paper/s/authors",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "details",
            "about",
            "a",
            "paper",
            "s",
            "authors"
          ]
        },
        "description": "Retrieves the list of authors for a specific paper identified by its unique paper_id in the Semantic Scholar database. This endpoint returns detailed author information including authorId and name (re",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"fields\": \"\",\n  \"offset\": 0,\n  \"paper_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_details_about_a_paper_s_citations",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/details/about/a/paper/s/citations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "details",
            "about",
            "a",
            "paper",
            "s",
            "citations"
          ]
        },
        "description": "Retrieves a list of citations for a specific academic paper using its unique Semantic Scholar paper ID. This endpoint is useful for researchers and developers who want to explore the impact and connec",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"fields\": \"\",\n  \"offset\": 0,\n  \"paper_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_details_about_a_paper_s_references",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/details/about/a/paper/s/references",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "details",
            "about",
            "a",
            "paper",
            "s",
            "references"
          ]
        },
        "description": "Retrieves the list of references cited by a specific paper in the Semantic Scholar database. This endpoint allows users to explore the scholarly context of a publication by accessing its bibliography.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"fields\": \"\",\n  \"offset\": 0,\n  \"paper_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_details_about_an_author",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/details/about/an/author",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "details",
            "about",
            "an",
            "author"
          ]
        },
        "description": "Retrieve detailed information about an author from Semantic Scholar, including name, affiliations, publication statistics (paperCount, citationCount, h-index), external IDs (ORCID, DBLP), and optional",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"fields\": \"\",\n  \"author_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_details_about_an_author_s_papers",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/details/about/an/author/s/papers",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "details",
            "about",
            "an",
            "author",
            "s",
            "papers"
          ]
        },
        "description": "Retrieves a list of papers authored or co-authored by a specific researcher identified by their unique Semantic Scholar author ID. This endpoint is particularly useful for conducting literature review",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"fields\": \"\",\n  \"offset\": 0,\n  \"author_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_get_dataset",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/dataset",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "dataset"
          ]
        },
        "description": "Tool to get download links for a specific dataset within a release. Use when you need to download Semantic Scholar dataset files from S3. Returns pre-signed URLs for all dataset partitions.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"release_id\": \"\",\n  \"dataset_name\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_get_dataset_diffs",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/dataset/diffs",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "dataset",
            "diffs"
          ]
        },
        "description": "Get download links for incremental diffs between dataset releases. Returns a list of diffs required to update a dataset from start_release to end_release, enabling efficient dataset synchronization. U",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"dataset_name\": \"\",\n  \"end_release_id\": \"\",\n  \"start_release_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_get_details_for_multiple_authors_at_once",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/details/for/multiple/authors/at/once",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "details",
            "for",
            "multiple",
            "authors",
            "at",
            "once"
          ]
        },
        "description": "Retrieves detailed information for multiple authors from Semantic Scholar in a single API call. This endpoint allows users to efficiently fetch data for a batch of authors by providing their unique Se",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ids\": \"\",\n  \"fields\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_get_details_for_multiple_papers_at_once",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/details/for/multiple/papers/at/once",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "details",
            "for",
            "multiple",
            "papers",
            "at",
            "once"
          ]
        },
        "description": "Retrieve detailed information for multiple academic papers in a single API call using the Semantic Scholar paper batch endpoint. This endpoint efficiently fetches data for up to 500 papers at once, si",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"ids\": \"\",\n  \"fields\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_get_paper_recommendations",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/paper/recommendations",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "paper",
            "recommendations"
          ]
        },
        "description": "Tool to get paper recommendations based on positive and negative example papers. Use when you need to find papers similar to ones you like (positive examples) and optionally dissimilar to ones you don",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"fields\": \"\",\n  \"negative_paper_ids\": \"\",\n  \"positive_paper_ids\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_get_recommendations_for_paper",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/recommendations/for/paper",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "recommendations",
            "for",
            "paper"
          ]
        },
        "description": "Tool to get recommended papers for a single positive example paper. Use when you need to find papers similar to a given paper based on Semantic Scholar's recommendation algorithm.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"from\": \"\",\n  \"limit\": 0,\n  \"fields\": \"\",\n  \"paper_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_get_release",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/get/release",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "get",
            "release"
          ]
        },
        "description": "Tool to retrieve metadata for a specific Semantic Scholar dataset release. Returns release information including available datasets with their descriptions. Use when you need to discover what datasets",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"release_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_list_releases",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/list/releases",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "list",
            "releases"
          ]
        },
        "description": "Tool to list all available dataset releases from Semantic Scholar. Use when you need to discover available release dates for downloading datasets.",
        "body": {
          "mode": "raw",
          "raw": "{}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_paper_relevance_search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/paper/relevance/search",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "paper",
            "relevance",
            "search"
          ]
        },
        "description": "DEPRECATED: Use SEMANTICSCHOLAR_SEARCH_PAPERS instead. The SearchPapers endpoint allows users to search for academic papers within the Semantic Scholar database. It provides a powerful way to discover",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"year\": \"\",\n  \"limit\": 0,\n  \"query\": \"\",\n  \"venue\": \"\",\n  \"fields\": \"\",\n  \"offset\": 0,\n  \"fieldsOfStudy\": \"\",\n  \"openAccessPdf\": \"\",\n  \"minCitationCount\": 0,\n  \"publicationTypes\": \"\",\n  \"publicationDateOrYear\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_paper_title_search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/paper/title/search",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "paper",
            "title",
            "search"
          ]
        },
        "description": "Behaves similarly to <code>/paper/search</code>, but is intended for retrieval of a single paper based on closest title match to given query. Examples: <ul> <li><code>https://api.semanticscholar.org/g",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"year\": \"\",\n  \"query\": \"\",\n  \"venue\": \"\",\n  \"fields\": \"\",\n  \"fieldsOfStudy\": \"\",\n  \"openAccessPdf\": \"\",\n  \"minCitationCount\": 0,\n  \"publicationTypes\": \"\",\n  \"publicationDateOrYear\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_search_bulk_papers",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/bulk/papers",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "bulk",
            "papers"
          ]
        },
        "description": "Tool to perform bulk search for academic papers. Intended for bulk retrieval of basic paper data without search relevance scoring. Use when you need to retrieve large sets of papers with optional text",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"sort\": \"\",\n  \"year\": \"\",\n  \"query\": \"\",\n  \"token\": \"\",\n  \"venue\": \"\",\n  \"fields\": \"\",\n  \"fieldsOfStudy\": \"\",\n  \"openAccessPdf\": \"\",\n  \"minCitationCount\": 0,\n  \"publicationTypes\": \"\",\n  \"publicationDateOrYear\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_search_for_authors_by_name",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/for/authors/by/name",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "for",
            "authors",
            "by",
            "name"
          ]
        },
        "description": "Search for academic authors in the Semantic Scholar database by name. This action searches for authors using plain-text name queries. The search is case-insensitive and supports partial name matches (",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"limit\": 0,\n  \"query\": \"\",\n  \"fields\": \"\",\n  \"offset\": 0\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_search_papers",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/search/papers",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "search",
            "papers"
          ]
        },
        "description": "Tool to search for academic papers by relevance in the Semantic Scholar database. Use when searching for papers on specific topics, keywords, or research areas. Returns papers ordered by relevance sco",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"year\": \"\",\n  \"limit\": 0,\n  \"query\": \"\",\n  \"venue\": \"\",\n  \"fields\": \"\",\n  \"offset\": 0,\n  \"fieldsOfStudy\": \"\",\n  \"openAccessPdf\": \"\",\n  \"minCitationCount\": 0,\n  \"publicationTypes\": \"\",\n  \"publicationDateOrYear\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_suggest_paper_query_completions",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/suggest/paper/query/completions",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "suggest",
            "paper",
            "query",
            "completions"
          ]
        },
        "description": "Get autocomplete suggestions for paper queries. Returns a list of papers matching the partial query string, useful for interactive search experiences. Each suggestion includes the paper ID, title, and",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"query\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "semanticscholar_text_snippet_search",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/text/snippet/search",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "text",
            "snippet",
            "search"
          ]
        },
        "description": "Search for text snippets (~500 words) within academic papers that match your natural language query. Returns relevant excerpts from papers' titles, abstracts, and body text, ranked by relevance score.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"year\": \"\",\n  \"limit\": 0,\n  \"query\": \"\",\n  \"venue\": \"\",\n  \"fields\": \"\",\n  \"authors\": \"\",\n  \"paperIds\": \"\",\n  \"fieldsOfStudy\": \"\",\n  \"minCitationCount\": \"\",\n  \"publicationDateOrYear\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}