{"report":"{\"v\":1,\"package\":\"openalex-research-mcp\",\"version\":\"0.5.0\",\"ranAt\":\"2026-11-16T11:40:45.407Z\",\"install\":{\"ok\":true,\"integrity\":\"sha512-UdiyO8zZXdGGMtTxOfgFJUXvId6HNmr9GupticKwMxypp/IzZTBrsm2H2w9BqHKDv87vF5+YrtJGMKqQ4yImfw==\",\"deps\":108,\"scripts\":[],\"bins\":[\"openalex-research-mcp\"],\"license\":\"MIT\",\"engines\":\"node >=18.0.0\",\"repository\":\"git+https://github.com/oksure/openalex-research-mcp.git\",\"bin\":\"openalex-research-mcp\"},\"start\":{\"ok\":true,\"ms\":233,\"serverName\":\"openalex-mcp\",\"serverVersion\":\"0.5.0\",\"protocol\":\"2025-06-18\"},\"tools\":[{\"name\":\"search_works\",\"description\":\"Search scholarly works with advanced filtering. Supports Boolean operators, year ranges, citation thresholds, venue/journal filtering (source_name, source_issn, source_id), and institution filtering (author_institution, institution_group). The most flexible search tool. Use search_in_journal_list for preset journal lists like UTD24 or FT50.\",\"params\":[\"query\",\"exact_phrase\",\"search_field\",\"from_year\",\"to_year\",\"min_citations\",\"cited_by_count\",\"source_name\",\"source_id\",\"source_issn\",\"author_institution\",\"institution_group\",\"is_oa\",\"type\",\"sort\",\"page\",\"per_page\"]},{\"name\":\"get_work\",\"description\":\"Get COMPLETE details about a specific work by OpenAlex ID or DOI. Unlike search results which are summarized, this returns ALL information including: complete author list (first, middle, and last authors with positions, institutions, ORCID, corresponding author flags), full abstract (reconstructed), all topics, complete bibliographic data, funding/grants, keywords, and reference lists. Use this when you need detailed information about a specific paper, especially for identifying PIs (often last author) or corresponding authors.\",\"params\":[\"id\"]},{\"name\":\"get_related_works\",\"description\":\"Find works related to a given work based on shared topics, citations, and references. Useful for discovering similar papers in a research area.\",\"params\":[\"id\",\"per_page\"]},{\"name\":\"search_by_topic\",\"description\":\"Search for works within specific research topics or domains. Use this to explore literature in a particular field or subfield. Supports venue filtering to restrict results to top journals/conferences.\",\"params\":[\"topic\",\"exact_phrase\",\"search_field\",\"from_year\",\"to_year\",\"source_name\",\"source_issn\",\"min_citations\",\"author_institution\",\"institution_group\",\"sort\",\"per_page\"]},{\"name\":\"autocomplete_search\",\"description\":\"Fast autocomplete/typeahead search for works, authors, institutions, or other entities. Returns quick suggestions for partial queries.\",\"params\":[\"query\",\"entity_type\"]},{\"name\":\"get_work_citations\",\"description\":\"Get all works that cite a given work. Essential for forward citation analysis and understanding research impact.\",\"params\":[\"id\",\"page\",\"per_page\",\"sort\"]},{\"name\":\"get_work_references\",\"description\":\"Get all works referenced/cited by a given work. Essential for backward citation analysis and finding foundational papers.\",\"params\":[\"id\"]},{\"name\":\"get_citation_network\",\"description\":\"Get a citation network for a work including both citing works (forward) and referenced works (backward). Returns immediate connections only. Citing works are returned as summaries; referenced works as IDs (use batch_resolve_references to hydrate).\",\"params\":[\"id\",\"max_citing\",\"max_references\"]},{\"name\":\"get_top_cited_works\",\"description\":\"Find the most highly cited works in a research area or matching specific criteria. Identifies influential and seminal papers. Automatically filters for papers with significant citations. Combine with source_name or source_issn to find the most-cited papers in a specific top journal/conference.\",\"params\":[\"query\",\"topic\",\"exact_phrase\",\"search_field\",\"from_year\",\"to_year\",\"min_citations\",\"source_name\",\"source_issn\",\"author_institution\",\"institution_group\",\"per_page\"]},{\"name\":\"search_authors\",\"description\":\"Search for authors/researchers. Returns h-index, citation count, and affiliation data. Best for finding experts when you know the name. Use search_authors_by_expertise to find experts by research area.\",\"params\":[\"query\",\"exact_phrase\",\"works_count\",\"cited_by_count\",\"institution\",\"sort\",\"per_page\"]},{\"name\":\"get_author_works\",\"description\":\"Get all publications by a specific author over time. Useful for analyzing an author's research trajectory and productivity.\",\"params\":[\"author_id\",\"from_year\",\"to_year\",\"sort\",\"per_page\"]},{\"name\":\"get_author_collaborators\",\"description\":\"Analyze an author's co-authorship network. Returns frequent collaborators and collaboration statistics.\",\"params\":[\"author_id\",\"min_collaborations\"]},{\"name\":\"search_institutions\",\"description\":\"Search for academic institutions with filters for research output, citations, and geographical location. Find leading institutions in specific areas.\",\"params\":[\"query\",\"exact_phrase\",\"country_code\",\"type\",\"works_count\",\"per_page\"]},{\"name\":\"analyze_topic_trends\",\"description\":\"Analyze publication trends over time for specific topics or queries. Returns works grouped by year to show research evolution and growth.\",\"params\":[\"query\",\"exact_phrase\",\"search_field\",\"from_year\",\"to_year\"]},{\"name\":\"compare_research_areas\",\"description\":\"Compare publication volume and citation metrics across different research topics or queries. Useful for understanding relative activity in different fields.\",\"params\":[\"topics\",\"exact_phrase\",\"from_year\",\"to_year\"]},{\"name\":\"get_trending_topics\",\"description\":\"Discover emerging and trending research topics based on recent publication activity. Identifies fast-growing research areas.\",\"params\":[\"min_works\",\"time_period_years\",\"per_page\"]},{\"name\":\"analyze_geographic_distribution\",\"description\":\"Analyze the geographical distribution of research activity for a topic or query. Shows which countries and institutions are most active.\",\"params\":[\"query\",\"exact_phrase\",\"search_field\",\"from_year\",\"to_year\"]},{\"name\":\"get_entity\",\"description\":\"Get detailed information about any OpenAlex entity by ID. Supports works, authors, sources, institutions, topics, publishers, and funders.\",\"params\":[\"entity_type\",\"id\"]},{\"name\":\"search_sources\",\"description\":\"Search for journals, conferences, and other publication sources. Results are sorted by h-index descending by default, making it easy to identify top-tier venues. Returns h-index, impact metrics, and open access status. Use check_venue_quality for detailed metrics on a specific venue, or get_top_venues_for_field to discover the best venues in a research area.\",\"params\":[\"query\",\"exact_phrase\",\"type\",\"is_oa\",\"works_count\",\"per_page\"]},{\"name\":\"list_journal_presets\",\"description\":\"List all available named journal/conference presets and institution group presets. Call this first to discover which preset keys to pass to search_in_journal_list or the institution_group parameter. Presets include: UTD24, FT50, AJG/ABS 4*/4/3 tiers, top AI conferences, Management Science group, Nature/Science family, and institution groups (Ivy League, Top US, INSEAD+London, etc.).\",\"params\":[\"category\"]},{\"name\":\"search_in_journal_list\",\"description\":\"Search for papers in a named list of top journals or conferences (preset) rather than specifying individual venues. This is the main tool for credibility-gated searches. Examples: search in UTD24 journals, FT50, AJG 4*, top AI conferences. Combine with author_institution or institution_group to answer questions like \\\"AI papers in top AI conferences by Harvard/Stanford/MIT authors\\\".\",\"params\":[\"query\",\"exact_phrase\",\"search_field\",\"journal_list\",\"from_year\",\"to_year\",\"min_citations\",\"author_institution\",\"institution_group\",\"sort\",\"per_page\"]},{\"name\":\"search_works_in_venue\",\"description\":\"Search for papers published in a specific journal or conference. This is the primary tool for restricting citations to credible, high-impact venues. Identify the venue first via check_venue_quality or search_sources, then use its name, ISSN, or ID here.\",\"params\":[\"query\",\"exact_phrase\",\"search_field\",\"venue_name\",\"venue_issn\",\"venue_id\",\"from_year\",\"to_year\",\"min_citations\",\"sort\",\"per_page\"]},{\"name\":\"get_top_venues_for_field\",\"description\":\"Get the top journals and conferences for a specific research field ranked by h-index. Essential first step before searching for citations — use this to identify credible venues, then use search_works_in_venue to restrict searches to them.\",\"params\":[\"query\",\"exact_phrase\",\"type\",\"per_page\"]},{\"name\":\"check_venue_quality\",\"description\":\"Check the quality and prestige metrics of a journal or conference. Returns h-index, citation impact, and indexing status. Use before citing a paper to confirm the venue is reputable.\",\"params\":[\"venue_name\",\"venue_issn\",\"venue_id\"]},{\"name\":\"get_author_profile\",\"description\":\"Get a comprehensive research profile for an author: h-index, i10-index, total citations, top-cited works, recent works, and main research topics. Use this to identify key researchers, potential reviewers, or to study an expert's body of work.\",\"params\":[\"author_id\",\"top_works_count\",\"recent_works_count\"]},{\"name\":\"search_authors_by_expertise\",\"description\":\"Find leading researchers/experts in a specific topic or research area, ranked by h-index or citation count. More useful than search_authors when you do not know names but need to identify key figures in a field.\",\"params\":[\"topic\",\"exact_phrase\",\"min_h_index\",\"min_cited_by_count\",\"institution\",\"per_page\"]},{\"name\":\"find_review_articles\",\"description\":\"Find review articles, systematic reviews, and meta-analyses on a topic. Reviews summarize the state-of-the-art and are high-value citations that establish context in top papers. Optionally restrict to specific high-impact journals.\",\"params\":[\"query\",\"exact_phrase\",\"search_field\",\"from_year\",\"to_year\",\"source_name\",\"min_citations\",\"per_page\"]},{\"name\":\"find_seminal_papers\",\"description\":\"Find seminal/foundational papers in a research area — those published more than 5 years ago with very high citations. These are the \\\"must-cite\\\" papers that establish the intellectual lineage of a field. Use to identify citations that reviewers expect to see.\",\"params\":[\"query\",\"exact_phrase\",\"search_field\",\"min_citations\",\"published_before\",\"source_name\",\"per_page\"]},{\"name\":\"batch_resolve_references\",\"description\":\"Resolve a list of DOIs or work IDs to full work metadata in one call. Useful for checking reference lists: validate that a set of citations are real, credible, and appropriately cited.\",\"params\":[\"ids\"]},{\"name\":\"find_open_access_version\",\"description\":\"Find freely available (open access) versions of papers, including preprints on arXiv, bioRxiv, and institutional repositories. Useful for accessing full text without a subscription.\",\"params\":[\"query\",\"exact_phrase\",\"search_field\",\"from_year\",\"source_name\",\"min_citations\",\"per_page\"]},{\"name\":\"health_check\",\"description\":\"Check the health status of the OpenAlex MCP server and API connectivity. Returns cache status and configuration information.\",\"params\":[]}],\"toolsHash\":\"681f7841d6e84e80b302d2348007c303c1bb23999673fbc4e879ec3a7b8e03cf\",\"wrote\":[],\"callsAt\":\"2026-11-16T11:40:51.882Z\",\"calls\":[{\"tool\":\"search_works\",\"ok\":true,\"ms\":516,\"bytes\":17594},{\"tool\":\"get_top_cited_works\",\"ok\":true,\"ms\":202,\"bytes\":17627},{\"tool\":\"search_authors\",\"ok\":true,\"ms\":1098,\"bytes\":10415},{\"tool\":\"search_institutions\",\"ok\":true,\"ms\":211,\"bytes\":11426},{\"tool\":\"get_trending_topics\",\"ok\":true,\"ms\":450,\"bytes\":1543}],\"host\":{\"commit\":\"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c\",\"run\":\"https://github.com/itsHaddad/bragproof/actions/runs/43857070216\"},\"network\":{\"names\":[\"registry.npmjs.org\"],\"conns\":[],\"callNames\":[\"api.openalex.org\"],\"callConns\":[]}}","token":"eyJhbGciOiJSUzI1NiIsImtpZCI6IjM4ODI2YjE3LTZhMzAtNWY5Yi1iMTY5LThiZWI4MjAyZjcyMyIsInR5cCI6IkpXVCIsIng1dCI6InlrTmFZNHFNX3RhNGsyVGdaT0NFWUxrY1lsQSJ9.eyJhY3RvciI6Iml0c0hhZGRhZCIsImFjdG9yX2lkIjoiMTE0NzMyNjEiLCJhdWQiOiJicmFncHJvb2YtcmVwb3J0OmZmNGJlNDNiOTFjM2RiMjEyMWEyODg4NmExYmYyZmFlMmM5YmYxMzVkN2U1ZjhhOTg0NDRjOGNkZmI0ZGY1NmMiLCJiYXNlX3JlZiI6IiIsImNoZWNrX3J1bl9pZCI6IjEzMzI2Mzk5NTM3MyIsImV2ZW50X25hbWUiOiJzY2hlZHVsZSIsImV4cCI6MTc5NDgyOTU2MCwiaGVhZF9yZWYiOiIiLCJpYXQiOjE3OTQ4MjkyNjAsImlzcyI6Imh0dHBzOi8vdG9rZW4uYWN0aW9ucy5naXRodWJ1c2VyY29udGVudC5jb20iLCJqb2Jfd29ya2Zsb3dfcmVmIjoiaXRzSGFkZGFkL2JyYWdwcm9vZi8uZ2l0aHViL3dvcmtmbG93cy9yZXBvcnQueW1sQHJlZnMvaGVhZHMvbWFpbiIsImpvYl93b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIiwianRpIjoiMjNjZTE1YWQtMWI2ZC00NDdjLThjMzQtZjFmMTM5MzUyYjY3IiwibmJmIjoxNzk0ODI4OTYwLCJyZWYiOiJyZWZzL2hlYWRzL21haW4iLCJyZWZfcHJvdGVjdGVkIjoiZmFsc2UiLCJyZWZfdHlwZSI6ImJyYW5jaCIsInJlcG9zaXRvcnkiOiJpdHNIYWRkYWQvYnJhZ3Byb29mIiwicmVwb3NpdG9yeV9pZCI6IjE0NTQ2MjExODMiLCJyZXBvc2l0b3J5X293bmVyIjoiaXRzSGFkZGFkIiwicmVwb3NpdG9yeV9vd25lcl9pZCI6IjExNDczMjYxIiwicmVwb3NpdG9yeV92aXNpYmlsaXR5IjoicHVibGljIiwicnVuX2F0dGVtcHQiOiIxIiwicnVuX2lkIjoiNDM4NTcwNzAyMTYiLCJydW5fbnVtYmVyIjoiMjQiLCJydW5uZXJfZW52aXJvbm1lbnQiOiJnaXRodWItaG9zdGVkIiwic2hhIjoiZWFhZmZmZmFmNTIyNTVkMWI3N2RjNGFhY2ZmZGZhZjM1M2YwYzEyYyIsInN1YiI6InJlcG86aXRzSGFkZGFkQDExNDczMjYxL2JyYWdwcm9vZkAxNDU0NjIxMTgzOnJlZjpyZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvdyI6InJlcG9ydCIsIndvcmtmbG93X3JlZiI6Iml0c0hhZGRhZC9icmFncHJvb2YvLmdpdGh1Yi93b3JrZmxvd3MvcmVwb3J0LnltbEByZWZzL2hlYWRzL21haW4iLCJ3b3JrZmxvd19zaGEiOiJlYWFmZmZmYWY1MjI1NWQxYjc3ZGM0YWFjZmZkZmFmMzUzZjBjMTJjIn0.jrThFWIRu2-6koSeHTX12l9tP1O8AqgDcL_yZt46EqdZW3Z3ie6HCBx_wFiRSMkbyXdo8NthySQnDtxRlewh90GgWCGn6tZ9IVRTL-sDY93_ZMEJ4Thpu_MQ-ucWQk5oOEJ4G4lHEhrnhphJmd5UaliAGxuaskcL09ZvGE1fsJ_KNMVS_HgIi-I-fusTdj0WW3jv-rJHuaJwkvjhalnfjJStvsUqzUbM0Cov_LIv7oczIDFI06ov7DOauRszOXd1aMINyziR_4aJbUXwHjWfDN_uHhP1xOrPzdOsKGi7c3jOVZ3oKDU6eXXnM3tWTTLmZnbsP0fWcDTYAVuYTdoO1w"}