Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ASTRONOMER_API_KEYNoOptional API key / Bearer token if authentication is enabled.
ASTRONOMER_API_URLNoBase URL for the Astronomer Rails API (v1).http://localhost:3000/api/v1
ASTRONOMER_TIMEOUT_MSNoHTTP 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

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
comparative_astrophysics_analysisPrompt template for comparing two star systems or celestial bodies across cosmic structures using astrophysical attributes, orbital dynamics, and semantic manifold distance.
astrophysical_cluster_synthesisPrompt template to draft an academic astrophysical treatise based on Astronomer archetype clusters and frozen snapshots.

Resources

Contextual data attached and managed by the client

NameDescription
platform-status
cosmic-structures-catalog

TDQS

B3.1/5.0

Scored across 51 tools

Disambiguation3/5

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.

Naming Consistency4/5

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.

Tool Count2/5

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.

Completeness5/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues