{"report":{"v":1,"package":"@cyanheads/openalex-mcp-server","version":"0.11.1","ranAt":"2026-11-16T11:41:30.955Z","install":{"ok":true,"integrity":"sha512-3364piDBCbtaI5gqN32rXq4s7uAX9/+fW+K1PO8piZXp3sLe0BMLel6XKkBxVawupzxHlCLcJl8V9EVf031hgA==","deps":36,"scripts":[],"bins":["openalex-mcp-server"],"license":"Apache-2.0","engines":"node >=24.0.0","repository":"git+https://github.com/cyanheads/openalex-mcp-server.git","bin":"openalex-mcp-server"},"start":{"ok":true,"ms":381,"serverName":"openalex-mcp-server","serverVersion":"0.11.1","protocol":"2025-06-18","stderr":"e\":1794829301678,\"env\":\"development\",\"version\":\"0.11.1\",\"pid\":59,\"operation\":\"PromptRegistry.registerAll\",\"requestId\":\"7MCQ6-L33DQ\",\"timestamp\":\"2026-11-16T11:41:41.676Z\",\"msg\":\"Successfully registered 2 prompts\"}\n{\"level\":20,\"time\":1794829301678,\"env\":\"development\",\"version\":\"0.11.1\",\"pid\":59,\"operation\":\"ToolRegistry.registerTool\",\"requestId\":\"2K7CI-K7ZJC\",\"timestamp\":\"2026-11-16T11:41:41.678Z\",\"toolName\":\"openalex_get_citation_graph\",\"msg\":\"Registering tool: 'openalex_get_citation_graph'\"}\n{\"level\":20,\"time\":1794829301678,\"env\":\"development\",\"version\":\"0.11.1\",\"pid\":59,\"operation\":\"ToolRegistry.registerTool\",\"requestId\":\"2K7CI-K7ZJC\",\"timestamp\":\"2026-11-16T11:41:41.678Z\",\"toolName\":\"openalex_get_citation_graph\",\"msg\":\"Tool 'openalex_get_citation_graph' registered successfully.\"}\n{\"level\":20,\"time\":1794829301678,\"env\":\"development\",\"version\":\"0.11.1\",\"pid\":59,\"operation\":\"ToolRegistry.registerTool\",\"requestId\":\"LC5G1-HG5P1\",\"timestamp\":\"2026-11-16T11:41:41.678Z\",\"toolName\":\"openalex_describe_fields\",\"msg\":\"Registering tool: 'openalex_describe_fields'\"}\n{\"level\":20,\"time\":1794829301679,\"env\":\"development\",\"version\":\"0.11.1\",\"pid\":59,\"operation\":\"ToolRegistry.registerTool\",\"requestId\":\"LC5G1-HG5P1\",\"timestamp\":\"2026-11-16T11:41:41.678Z\",\"toolName\":\"openalex_describe_fields\",\"msg\":\"Tool 'openalex_describe_fields' registered successfully.\"}\n{\"level\":20,\"time\":1794829301679,\"env\":\"development\",\"version\":\"0.11.1\",\"pid\":59,\"operation\":\"createMcpServerInstance\",\"requestId\":\"ZXX4T-G16W4\",\"timestamp\":\"2026-11-16T11:41:41.673Z\",\"msg\":\"All MCP capabilities registered successfully\"}\n"},"tools":[{"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, PMCID, ISSN, or arXiv ID, bare or in URL form — resolves directly to the record it addresses instead of running a name search. An arXiv ID resolves to its work under any entity_type, found by its arXiv landing page when OpenAlex holds no work under its arXiv DOI, one billed list request. Short names share the bare OpenAlex ID shape (keyword p53 reads as publisher ID P53), so a bare OpenAlex ID that resolves nothing is searched as a name next. Two identifiers can address more than one entity type: a ROR names an organization's institution, funder, and publisher records alike, so it returns each one that exists (institution first) unless entity_type picks one of those three; and a Crossref Funder Registry DOI (10.13039/…) resolves to the funder unless entity_type is works. An award ID (G…, bare or as an OpenAlex URL) is not looked up, since OpenAlex has no award autocomplete: it returns no matches and a notice naming the openalex_search_entities call that opens the award. Under entity_type, a bare G… is searched as a name of that type instead.","params":["entity_type","query","filters"]},{"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, awards). Pass `id` to retrieve a single entity; on works it also takes an arXiv ID, found by its arXiv landing page when OpenAlex holds no work under its arXiv DOI, one billed list request. Otherwise, use `query` and/or `filters` for discovery. Filters take a record object; an unambiguous native string such as \"primary_location.source.issn:0920-8542\" is also accepted when enabled and disclosed in `notice`. Native clauses split on commas outside paired double quotes and the first colon; duplicate keys and bare fragments are rejected. Any filter value sent unquoted must have paired double quotes; balanced search phrases remain valid. Supports keyword search with boolean operators, exact phrase matching, AI semantic search, and seeded random samples. On works, wildcards (`*`, `?`) need search_mode \"exact\" or a `.search.exact` filter, and a `*` needs three characters before it. 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` (an array, or a comma-separated string) to override with specific fields, or `[\"*\"]` for the full record. A page holds `per_page` records and `next_cursor` continues it — semantic search and a seeded `sample` continue with `page` instead; an `id` lookup returns every selected array whole, and `slice` pages one array by count.","params":["entity_type","id","query","search_mode","filters","sort","select","per_page","cursor","page","sample","seed","slice"]},{"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 order \"key\" and cursor pagination for fields with many distinct values. OpenAlex can wrap a key-ordered walk to earlier groups. Stop when a page's first key repeats an earlier key, or when a page is short or empty.","params":["entity_type","group_by","filters","include_unknown","per_page","order","cursor"]},{"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. A page holds `per_page` works and `next_cursor` continues it.","params":["seed_id","direction","filters","sort","select","per_page","cursor"]},{"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.","params":["entity_type","context","query"]}],"toolsHash":"a6c95d0ae4a9a3e2085ce64236f09740c8711db46da8816345ddb00b3cb4ded5","wrote":[],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[{"kind":"orders","tool":"openalex_resolve_name","quote":"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 aut"}],"tools":5,"wrote":0,"callsTried":0,"callsAnswered":0,"callContacts":[]},"history":[{"package":"@cyanheads/openalex-mcp-server","version":"0.11.1","ranAt":"2026-11-16T11:41:30.955Z","outcome":"started","tools":5,"contacts":0,"flags":1,"serious":0,"toolsHash":"a6c95d0ae4a9a3e2085ce64236f09740c8711db46da8816345ddb00b3cb4ded5"}],"page":"https://bragproof.smaverk.com/r/%40cyanheads/openalex-mcp-server"}