Astronomer MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ASTRONOMER_API_KEY | No | Optional API key / Bearer token if authentication is enabled. | |
| ASTRONOMER_API_URL | No | Base URL for the Astronomer Rails API (v1). | http://localhost:3000/api/v1 |
| ASTRONOMER_TIMEOUT_MS | No | HTTP request timeout in milliseconds. | 60000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| searchC | Unified cross-catalog semantic or keyword search across star systems and celestial bodies in the Astronomer comparative astrophysics manifold. |
| find_counterpartsA | Find nearest astrophysical counterparts to a specified star system or celestial body using 1024-dimensional pgvector cosine distance. |
| list_cosmic_structuresA | List cosmic structures (galaxies, dwarf galaxies, galaxy clusters) registered in Astronomer with star system counts. |
| get_cosmic_structureC | Retrieve details of a single cosmic structure (galaxy/cluster) including its star systems. |
| create_cosmic_structureC | Create a new cosmic structure (galaxy or cluster) record in the catalog. |
| update_cosmic_structureB | Update an existing cosmic structure's name or description. |
| delete_cosmic_structureB | Delete a cosmic structure and its cascaded star systems and celestial bodies. |
| upsert_cosmic_structures_batchA | Batch insert or update cosmic structures matching case-insensitively on name. |
| populate_cosmic_structuresC | Trigger LLM discovery to populate major galaxies and galaxy clusters with astrophysical descriptions. |
| populate_cosmic_structure_star_systemsC | Discover and populate star systems for a specific cosmic structure via LLM generation. |
| list_star_systemsB | List and filter star systems with astrophysical themes, celestial body counts, and vector embedding status. |
| get_star_systemA | Retrieve full profile of a star system including cosmic structure, thematic astrophysical tags, and celestial bodies. |
| create_star_systemC | Create a new star system record associated with a cosmic structure. |
| update_star_systemC | Update an existing star system's attributes, cosmic structure, or thematic tags. |
| delete_star_systemB | Delete a star system and its cascaded celestial bodies. |
| upsert_star_systems_batchC | Batch insert or update star systems scoped to a specific cosmic structure. |
| generate_star_system_embeddingB | Calculate 1024-dimensional vector embedding for a star system using the configured embedding model. |
| populate_star_system_celestial_bodiesA | Discover and generate celestial bodies (planets, moons) for a star system via LLM extraction. |
| populate_star_systems_bulkB | Trigger bulk LLM star system discovery across all cosmic structures or a single cosmic structure. |
| list_celestial_bodiesB | List and filter celestial bodies (exoplanets, moons, dwarf planets) with physical/orbital themes and embedding metadata. |
| get_celestial_bodyB | Retrieve details of a celestial body including its structured themes and associated star system/cosmic structure. |
| create_celestial_bodyC | Create a new celestial body record associated with a star system. |
| update_celestial_bodyC | Update an existing celestial body's attributes, star system, or thematic tags. |
| delete_celestial_bodyC | Delete a celestial body record. |
| upsert_celestial_bodies_batchC | Batch insert or update celestial bodies scoped to a specific star system. |
| generate_celestial_body_embeddingB | Calculate 1024-dimensional vector embedding for a celestial body record. |
| populate_celestial_bodies_bulkB | Trigger bulk LLM celestial body discovery across all star systems or a single star system. |
| compute_clustersB | Compute live connected-components vector clusters for StarSystems or CelestialBodies across cosmic structures without modifying the database. |
| create_cluster_snapshotB | Compute connected-components clustering and freeze it immediately into an immutable database snapshot. |
| list_cluster_snapshotsC | List frozen archetype cluster snapshots. |
| get_cluster_snapshotA | Retrieve details of a frozen cluster snapshot including member groups and generated reports. |
| delete_cluster_snapshotB | Delete a frozen cluster snapshot along with its cascaded cluster groups and synthesis reports. |
| list_cluster_groupsB | List all archetype cluster groups belonging to a specific frozen snapshot. |
| get_cluster_groupA | Retrieve details of a specific archetype cluster group with all member star systems or celestial bodies. |
| list_cluster_reportsC | List generated multi-phase comparative astrophysics and celestial body manifold synthesis reports. |
| get_cluster_reportB | Retrieve complete scholarly astrophysics report content, progress percentage, markdown monograph, and intermediate summaries. |
| create_cluster_reportC | Initiate a 2-Phase Map-Reduce synthesis report on a frozen cluster snapshot. |
| delete_cluster_reportA | Delete a synthesis report along with its intermediate summaries and sub-reports. |
| generate_deep_synthesisB | Initiate a 3-Phase Hierarchical Deep Synthesis monograph, reusing Phase 1 summaries from a completed parent report. |
| list_report_summariesB | List all Phase 1 per-cluster analyses belonging to a synthesis report. |
| get_report_summaryC | Retrieve a single Phase 1 per-cluster scholarly summary. |
| list_report_sub_reportsB | List all Phase 2 intermediate batch analyses belonging to a detailed synthesis report. |
| get_report_sub_reportC | Retrieve a single Phase 2 batch analysis. |
| list_jobsB | List recent asynchronous background jobs (embedding calculations, LLM discoveries, synthesis reports). |
| get_job_statusB | Check the status, progress, and result of an ActiveJob/Sidekiq background task. |
| wait_for_jobA | Poll a background job until completion or failure with configurable timeout. |
| get_platform_statusA | Get overall platform health, catalog entity counts, embedding coverage stats, and active LLM configuration. |
| get_settingsB | Get embedding completion metrics for StarSystems and CelestialBodies, active embedding/LLM parameters, and context window presets. |
| update_context_windowC | Dynamically update the active LLM context window token size. |
| trigger_bulk_embeddingsB | Enqueue bulk embedding generation for all StarSystems or CelestialBodies. |
| get_openapi_specA | Retrieve the raw OpenAPI 3.1 specification for the Astronomer API. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| comparative_astrophysics_analysis | Prompt template for comparing two star systems or celestial bodies across cosmic structures using astrophysical attributes, orbital dynamics, and semantic manifold distance. |
| astrophysical_cluster_synthesis | Prompt template to draft an academic astrophysical treatise based on Astronomer archetype clusters and frozen snapshots. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| platform-status | |
| cosmic-structures-catalog |
TDQS
Scored across 51 tools
Most tools are distinguishable by resource+action, but several families overlap heavily: populate_* vs upsert_*_batch vs create_* for the same entities, three separate embedding tools (generate_star_system_embedding, generate_celestial_body_embedding, trigger_bulk_embeddings), and compute_clusters vs create_cluster_snapshot vs create_cluster_report vs generate_deep_synthesis. Descriptions do help differentiate, but an agent has real risk of misselecting within these clusters.
Nearly everything follows snake_case verb_noun (list_/get_/create_/update_/delete_/populate_/generate_), which is predictable. Minor deviations like the bare 'search', 'find_counterparts', and 'compute_clusters' break the strict pattern slightly but remain readable.
51 tools is far beyond a comfortable surface for an agent to navigate. While the domain is broad (CRUD across three entities plus embeddings, clustering, reports, jobs, and settings), many tools are variants of each other (per-entity and bulk embedding/populate variants), pushing this into heavy territory.
The surface covers full lifecycle CRUD for cosmic structures, star systems, and celestial bodies, plus batch upserts, embeddings, clustering/snapshots, report generation, job polling, and settings. It is essentially exhaustive for the stated comparative-astrophysics domain with no obvious dead ends.