{"name":"io.github.cyanheads/openalex-mcp-server","slug":"cyanheads-openalex-mcp-server","title":null,"description":"Access the OpenAlex academic research catalog — 270M+ publications.","url":"https://mcp.market/server/cyanheads-openalex-mcp-server","rating":null,"grade":"A","score":93,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":31,"stars":14,"forks":5,"downloads_week":null,"last_push_at":"2026-09-19T12:16:15.000Z","license":"Apache-2.0"},"uptime":null,"claimed":false,"transport":"mixed","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/cyanheads/openalex-mcp-server","website":null,"version":"0.7.14","remotes":[{"type":"streamable-http","url":"https://openalex.caseyjhand.com/mcp"}],"packages":[{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@cyanheads/openalex-mcp-server","version":"0.7.14","runtimeHint":"node","transport":{"type":"stdio"},"packageArguments":[{"value":"run","type":"positional"},{"value":"start:stdio","type":"positional"}],"environmentVariables":[{"description":"OpenAlex account API key, sent as api_key= - optional (free from https://openalex.org/settings/api). Without it, anonymous rate limits apply.","format":"string","name":"OPENALEX_API_KEY"},{"description":"Optional email sent as mailto= to identify yourself to OpenAlex (the polite pool). Separate from the API key.","format":"string","name":"OPENALEX_MAILTO"},{"description":"OpenAlex API base URL.","format":"string","default":"https://api.openalex.org","name":"OPENALEX_BASE_URL"},{"description":"Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').","format":"string","default":"info","name":"MCP_LOG_LEVEL"}]},{"registryType":"npm","registryBaseUrl":"https://registry.npmjs.org","identifier":"@cyanheads/openalex-mcp-server","version":"0.7.14","runtimeHint":"node","transport":{"type":"streamable-http","url":"http://localhost:3010/mcp"},"packageArguments":[{"value":"run","type":"positional"},{"value":"start:http","type":"positional"}],"environmentVariables":[{"description":"OpenAlex account API key, sent as api_key= - optional (free from https://openalex.org/settings/api). Without it, anonymous rate limits apply.","format":"string","name":"OPENALEX_API_KEY"},{"description":"Optional email sent as mailto= to identify yourself to OpenAlex (the polite pool). Separate from the API key.","format":"string","name":"OPENALEX_MAILTO"},{"description":"OpenAlex API base URL.","format":"string","default":"https://api.openalex.org","name":"OPENALEX_BASE_URL"},{"description":"The hostname for the HTTP server.","format":"string","default":"127.0.0.1","name":"MCP_HTTP_HOST"},{"description":"The port to run the HTTP server on.","format":"string","default":"3010","name":"MCP_HTTP_PORT"},{"description":"The endpoint path for the MCP server.","format":"string","default":"/mcp","name":"MCP_HTTP_ENDPOINT_PATH"},{"description":"Authentication mode to use: 'none', 'jwt', or 'oauth'.","format":"string","default":"none","name":"MCP_AUTH_MODE"},{"description":"Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').","format":"string","default":"info","name":"MCP_LOG_LEVEL"}]}],"tools":[{"name":"openalex_analyze_trends","description":"Aggregate OpenAlex entities into groups and count them. Use for trend analysis (group works by publication_year), distribution analysis (group by oa_status, type, country), and comparative analysis (group by institution or topic). Combine with filters to scope the analysis. Returns up to 200 groups per page — use cursor pagination for fields with many distinct values.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"entity_type":{"type":"string","enum":["works","authors","sources","institutions","topics","keywords","publishers","funders"],"description":"Entity type to aggregate."},"group_by":{"type":"string","description":"Field to group by. Works examples: \"publication_year\", \"type\", \"oa_status\", \"primary_topic.field.id\", \"authorships.institutions.country_code\", \"is_retracted\". Authors: \"last_known_institutions.country_code\", \"has_orcid\". Sources: \"type\", \"is_oa\", \"country_code\". Not all fields support group_by — check entity docs if unsure."},"filters":{"description":"Filter criteria (same syntax as openalex_search_entities filters). Narrows the population before aggregation. For full-text within filters, use abstract.search, title.search, or default.search — there is no bare 'search' filter key. Example: group works by year filtered to a specific topic.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"include_unknown":{"default":false,"description":"Include a group for entities with no value for the grouped field. Hidden by default.","type":"boolean"},"per_page":{"default":200,"description":"Maximum groups per page (1-200). Default 200 (the upstream cap). A real top-N knob when order is count (the default) — reduce to return only the highest-count groups.","type":"integer","minimum":1,"maximum":200},"order":{"description":"Sort order for groups. Omit or pass \"count\" (default) to return the top-N groups by count descending — no further pages. Pass \"key\" to enumerate all distinct values in key-ascending order with cursor pagination. Use \"key\" only when you need a full traversal; most analysis calls want \"count\".","type":"string","enum":["count","key"]},"cursor":{"description":"Pagination cursor from a previous response. Only relevant when order is \"key\" — count-descending results have no next page. Pass the next_cursor from the previous response to advance.","type":"string"}},"required":["entity_type","group_by"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openalex_describe_fields","description":"List valid field names for an OpenAlex entity type and context (filter, group_by, or select). Use proactively before constructing a filter or group_by to avoid invalid-field 400 errors. Pass `query` to rank the list by name similarity — useful when you have a partial or guessed field name. Ranking never drops a field: the full list comes back either way.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"entity_type":{"type":"string","enum":["works","authors","sources","institutions","topics","keywords","publishers","funders"],"description":"OpenAlex entity type to list fields for."},"context":{"type":"string","enum":["filter","group_by","select"],"description":"Field usage context. \"filter\": fields accepted in the filter param. \"group_by\": fields accepted in group_by — a subset of the filter set (raw date and *.search fields are excluded; they cannot be grouped). \"select\": fields accepted in select."},"query":{"description":"Optional partial or guessed field name to sort results by similarity. Pass the field you tried (e.g. \"funder\") to get the closest matches first. The complete field list is returned either way — a query reorders it, it does not filter it, so a nested value's parent object (e.g. `summary_stats` for \"h_index\") is still reachable further down.","type":"string"}},"required":["entity_type","context"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openalex_get_citation_graph","description":"Walk the citation graph one hop from a seed work. Direction picks the edge: incoming citations (`cites`), the seed's own references (`cited_by`), or OpenAlex's algorithmically-related works (`related_to`). Note: `direction` follows OpenAlex's filter convention, which inverts the common English reading — `cites` returns works that cite the seed; `cited_by` returns works the seed cites. Results use the works schema; combine with filters/sort to narrow further.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"seed_id":{"type":"string","minLength":1,"description":"Seed work identifier. Accepts OpenAlex ID (\"W2741809807\"), DOI (\"10.1038/nature12373\" or full URL), or PMID (\"12345678\" or \"https://pubmed.ncbi.nlm.nih.gov/12345678\"). A PMCID is recognized too, bare or as a PubMed Central URL, but OpenAlex indexes no PMCIDs, so it resolves nothing — pass the work's PMID or DOI instead. Use openalex_resolve_name first if you only have a title."},"direction":{"type":"string","enum":["cites","cited_by","related_to"],"description":"\"cites\": works that cite seed_id (incoming citations). \"cited_by\": works that seed_id cites (its reference list). \"related_to\": OpenAlex algorithmically-related works (~8-30 typical, may be empty for less-cited seeds)."},"filters":{"description":"Additional filters to narrow the graph, same syntax as openalex_search_entities. Example: publication_year=\">2020\", is_oa=\"true\". Do not include cites/cited_by/related_to — those are set by the `direction` parameter.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"sort":{"description":"Sort field. Prefix with \"-\" for descending. Comma-separate for a multi-key sort, applied left to right, with the \"-\" prefix set per key (\"-publication_year,cited_by_count\" sorts by year descending, then citations ascending). Common: \"cited_by_count\", \"-publication_date\". Default is OpenAlex relevance.","type":"string"},"select":{"description":"OpenAlex work field names to return. Always returned: id, display_name. Defaults to the curated works select if omitted.","type":"array","items":{"type":"string"}},"per_page":{"default":25,"description":"Results per page (1-100). Default 25.","type":"integer","minimum":1,"maximum":100},"cursor":{"description":"Pagination cursor from a previous response. Pass to get the next page.","type":"string"}},"required":["seed_id","direction"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openalex_resolve_name","description":"Resolve a name or an identifier to an OpenAlex ID. ALWAYS use this before filtering by entity — names are ambiguous, IDs are not. A name returns up to 10 autocomplete matches with disambiguation hints. An identifier — OpenAlex ID, DOI, ORCID, ROR, PMID, or ISSN, bare or in URL form — resolves directly to the one record it addresses, and needs no entity_type. A PMCID is recognized as well, bare or as a PubMed Central URL, but OpenAlex indexes no PMCIDs, so it resolves nothing — pass the work's PMID or DOI instead.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"entity_type":{"description":"Entity type to search. Omit for cross-entity search (useful when entity type is unknown). Not applied when `query` is an identifier — an identifier determines its own entity type.","type":"string","enum":["works","authors","sources","institutions","topics","keywords","publishers","funders"]},"query":{"type":"string","minLength":1,"description":"Name or partial name to resolve. Also accepts an identifier, bare or in URL form — OpenAlex ID (\"W2741809807\", \"F4320332161\"), DOI (\"10.1038/nature12373\"), ORCID (\"0000-0002-1825-0097\"), ROR (\"https://ror.org/00hx57361\"), PMID (\"12345678\" or \"https://pubmed.ncbi.nlm.nih.gov/12345678\"), ISSN (\"1234-5678\") — which resolves straight to that one record instead of running a name search. A PMCID (\"PMC1234567\" or a PubMed Central URL) is recognized but OpenAlex indexes no PMCIDs, so it resolves nothing — pass the work's PMID or DOI instead."},"filters":{"description":"Narrow autocomplete results with filters. Example: restrict to a specific country or publication year range. Applies to name queries only — an identifier already addresses a single record.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}}},"required":["query"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}},{"name":"openalex_search_entities","description":"Search, filter, sort, or retrieve by ID. Covers all OpenAlex entity types (works, authors, sources, institutions, topics, keywords, publishers, funders). Pass `id` to retrieve a single entity. Otherwise, use `query` and/or `filters` for discovery. Supports keyword search with boolean operators, exact phrase matching, and AI semantic search. Use openalex_resolve_name to resolve names to IDs before filtering. Searches and ID lookups return a curated set of fields by default; pass `select` to override with specific fields, or `[\"*\"]` for the full record.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"entity_type":{"type":"string","enum":["works","authors","sources","institutions","topics","keywords","publishers","funders"],"description":"Type of scholarly entity to search."},"id":{"description":"Retrieve a single entity by ID. Supports: OpenAlex ID (\"W2741809807\"), DOI (\"10.1038/nature12373\"), ORCID (\"0000-0002-1825-0097\"), ROR (\"https://ror.org/00hx57361\"), PMID (\"12345678\" or \"https://pubmed.ncbi.nlm.nih.gov/12345678\"), ISSN (\"1234-5678\"). A PMCID is recognized too, bare (\"PMC1234567\") or as a PubMed Central URL, but OpenAlex indexes no PMCIDs, so it resolves nothing — pass the work's PMID or DOI instead. When provided, `query`, `search_mode`, `filters`, `sort`, `sample`, and `seed` are not applied — the returned record is the entity at that ID regardless of them, and the response `notice` names any you passed. `select` still applies: the curated per-entity-type default is returned unless you pass `select` (use `[\"*\"]` for the complete record). To filter, drop `id` and search. Use openalex_resolve_name to find the ID if unknown.","type":"string"},"query":{"description":"Text search query. Supports boolean operators (AND, OR, NOT), quoted phrases (\"exact match\"), wildcards (machin*), fuzzy matching (machin~1), and proximity (\"climate change\"~5). Omit for filter-only queries.","type":"string"},"search_mode":{"default":"keyword","description":"Search strategy. \"keyword\": stemmed full-text (default). \"exact\": no stemming, matches individual words (use quoted phrases for multi-word exact match). \"semantic\": AI embedding similarity (max 50 results, 1 req/sec).","type":"string","enum":["keyword","exact","semantic"]},"filters":{"description":"Filter criteria as field:value pairs. AND across fields (multiple keys). OR within field: pipe-separate (\"us|gb\"). NOT: prefix \"!\" (\"!us\"). Range: \"2020-2024\". Comparison: \">100\", \"<50\". AND within same field: \"+\"-separate. Use OpenAlex IDs (not names) for entity filters — resolve names first. Common keys: `openalex` (filter by entity ID, e.g. {\"openalex\": \"W123|W456\"}), `cites` (works citing a given work), `publication_year` (range \"2020-2024\"), `authorships.author.id`, `type`, `is_oa`.","type":"object","propertyNames":{"type":"string"},"additionalProperties":{"type":"string"}},"sort":{"description":"Sort field. Prefix with \"-\" for descending. Comma-separate for a multi-key sort, applied left to right, with the \"-\" prefix set per key (\"-publication_year,cited_by_count\" sorts by year descending, then citations ascending). Common: \"cited_by_count\", \"-publication_date\", \"-relevance_score\" (default when query present). Note: when combined with a keyword query, an explicit sort overrides relevance ranking entirely — top results may be highly cited but only tangentially on-topic. Use \"-relevance_score\" or omit sort to keep the most relevant results first. \"-relevance_score\" requires an active search via \"query\" or a \"filter:search\" filter — passing it without one will fail.","type":"string"},"select":{"description":"OpenAlex top-level field names to return. Always returned: `id`, `display_name` — additional fields you list are appended. A curated default per entity type applies to both searches and single-entity (`id`) lookups; pass field names to override it, or `[\"*\"]` to retrieve the complete record (every field). Only top-level fields project, so a nested value is requested by its parent object: bibliometrics (`h_index`, `i10_index`, `2yr_mean_citedness`) live under `summary_stats` on authors, sources, institutions, publishers, and funders, and naming a leaf returns that object. Invalid field names produce an error identifying the rejected field. Example: [\"doi\", \"authorships\", \"primary_topic\"].","type":"array","items":{"type":"string"}},"per_page":{"default":25,"description":"Results per page (1-100). Default 25. Semantic search caps at 50 — when search_mode=\"semantic\", set per_page ≤ 50 (also subject to a 1 req/sec rate limit upstream). The cap applies to searches only; an `id` lookup returns its one record regardless of both.","type":"integer","minimum":1,"maximum":100},"cursor":{"description":"Pagination cursor from a previous response. Pass to get the next page.","type":"string"},"sample":{"description":"Return a random sample of this many entities matching the filters (1-100). Single page only — pagination via `cursor` is not supported with sampling. Overrides `per_page`. Useful for unbiased exploration: spot-checking filter correctness, stratified review prompts, or generating exploration sets without bias toward most-cited.","type":"integer","minimum":1,"maximum":100},"seed":{"description":"Deterministic seed for `sample`. Same seed + same filters = same results — pass when reproducibility matters. Has no effect without `sample`, and a search that passes it alone is rejected.","type":"string"}},"required":["entity_type"],"$schema":"https://json-schema.org/draft/2020-12/schema","additionalProperties":false}}],"scan":{"score":93,"grade":"A","scanned_at":"2026-09-19T15:56:48.161Z","report":{"scannerVersion":"0.1.3","scannedAt":"2026-09-19T15:56:48.222Z","components":{"code":{"score":25,"max":25,"notes":["35 source files scanned","35 source files scanned"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 432ms"]},"poisoning":{"score":15,"max":15,"notes":["5 tool descriptions checked"]},"auth":{"score":10,"max":15,"notes":["open endpoint, read-only tools"]},"maintenance":{"score":15,"max":15,"notes":["last push 0 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"probes":[{"url":"https://openalex.caseyjhand.com/mcp","reachable":true,"authRequired":false,"latencyMs":432,"serverInfo":{"name":"openalex-mcp-server","version":"0.7.14"}}],"packages":[{"registryType":"npm","identifier":"@cyanheads/openalex-mcp-server","version":"0.7.14","found":true,"license":"Apache-2.0","hasInstallScripts":false,"dependencyCount":3,"publishedAt":"2026-09-19T12:18:30.670Z","repositoryUrl":"git+https://github.com/cyanheads/openalex-mcp-server.git"},{"registryType":"npm","identifier":"@cyanheads/openalex-mcp-server","version":"0.7.14","found":true,"license":"Apache-2.0","hasInstallScripts":false,"dependencyCount":3,"publishedAt":"2026-09-19T12:18:30.670Z","repositoryUrl":"git+https://github.com/cyanheads/openalex-mcp-server.git"}],"repo":{"found":true,"owner":"cyanheads","repo":"openalex-mcp-server","archived":false,"pushedAt":"2026-09-19T12:16:15Z","stars":14,"forks":5,"openIssues":14,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/10339515?v=4","ownerCreatedAt":"2014-12-29T13:01:12Z","license":"Apache-2.0"},"icon":{"url":"https://avatars.githubusercontent.com/u/10339515?v=4&s=128","source":"github"},"presence":{"stars":14,"forks":5,"downloadsWeek":null,"license":"Apache-2.0","lastPushAt":"2026-09-19T12:16:15.000Z","score":31}}}},"grade_history":[],"reviews":[]}