{ "openapi": "3.0.1", "info": { "title": "Academic Research MCP: Papers, Citations & Authors (OpenAlex)", "description": "Search 250M+ scholarly papers from Claude, Cursor or any MCP client, or in a normal run: titles, authors, DOIs, abstracts, citation counts, open-access PDFs. Walk citations and references, list an author's papers, get a topic overview. OpenAlex with Crossref fallback.", "version": "0.1", "x-build-id": "fQwxSn38axgiiMAnx" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/oldjard~academic-research-mcp/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-oldjard-academic-research-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/oldjard~academic-research-mcp/runs": { "post": { "operationId": "runs-sync-oldjard-academic-research-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/oldjard~academic-research-mcp/run-sync": { "post": { "operationId": "run-sync-oldjard-academic-research-mcp", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "query": { "title": "Search query", "type": "string", "description": "Papers whose title or abstract match these words, e.g. \"microplastics drinking water\". Used in a normal run; AI agents connected over MCP send their own queries." }, "ids": { "title": "Paper IDs to look up", "type": "array", "description": "Optional. DOIs (10.1038/nature12373 or doi.org URLs), OpenAlex work IDs (W2741809807) or arXiv IDs (2005.11401). Each becomes one row with its abstract and citation count.", "items": { "type": "string" } }, "sort": { "title": "Sort by", "enum": [ "relevance", "citations", "newest" ], "type": "string", "description": "Order of the search results.", "default": "relevance" }, "fromYear": { "title": "From year", "minimum": 1500, "maximum": 2100, "type": "integer", "description": "Only papers published in or after this year." }, "toYear": { "title": "To year", "minimum": 1500, "maximum": 2100, "type": "integer", "description": "Only papers published in or before this year." }, "openAccessOnly": { "title": "Open access only", "type": "boolean", "description": "Only papers with a free full text (the row has its PDF or landing-page link).", "default": false }, "includeAbstracts": { "title": "Include abstracts", "type": "boolean", "description": "Add each search result's abstract. Looked-up IDs always include it.", "default": false }, "maxResults": { "title": "Max papers", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Stop after this many search results (up to 1,000). You pay per paper saved.", "default": 50 }, "openalexApiKey": { "title": "OpenAlex API key (optional)", "type": "string", "description": "Optional. A free key from openalex.org/settings/api gives your searches their own daily OpenAlex budget. Without one, searches use the Actor's shared budget and fall back to Crossref when it runs out. MCP clients can send it in the X-OpenAlex-Api-Key header instead." }, "contactEmail": { "title": "Contact email for Crossref (optional)", "type": "string", "description": "Optional. Crossref routes requests that carry a contact address to its faster \"polite\" pool. Only sent to Crossref." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }