{ "openapi": "3.0.1", "info": { "title": "OpenAlex MCP Server: papers, DOI and citations", "description": "Connect Claude, ChatGPT and Cursor to OpenAlex, Crossref, arXiv and Europe PMC through MCP. Search research papers by topic, verify any DOI, and pull scored, deduplicated records with citation counts, authors and open-access links. Your AI assistant cites real papers instead of inventing them.", "version": "0.1", "x-build-id": "HHe1YCBgkDhuFOZd3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mrbridge~open-science-evidence-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mrbridge-open-science-evidence-finder", "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/mrbridge~open-science-evidence-finder/runs": { "post": { "operationId": "runs-sync-mrbridge-open-science-evidence-finder", "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/mrbridge~open-science-evidence-finder/run-sync": { "post": { "operationId": "run-sync-mrbridge-open-science-evidence-finder", "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": { "examplePrompt": { "title": "Example prompt", "type": "string", "description": "Set the example research question for saved Actor tasks and one-off runs. MCP clients can still send any query through the tools.", "default": "Find recent open-access papers about retrieval augmented generation evaluation benchmarks." }, "crossrefMailto": { "title": "Crossref email", "type": "string", "description": "Optional email passed to Crossref for polite-pool requests. Leave empty unless you want Crossref to associate API traffic with your contact email." }, "runMode": { "title": "Run mode", "type": "string", "description": "Internal run mode used by saved tasks.", "default": "mcp_server" }, "query": { "title": "Research query", "type": "string", "description": "Hidden query used by saved task examples." }, "doi": { "title": "DOI", "type": "string", "description": "Hidden DOI used by saved DOI verification examples." }, "sources": { "title": "Sources", "type": "array", "description": "Hidden source list used by saved task examples.", "items": { "type": "string" } }, "maxResults": { "title": "Max results", "minimum": 1, "maximum": 25, "type": "integer", "description": "Hidden maximum result count used by saved task examples.", "default": 10 }, "fromYear": { "title": "From year", "type": "integer", "description": "Hidden earliest publication year used by saved task examples." }, "toYear": { "title": "To year", "type": "integer", "description": "Hidden latest publication year used by saved task examples." }, "sortBy": { "title": "Sort by", "type": "string", "description": "Hidden sort option used by saved task examples.", "default": "evidence_score" }, "openAccessOnly": { "title": "Open access only", "type": "boolean", "description": "Hidden open-access filter used by saved task examples.", "default": false }, "includePreprints": { "title": "Include preprints", "type": "boolean", "description": "Hidden preprint toggle used by saved task examples.", "default": true }, "includeAbstracts": { "title": "Include abstracts", "type": "boolean", "description": "Hidden abstract toggle used by saved task examples.", "default": true }, "topic": { "title": "Topic", "type": "string", "description": "Hidden topic hint used by saved task examples." } } }, "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 } } } } } } } } } }