NASA Exoplanet Archive MCP Server

An MCP server that gives AI assistants direct access to NASA's Exoplanet Archive — the authoritative database of every confirmed exoplanet, candidate planet, and host star. Built on the archive's TAP (Table Access Protocol) service with full ADQL query support.

What can you do with it?

Once connected, you can ask your AI assistant questions like:

• "Find rocky planets in the habitable zone within 50 parsecs of Earth"

• "What do we know about the TRAPPIST-1 system?"

• "How many exoplanets has TESS discovered? Break it down by year."

• "Show me planets with atmospheric spectroscopy data available"

• "Compare the orbital parameters of all planets around Kepler-90"

• "What's the mass-radius distribution of transiting planets discovered after 2020?"

Here's a short video of it in action:

https://github.com/user-attachments/assets/ee4d6823-08fc-4c32-802f-c88d34032d3d

Available Tools

Quick Start

Prerequisites

• Python 3.10+

• uv (recommended) or pip

Install

git clone https://github.com/saikrmet/nasa-exoplanet-mcp.git
cd nasa-exoplanet-mcp
uv venv && uv pip install -e .

Run

Local (stdio) — for Claude Desktop, Claude Code, or any local MCP client:

nasa-exoplanet-mcp

Remote (HTTP) — for hosted deployments or remote MCP clients:

nasa-exoplanet-mcp serve
nasa-exoplanet-mcp serve --port 9000
nasa-exoplanet-mcp serve --host 127.0.0.1 --port 9000

The server will be available at http://your-host:8000/mcp.

Adding to your MCP client

Requires uv to be installed.

Claude Desktop

Open your claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "nasa-exoplanet": {
      "command": "uvx",
      "args": ["nasa-exoplanet-mcp"]
    }
  }
}

Restart Claude Desktop — the 6 exoplanet tools appear automatically.

Claude Code

claude mcp add nasa-exoplanet -- uvx nasa-exoplanet-mcp

Other MCP clients (Cursor, Windsurf, etc.)

Any client that supports stdio MCP servers works. Use uvx as the command and ["nasa-exoplanet-mcp"] as the args.

Remote deployment

If you're hosting the server (e.g. as a web app), start it with the serve subcommand:

nasa-exoplanet-mcp serve
nasa-exoplanet-mcp serve --host 0.0.0.0 --port 8000

Then point your MCP client at the URL:

{
  "mcpServers": {
    "nasa-exoplanet": {
      "url": "http://your-host:8000/mcp"
    }
  }
}

Tool Details

search_planets

The primary tool for most exoplanet questions. All parameters are optional and combinable.

get_planet

Returns comprehensive data for a single planet, organized into categories:

• Identity: name, host star, catalog IDs (TIC, Gaia, HD, HIP)

• Orbital: period, semi-major axis, eccentricity, inclination (with uncertainties)

• Physical: radius, mass, density, equilibrium temperature, insolation flux

• Transit: depth, duration, midpoint, impact parameter

• Stellar: spectral type, temperature, mass, radius, metallicity, age

• Discovery: method, year, facility, telescope, instrument

• System: number of planets/stars, distance, coordinates

• Data availability: counts of available spectra and observations

run_query

For queries that need full ADQL power. Examples:

-- Discovery statistics by year
SELECT disc_year, COUNT(*) AS n FROM pscomppars
WHERE disc_year IS NOT NULL GROUP BY disc_year ORDER BY disc_year DESC

-- Cone search: planets within 5 degrees of coordinates
SELECT pl_name, hostname, ra, dec, sy_dist FROM pscomppars
WHERE CONTAINS(POINT('ICRS',ra,dec), CIRCLE('ICRS',291.0,48.0,5.0))=1

-- TESS candidates with specific disposition
SELECT * FROM toi WHERE tfopwg_disp = 'PC' ORDER BY toi

-- Transit spectroscopy data for a planet
SELECT * FROM transitspec WHERE plntname = 'WASP-39 b'

-- Planets with both mass and radius measurements (for density studies)
SELECT pl_name, pl_rade, pl_bmasse, pl_dens FROM pscomppars
WHERE pl_rade IS NOT NULL AND pl_bmasse IS NOT NULL AND pl_dens IS NOT NULL

Data Source

This server queries the NASA Exoplanet Archive operated by IPAC at Caltech, under contract with NASA as part of the Exoplanet Exploration Program. The archive is the official NASA repository for exoplanet data and is updated weekly.

No API key is required. The archive is free and open to everyone.

Key tables accessible through this server:

Debugging

Use the MCP Inspector to test the server interactively:

npx @modelcontextprotocol/inspector uvx nasa-exoplanet-mcp

Server logs are written to stderr and won't interfere with the stdio transport.

Development

git clone https://github.com/saikrmet/nasa-exoplanet-mcp.git
cd nasa-exoplanet-mcp
uv venv && uv pip install -e ".[dev]"

# Run the server locally
nasa-exoplanet-mcp

# Open FastMCP dev inspector
mcp dev src/server.py:mcp

# Run tests
uv run pytest

# Lint
uv run ruff check src/

Testing

This project has three layers of tests:

The first two run without any setup. The LLM layer requires an API key.

Running the LLM scenario suite

These tests spin up an LLM agent that reads only the MCP tool descriptions, then verifies it correctly chooses tools and returns factually correct answers for 44 natural-language scenarios spanning 8 categories (simple lookup, filtered search, aggregation, multi-step queries, name resolution, error recovery, ambiguous questions, out-of-scope questions).

Install the LLM test dependencies:

uv pip install -e ".[llm]"

Configure your provider by creating a .env file at the project root (see .env.example). Supported providers:

# OpenAI
TEST_MODEL=openai:gpt-4o-mini
OPENAI_API_KEY=sk-...

# Anthropic
TEST_MODEL=anthropic:claude-haiku-4-5
ANTHROPIC_API_KEY=sk-ant-...

# Google Gemini
TEST_MODEL=google-gla:gemini-2.5-flash
GOOGLE_API_KEY=...

# Azure OpenAI
TEST_MODEL=azure:<your-deployment-name>
AZURE_OPENAI_API_KEY=...
AZURE_OPENAI_ENDPOINT=https://<resource>.cognitiveservices.azure.com
AZURE_OPENAI_API_VERSION=2025-04-01-preview

Run the suite:

pytest -m llm -v

If TEST_MODEL is not set, all LLM tests auto-skip — pytest still runs cleanly without them.

Adding new scenarios is straightforward — append a Scenario(...) entry to tests/llm/scenarios.py.

Project Structure

src/
  server.py            # FastMCP server instance and entry point
  client.py            # Async HTTP client for TAP and Alias APIs
  config.py            # Default columns, table metadata, valid enums
  errors.py            # Error types and TAP XML error parser
  tools/
    search.py          # search_planets
    planet.py          # get_planet
    names.py           # resolve_name
    schema.py          # list_tables, list_columns
    query.py           # run_query

License

MIT