Science
Data source: OpenAlex
MCP Protocol
Endpoint
https://context.gnist.ai/mcp/openalex/
claude_desktop_config.json
{
"mcpServers": {
"gnist-openalex": {
"url": "https://context.gnist.ai/mcp/openalex/",
"headers": {
"Gnist-API-Key": "YOUR_API_KEY"
}
}
}
}
Shell
curl -X POST "https://context.gnist.ai/mcp/openalex/" \
-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/openalex/
6 endpoints available:
GET /rest/openalex/search_papersGET /rest/openalex/get_paperGET /rest/openalex/get_author_profileGET /rest/openalex/list_citationsGET /rest/openalex/get_trending_papersGET /rest/openalex/report_feedback
Shell
curl "https://context.gnist.ai/rest/openalex/search_papers?query=example" \ -H "Gnist-API-Key: YOUR_API_KEY"
Python
import httpx
resp = httpx.get(
"https://context.gnist.ai/rest/openalex/search_papers",
headers={"Gnist-API-Key": "YOUR_API_KEY"},
params={
"query": "example"
},
)
print(resp.json())
Command Line
Command
gc openalex
CLI documentation will be available when the GnistAI SDK is published.
Install
pip install gnistai
Available Tools (6)
search_papersSearch scholarly papers by keyword across 250M+ works from OpenAlex.
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | required | Search terms (e.g. "transformer attention mechanisms", "CRISPR gene editing"). |
year_from | any | optional | Filter to papers published from this year onward (e.g. 2020). Optional. |
year_to | any | optional | Filter to papers published up to this year (e.g. 2024). Optional. |
field_of_study | any | optional | Filter by research field (e.g. "machine learning", "biology"). Optional. |
max_results | integer | optional | Number of results to return (1–25, default 10). (default: 10) |
get_paperGet full details for a specific paper including abstract and citation count.
| Parameter | Type | Required | Description |
|---|---|---|---|
paper_id | string | required | OpenAlex ID (e.g. "W2741809807"), DOI (e.g. "10.1038/s41586-021-03819-2"), or full URL (e.g. "https://openalex.org/W2741809807"). |
get_author_profileGet a researcher's profile — works, citations, h-index, and affiliations.
| Parameter | Type | Required | Description |
|---|---|---|---|
author_id | string | required | OpenAlex author ID (e.g. "A5023888391"), ORCID (e.g. "0000-0001-6187-6610"), or full ORCID URL. |
list_citationsList papers that cite or are referenced by a given paper.
| Parameter | Type | Required | Description |
|---|---|---|---|
paper_id | string | required | OpenAlex ID, DOI, or full URL of the paper. |
direction | string | optional | "cited_by" for papers that cite this one (default), or "references" for papers this paper cites. (default: "cited_by") |
max_results | integer | optional | Number of results to return (1–25, default 20). (default: 20) |
get_trending_papersGet recently published high-impact papers in a research field.
| Parameter | Type | Required | Description |
|---|---|---|---|
field | string | required | Research field to search (e.g. "machine learning", "immunology", "climate change"). |
days | integer | optional | Look back this many days for recent papers (default 30). (default: 30) |
max_results | integer | optional | Number of results to return (1–25, 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") |