{"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":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":31,"wrote":0,"callsTried":5,"callsAnswered":5,"callContacts":["api.openalex.org"]},"history":[{"package":"openalex-research-mcp","version":"0.5.0","ranAt":"2026-11-16T11:40:45.407Z","outcome":"started","tools":31,"contacts":0,"flags":0,"serious":0,"toolsHash":"681f7841d6e84e80b302d2348007c303c1bb23999673fbc4e879ec3a7b8e03cf"}],"page":"https://bragproof.smaverk.com/r/openalex-research-mcp"}