Skip to main content
Glama
mcp-server-ads

mcp-server-ads

by cbyrohl

mcp-server-ads

Python 3.11+ License: MIT

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.

demo_15fps_crf20.webm

Quick Start

Get an ADS API Token

  1. Create a free account at NASA ADS

  2. Log in and go to Settings > API Token

  3. 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-ads

Use --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-ads

This 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-ads

Running 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-ads

Related MCP server: nasa-ads-mcp

Configuration

Environment Variable

Required

Default

Description

ADS_API_TOKEN

Yes

—

API token from ADS

ADS_API_URL

No

https://api.adsabs.harvard.edu

API base URL (override for SciX)

Tools (11)

Tool

Description

ads_search

Search the ADS database with full query syntax, including citations(), references(), similar(), trending(), and reviews() operators

ads_bigquery

Search within a specific set of bibcodes (up to 2000)

Export & Metrics

Tool

Description

ads_export

Export records in 18+ formats (BibTeX, AASTeX, RIS, CSL, etc.)

ads_metrics

Compute citation metrics (h-index, g-index, citation counts, etc.)

Libraries

Tool

Description

ads_library

Manage libraries: list, get, create, edit, or delete saved paper collections

ads_library_documents

Manage documents and notes within a library: add/remove papers, set operations (union, intersection, difference, copy, empty), and note CRUD

Discovery & Resolution

Tool

Description

ads_resolve_links

Resolve available links for a paper (full text, data, etc.)

ads_object_search

Translate astronomical object names to ADS queries (SIMBAD/NED)

ads_citation_helper

Suggest papers that should be cited alongside a given set

ads_resolve_reference

Resolve free-text reference strings to ADS bibcodes

Network Visualization

Tool

Description

ads_network

Generate author collaboration or paper citation networks from a set of papers

Resources

URI

Description

ads://fields

Complete reference of searchable and returnable ADS fields

ads://syntax

ADS query syntax quick-reference with examples

ads://rate-limits

Live API rate-limit status

Prompts

Prompt

Description

literature_review

Multi-step literature review workflow for a research topic

citation_analysis

Citation network analysis workflow for a set of papers

generate_bibliography

Generate a formatted bibliography from search or bibcodes

Similar Projects

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-ads

License

MIT

Available Tools

11 tools
ads_bigqueryA
Read-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_helperA
Read-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_exportA
Read-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_metricsA
Read-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_networkA
Read-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_resolve_referenceA
Read-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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 11 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Provides 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.
      11
      10
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for the NASA Astrophysics Data System (ADS) enabling searches, paper retrieval, citation tracking, metrics, and interactive literature review prompts.
      -
    • A
      license
      B
      quality
      D
      maintenance
      MCP 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.
      23
      20 npm
      2
      BSD 3-Clause
    • A
      license
      A
      quality
      B
      maintenance
      A 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.
      13
      1
      MIT