@pipeworx/mcp-openalex 0.1.2 → 0.2.0

package/tools.json

@@ -0,0 +1,138 @@
+[
+  {
+    "name": "search_works",
+    "description": "Search scholarly/academic research across ALL fields — medicine, biology, neuroscience, genetics, chemistry, physics, materials science, computer science, economics, and beyond. Find recent studies, papers, and findings on any topic, gene, disease, drug, material, method, or theory by title, author, or keyword — e.g. \"latest research on Kv7 potassium channels in epilepsy\", \"recent studies on semaglutide\", \"what has been published on X\". Returns title, authors, journal, publication year, citation count, and abstract.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Search query (e.g., \"transformer neural networks\")"
+        },
+        "_apiKey": {
+          "type": "string",
+          "description": "OpenAlex API key. Optional — Pipeworx supplies one; pass your own to bill your account instead."
+        },
+        "limit": {
+          "type": "number",
+          "description": "Number of results to return (1-25, default 10)"
+        }
+      },
+      "required": [
+        "query"
+      ]
+    }
+  },
+  {
+    "name": "search_authors",
+    "description": "Find researchers by name or institution affiliation. Returns author name, ORCID, institution, publication count, and total citations.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Author name to search for (e.g., \"Yoshua Bengio\")"
+        },
+        "_apiKey": {
+          "type": "string",
+          "description": "OpenAlex API key. Optional — Pipeworx supplies one; pass your own to bill your account instead."
+        },
+        "limit": {
+          "type": "number",
+          "description": "Number of results to return (1-25, default 10)"
+        }
+      },
+      "required": [
+        "query"
+      ]
+    }
+  },
+  {
+    "name": "search_institutions",
+    "description": "Find academic institutions by name or location (e.g., country code 'US', 'GB'). Returns institution name, country, type, publication count, and research areas.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Institution name to search for (e.g., \"MIT\")"
+        },
+        "_apiKey": {
+          "type": "string",
+          "description": "OpenAlex API key. Optional — Pipeworx supplies one; pass your own to bill your account instead."
+        },
+        "limit": {
+          "type": "number",
+          "description": "Number of results to return (1-25, default 10)"
+        }
+      },
+      "required": [
+        "query"
+      ]
+    }
+  },
+  {
+    "name": "get_concept",
+    "description": "Look up research fields or topics by name. Returns concept description, publication count, related concepts, and parent concepts in the academic hierarchy.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Concept name to look up (e.g., \"deep learning\")"
+        },
+        "_apiKey": {
+          "type": "string",
+          "description": "OpenAlex API key. Optional — Pipeworx supplies one; pass your own to bill your account instead."
+        }
+      },
+      "required": [
+        "query"
+      ]
+    }
+  },
+  {
+    "name": "get_scholarly_work",
+    "description": "Fetch a single scholarly work from OpenAlex by its OpenAlex ID (e.g. \"W2741809807\") or DOI (e.g. \"10.1038/s41586-021-03819-2\"). Returns the full record + reconstructed abstract and the works it CITES (referenced_works) — for backward citation-graph navigation. Use after search_works, or whenever you have a DOI/ID. (Named get_scholarly_work to avoid colliding with Crossref get_work.)",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "OpenAlex work ID (\"W...\") or a DOI (\"10.xxxx/yyyy\" or a full doi.org URL)."
+        },
+        "_apiKey": {
+          "type": "string",
+          "description": "OpenAlex API key. Optional — Pipeworx supplies one; pass your own to bill your account instead."
+        }
+      },
+      "required": [
+        "id"
+      ]
+    }
+  },
+  {
+    "name": "get_journal_publishing_model",
+    "description": "Is a journal subscription, hybrid or fully open access? Look up a journal by ISSN (print or electronic, e.g. \"0025-1461\" or \"1864-1547\") and get its publisher, article-processing charge, whether the Directory of Open Access Journals lists it, and the open-access status mix of its recent articles (gold, diamond, hybrid, bronze, green, closed), with a derived model label: open_access, hybrid or subscription. The label is inferred from article-level evidence, not declared by the publisher.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "issn": {
+          "type": "string",
+          "description": "Journal ISSN, print or electronic, e.g. \"1864-1547\""
+        },
+        "years": {
+          "type": "number",
+          "description": "Look-back window in years for the article mix (1-15, default 5)"
+        },
+        "_apiKey": {
+          "type": "string",
+          "description": "OpenAlex API key. Optional — Pipeworx supplies one; pass your own to bill your account instead."
+        }
+      },
+      "required": [
+        "issn"
+      ]
+    }
+  }
+]