# MANNA

MANNA is a Claude Code MCP server providing direct access to IVOA astronomical archives. Queries datasets via ADQL, searches images, and resolves celestial target names through Sesame.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: NSF-Simons-CosmicAI-Institute
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NSF-Simons-CosmicAI-Institute/manna
- Updated: 2026-10-28
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/manna

## What it does

The server connects clients to NOIRLab Astro Data Lab, ALMA, CADC, ESO, Gaia, SDSS, and other archives indexed in the IVOA registry. Built-in tools handle TAP queries, SIA image lookups, cone searches, and automated workflows that identify targets and query services in a single turn.

Compact query results return inline. Whenever a TAP query exceeds inline limits, MANNA spawns an asynchronous job, sending back the download URL along with a `pyvo` code snippet. The server remains stateless across requests. It also feeds curated archive caveats into the prompt so the LLM avoids invalid columns and syntax quirks.

Running the tool requires Python 3.12 or newer. The initial launch downloads `astropy` and `pyvo`, which introduces a delay on the first execution. Archive visibility and payload limits adjust via `MANNA_*` environment variables, including `MANNA_ARCHIVES` and `MANNA_INLINE_ROW_LIMIT`.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `MANNA_ARCHIVES`, `MANNA_ALLOWED_HOSTS`, `MANNA_LOG_LEVEL`, `MANNA_INLINE_ROW_LIMIT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env MANNA_ARCHIVES=<MANNA_ARCHIVES> --env MANNA_ALLOWED_HOSTS=<MANNA_ALLOWED_HOSTS> --env MANNA_LOG_LEVEL=<MANNA_LOG_LEVEL> --env MANNA_INLINE_ROW_LIMIT=<MANNA_INLINE_ROW_LIMIT> --transport stdio manna -- uvx manna-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from manna-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add manna --env MANNA_ARCHIVES=<MANNA_ARCHIVES> --env MANNA_ALLOWED_HOSTS=<MANNA_ALLOWED_HOSTS> --env MANNA_LOG_LEVEL=<MANNA_LOG_LEVEL> --env MANNA_INLINE_ROW_LIMIT=<MANNA_INLINE_ROW_LIMIT> -- uvx manna-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from manna-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "manna": {
            "command": "uvx",
            "args": [
                "manna-mcp"
            ],
            "env": {
                "MANNA_ARCHIVES": "<MANNA_ARCHIVES>",
                "MANNA_ALLOWED_HOSTS": "<MANNA_ALLOWED_HOSTS>",
                "MANNA_LOG_LEVEL": "<MANNA_LOG_LEVEL>",
                "MANNA_INLINE_ROW_LIMIT": "<MANNA_INLINE_ROW_LIMIT>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from manna-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "manna": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "manna-mcp"
            ],
            "env": {
                "MANNA_ARCHIVES": "<MANNA_ARCHIVES>",
                "MANNA_ALLOWED_HOSTS": "<MANNA_ALLOWED_HOSTS>",
                "MANNA_LOG_LEVEL": "<MANNA_LOG_LEVEL>",
                "MANNA_INLINE_ROW_LIMIT": "<MANNA_INLINE_ROW_LIMIT>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from manna-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MANNA_ARCHIVES=<MANNA_ARCHIVES> -e MANNA_ALLOWED_HOSTS=<MANNA_ALLOWED_HOSTS> -e MANNA_LOG_LEVEL=<MANNA_LOG_LEVEL> -e MANNA_INLINE_ROW_LIMIT=<MANNA_INLINE_ROW_LIMIT> manna uvx manna-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from manna-mcp <command>

## When to use it
- execute ADQL queries across IVOA-compliant TAP endpoints
- locate astronomical images by position using SIA protocols
- resolve astronomical object names into coordinates with Sesame
- run cone searches over remote catalogs
- generate pyvo snippets to retrieve asynchronous query tables

## Example prompts
- Resolve target coordinates for M31 and search for observations in CADC
- Run an ADQL query against Gaia DR3 for high proper motion stars around target coordinates
- Find SIA image records for the Crab Nebula in the ESO archive

## Similar
- [Cosmik — Live Space Data](https://affpapa.org/en/nevibecode/mcp/cosmik-live-space-data.md) — MCP server · 147 installs
- [astropy](https://affpapa.org/en/nevibecode/skills/astropy.md) — skill · 2100 installs
- [agenttime](https://affpapa.org/en/nevibecode/mcp/agenttime.md) — MCP server · 1319 installs
- [astroai-research](https://affpapa.org/en/nevibecode/skills/astroai-research.md) — skill · ★ 409 repo stars
- [gaia-submission](https://affpapa.org/en/nevibecode/skills/gaia-submission.md) — skill · 436 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
