Science
Data source: Semantic Scholar API
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/semantic-scholar/
claude_desktop_config.json
{
"mcpServers": {
"gnist-semantic-scholar": {
"url": "https://context.gnist.ai/mcp/semantic-scholar/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/semantic-scholar/" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "Gnist-API-Key: YOUR_API_KEY" \
-d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "search_papers", "arguments": {"query": "example"}}}'
REST API
API Root
https://context.gnist.ai/rest/semantic-scholar/
8 endpoints available:
GET /rest/semantic-scholar/search_papersGET /rest/semantic-scholar/get_paperGET /rest/semantic-scholar/get_citationsGET /rest/semantic-scholar/get_referencesGET /rest/semantic-scholar/search_authorsGET /rest/semantic-scholar/get_authorGET /rest/semantic-scholar/recommend_papersGET /rest/semantic-scholar/report_feedback
Shell
curl "https://context.gnist.ai/rest/semantic-scholar/search_papers?query=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/semantic-scholar/search_papers",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"query": "example"
},
)
print(resp.json())
Command Line
Command
gc semantic-scholar
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (8)
search_papersSearch 200M+ academic papers in Semantic Scholar.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search query for academic papers (e.g. "transformer attention mechanism", "CRISPR gene editing", "climate change mitigation"). |
limit | integer | optional | Number of results to return (1-100, default 10). (default: 10) |
offset | integer | optional | Pagination offset for additional results (default 0). (default: 0) |
year | any | optional | Year filter — single year ("2023"), range ("2020-2023"), or open range ("2020-"). |
fields_of_study | any | optional | Filter by academic field (e.g. ["Computer Science"], ["Medicine", "Biology"]). |
get_paperGet detailed information about a specific academic paper.
| Parameter | Type | Required | Description |
|---|---|---|---|
paper_id | string | required | Paper identifier — S2 ID (40-char hex), DOI (e.g. "10.1038/s41586-021-03819-2"), ArXiv ID (e.g. "2301.12345"), or prefixed ID (e.g. "PMID:12345", "CorpusId:12345"). |
get_citationsGet papers that cite a given paper.
| Parameter | Type | Required | Description |
|---|---|---|---|
paper_id | string | required | Paper identifier (S2 ID, DOI, ArXiv ID, or prefixed ID). |
limit | integer | optional | Number of citing papers to return (1-100, default 20). (default: 20) |
offset | integer | optional | Pagination offset (default 0). (default: 0) |
get_referencesGet papers referenced by a given paper.
| Parameter | Type | Required | Description |
|---|---|---|---|
paper_id | string | required | Paper identifier (S2 ID, DOI, ArXiv ID, or prefixed ID). |
limit | integer | optional | Number of referenced papers to return (1-100, default 20). (default: 20) |
offset | integer | optional | Pagination offset (default 0). (default: 0) |
search_authorsSearch for academic authors by name.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Author name to search for (e.g. "Yann LeCun", "Geoffrey Hinton"). |
limit | integer | optional | Number of results to return (1-100, default 10). (default: 10) |
get_authorGet an author's profile by Semantic Scholar author ID.
| Parameter | Type | Required | Description |
|---|---|---|---|
author_id | string | required | Semantic Scholar author ID (numeric, e.g. "1688882"). |
recommend_papersGet paper recommendations based on a seed paper.
| Parameter | Type | Required | Description |
|---|---|---|---|
paper_id | string | required | Paper identifier (S2 ID, DOI, ArXiv ID, or prefixed ID) to get recommendations for. |
limit | integer | optional | Number of recommendations (1-100, default 10). (default: 10) |
report_feedbackReport a bug, feature request, or general feedback for this data source.
| Parameter | Type | Required | Description |
|---|---|---|---|
feedback | string | required | |
feedback_type | string | optional | (default: "general") |