MANNA — Claude Code MCP server: what it does, how to install
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.
MIT ★ 5 updated 2026-10-28
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-mcpWhat MANNA 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.
What it helps with
- 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 for the agent
- 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
How to install MANNA
Platform CLI
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-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from manna-mcp <command>
Platform CLI
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-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from manna-mcp <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
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-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from manna-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MANNA
How to install MANNA in Claude Code?
Run claude mcp add manna -- uvx manna-mcp. To set environment variables during registration, use `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`.
What does MANNA do?
It exposes standardized IVOA interfaces to AI coding clients, letting models query astronomical registries, resolve target names, and search remote telescope data.
What is required to run MANNA?
A runtime environment with Python 3.12 or later and uvx. The process downloads astropy and pyvo dependencies during its first execution.