mcp-server-ads
mcp-server-ads is an MCP server for NASA's Astrophysics Data System (ADS), enabling natural language access to astrophysics literature search, citation analysis, and paper management.
Search papers (
ads_search): Query the ADS database using full query syntax including field searches, boolean operators, and functional operators likecitations(),references(),trending(),reviews(), andsimilar()Bulk bibcode search (
ads_bigquery): Filter, sort, or retrieve metadata for a known set of up to 2000 bibcodesExport citations (
ads_export): Export paper records in 18+ formats including BibTeX, AASTeX, RIS, EndNote, CSL-JSON, VOTable, and moreCompute metrics (
ads_metrics): Calculate h-index, g-index, i10-index, citation/read counts, and time-series histograms for a set of papersManage libraries (
ads_library): List, create, edit, delete, and retrieve saved paper collectionsManage library documents (
ads_library_documents): Add/remove papers, perform set operations (union, intersection, difference), and manage notes on individual papersResolve paper links (
ads_resolve_links): Look up available links for a paper including full text, datasets, citations, and referencesAstronomical object search (
ads_object_search): Translate object names (e.g., 'M31', 'Crab Nebula') into ADS search queries via SIMBAD/NEDCitation suggestions (
ads_citation_helper): Discover papers frequently co-cited with a given bibliography that are not yet includedResolve references (
ads_resolve_reference): Match free-text reference strings to ADS bibcodesNetwork visualization (
ads_network): Generate author collaboration or paper citation cluster networks from a set of papers
Provides tools for searching the NASA Astrophysics Data System (ADS) database, traversing citation graphs, computing citation metrics, resolving paper links and references, and managing research libraries and paper collections.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-server-ads Find the most cited papers on dark matter from the last five years."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-server-ads
A powerful MCP server for the NASA Astrophysics Data System (ADS) — the primary database for astrophysics literature. Search papers, traverse citation graphs forward and backward, export BibTeX, compute metrics, and manage reading lists, all through natural language. Works with Claude Desktop/Code, Cursor, OpenAI Codex, and any MCP-compatible client.
Quick Start
Get an ADS API Token
Create a free account at NASA ADS
Log in and go to Settings > API Token
Click Generate a new key and copy the token
Installation
No separate install step needed — the client configurations below use uvx to automatically fetch and run the server. Just pick your client and go. Requires Python 3.11+ and uv.
Claude Code
claude mcp add --scope user mcp-server-ads -e ADS_API_TOKEN=your-api-token-here -- uvx --from git+https://github.com/cbyrohl/mcp-server-ads mcp-server-adsUse --scope project instead to share the configuration via .mcp.json in your repo, or omit --scope for local (current project only).
Claude Desktop
Add to your Claude Desktop config:
{
"mcpServers": {
"ads": {
"command": "uvx",
"args": ["--from", "git+https://github.com/cbyrohl/mcp-server-ads", "mcp-server-ads"],
"env": {
"ADS_API_TOKEN": "your-api-token-here"
}
}
}
}Codex CLI
codex mcp add mcp-server-ads --env ADS_API_TOKEN=your-api-token-here -- uvx --from git+https://github.com/cbyrohl/mcp-server-ads mcp-server-adsThis installs to ~/.codex/config.toml (user-level, available across all projects). For project-scoped config, add the entry to .codex/config.toml in your project root instead.
Standalone / Python API
If you want to install the package directly (e.g. as a Python library or to run the server manually):
# Install with uv
uv tool install git+https://github.com/cbyrohl/mcp-server-ads
# Or with pip
pip install git+https://github.com/cbyrohl/mcp-server-adsRunning from Source
git clone https://github.com/cbyrohl/mcp-server-ads.git
cd mcp-server-ads
uv sync
# Run the server
ADS_API_TOKEN=your-token uv run mcp-server-adsRelated MCP server: nasa-ads-mcp
Configuration
Environment Variable | Required | Default | Description |
| Yes | — | API token from ADS |
| No |
| API base URL (override for SciX) |
Tools (11)
Search
Tool | Description |
| Search the ADS database with full query syntax, including |
| Search within a specific set of bibcodes (up to 2000) |
Export & Metrics
Tool | Description |
| Export records in 18+ formats (BibTeX, AASTeX, RIS, CSL, etc.) |
| Compute citation metrics (h-index, g-index, citation counts, etc.) |
Libraries
Tool | Description |
| Manage libraries: list, get, create, edit, or delete saved paper collections |
| Manage documents and notes within a library: add/remove papers, set operations (union, intersection, difference, copy, empty), and note CRUD |
Discovery & Resolution
Tool | Description |
| Resolve available links for a paper (full text, data, etc.) |
| Translate astronomical object names to ADS queries (SIMBAD/NED) |
| Suggest papers that should be cited alongside a given set |
| Resolve free-text reference strings to ADS bibcodes |
Network Visualization
Tool | Description |
| Generate author collaboration or paper citation networks from a set of papers |
Resources
URI | Description |
| Complete reference of searchable and returnable ADS fields |
| ADS query syntax quick-reference with examples |
| Live API rate-limit status |
Prompts
Prompt | Description |
| Multi-step literature review workflow for a research topic |
| Citation network analysis workflow for a set of papers |
| Generate a formatted bibliography from search or bibcodes |
Similar Projects
prtc/nasa-ads-mcp — ADS search, metrics, and library management
thostetler/scix-mcp — MCP server for the SciX/ADS API
blazickjp/arxiv-mcp-server — MCP server for arXiv paper search and retrieval
This server focuses on broad ADS API coverage, token-efficient output, and integration-tested reliability. Compared to arXiv-based tools, ADS enables forward/backward citation traversal (citations and references of any paper), though it is focused on astrophysics.
Development
# Install dev dependencies
uv sync
# Run tests
uv run pytest
# Lint
uv run ruff check src/ tests/
# Run the server locally
ADS_API_TOKEN=your-token uv run mcp-server-adsLicense
MIT
Available Tools
11 toolsads_bigqueryARead-only
Search within a specific set of bibcodes (big-query).
Useful for filtering, sorting, or retrieving metadata for a known set of papers. Provide up to 2000 bibcodes at once.
Inputs: bibcodes (required), query, fields, sort, +1 more. Returns: result
ads_citation_helperARead-only
Suggest papers that should be cited alongside the given set.
Given a set of bibcodes (e.g. from a paper's bibliography), the citation helper returns papers that are frequently co-cited with the input set but are not yet included.
Inputs: bibcodes (required). Returns: result
ads_exportARead-only
Export paper records in various citation formats.
Supports 18+ formats including BibTeX, AASTeX, RIS, EndNote, CSL-JSON, Dublin Core XML, VOTable, and more. Returns formatted citation text.
Inputs: bibcodes (required), format, sort, journalformat. Returns: result
ads_libraryA
Manage ADS libraries (saved paper collections).
Actions:
list: List all your libraries
get: Get a library's details and bibcodes (requires library_id)
create: Create a new library (requires name)
edit: Edit library metadata (requires library_id)
delete: Permanently delete a library (requires library_id)
Inputs: action (required), library_id, name, description, +4 more. Returns: result
ads_library_documentsA
Manage documents and notes within an ADS library.
Document actions:
add/remove: Add or remove bibcodes from the library
union/intersection/difference/copy/empty: Set operations with other libraries
Note actions:
get_notes: List all notes in the library
add_note/edit_note/delete_note: Manage notes on individual papers
Inputs: library_id (required), action (required), bibcodes, libraries, +2 more. Returns: result
ads_metricsARead-only
Compute citation metrics for a set of papers.
Returns h-index, g-index, i10-index, citation counts, read counts, and time-series histograms. Works for 1 to ~2000 bibcodes.
Inputs: bibcodes (required), types. Returns: result
ads_networkARead-only
Generate a collaboration or citation network from a set of papers.
author: Groups authors who frequently co-author together
paper: Clusters papers by shared references/citations to reveal sub-topics
Inputs: bibcodes (required), type. Returns: result
ads_object_searchARead-only
Translate astronomical object names to ADS search queries via SIMBAD/NED.
Provide object identifiers (e.g. 'M31', 'Crab Nebula', 'NGC 1234') and get back an ADS query that matches papers about those objects.
Inputs: identifiers (required). Returns: result
ads_resolve_linksBRead-only
Resolve available links for a paper (full text, data, citations, etc.).
Inputs: bibcode (required), link_type. Returns: result
ads_resolve_referenceARead-only
Resolve free-text reference strings to ADS bibcodes.
Accepts human-readable reference strings and attempts to match them to records in ADS. Useful for identifying papers from partial citations.
Inputs: references (required). Returns: result
ads_searchARead-only
Search the NASA ADS database.
Supports the full ADS query syntax including field-qualified searches, boolean operators, and functional operators.
Common query patterns:
author:"Einstein, A" year:1905
title:"dark matter" property:refereed
abs:"gravitational waves" database:astronomy
To find citations and references of a paper:
citations(bibcode:2016PhRvL.116f1102A) — papers that cite it
references(bibcode:2016PhRvL.116f1102A) — papers it cites
Other functional operators:
trending(abs:"exoplanet") — trending papers
reviews(abs:"dark matter") — review articles
useful(bibcode:2016PhRvL.116f1102A) — related useful papers
similar(bibcode:2016PhRvL.116f1102A) — similar papers
Inputs: query (required), fields, sort, rows, +1 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool has a clearly distinct purpose with no significant overlap. The tools cover different aspects of the ADS ecosystem: searching (ads_search, ads_bigquery), citation analysis (ads_citation_helper, ads_metrics), library management (ads_library, ads_library_documents), network analysis (ads_network), reference resolution (ads_resolve_reference, ads_resolve_links), object translation (ads_object_search), and export (ads_export). An agent can easily distinguish between them based on their specific functions.
All tool names follow a consistent 'ads_' prefix with descriptive snake_case suffixes (e.g., ads_search, ads_metrics, ads_library). This pattern is maintained across all 11 tools, making them predictable and easy to understand. The naming convention clearly indicates they belong to the same server and domain.
With 11 tools, this server is well-scoped for interacting with the NASA ADS database. The count is appropriate as it covers a comprehensive range of operations from basic searching to advanced analysis and management, without being overwhelming. Each tool serves a distinct and necessary function in the domain of academic paper discovery and analysis.
The tool set provides complete coverage for the ADS domain, including search (ads_search, ads_bigquery), citation management (ads_citation_helper, ads_metrics, ads_resolve_reference), library CRUD operations (ads_library, ads_library_documents), network analysis (ads_network), object translation (ads_object_search), link resolution (ads_resolve_links), and export (ads_export). There are no obvious gaps; agents can perform end-to-end workflows from discovery to analysis and organization.
Maintenance
Related MCP Connectors
Academic research MCP server for paper search, citation checks, graphs, and deep research.
NASA ADS — the Astrophysics Data System, api.adsabs.harvard.edu.
MCP server for aerospace calculations: orbital mechanics, ephemeris, DSN operations, ...
Peer-reviewed scientific paper & arXiv preprint search MCP with citations, abstracts & PDF links.
Related MCP Servers
- AlicenseAqualityBmaintenanceProvides seamless access to the NASA Astrophysics Data System (ADS) for searching astronomical papers, tracking citations and metrics, managing paper libraries, and exporting BibTeX references through natural language conversation.1110MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for the NASA Astrophysics Data System (ADS) enabling searches, paper retrieval, citation tracking, metrics, and interactive literature review prompts.-
- AlicenseBqualityDmaintenanceMCP server that provides tools to query 17+ astronomical databases (e.g., SIMBAD, VizieR, Gaia) via HTTP/TAP APIs, enabling AI applications to access astronomical data through natural language.2320 npm2BSD 3-Clause
- AlicenseAqualityBmaintenanceA local, open-source MCP server that wraps astronomy data services (SIMBAD, JPL Horizons, VizieR, etc.) behind a conversational interface, enabling AI assistants to answer astronomy questions with real, typed, and provenance-tracked data.131MIT