HyperspaceDB MCP Server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CDE_API_KEY | No | Legacy API key for the cloud embedding endpoint. Can be used instead of YAR_API_KEY. | |
| YAR_API_KEY | No | API key for the cloud v5 embedding endpoint, used when running a local DB with cloud embeddings. | |
| HYPERSPACE_HOST | Yes | The HyperspaceDB host, e.g. 'the.yar.ink' for the managed SaaS or 'localhost:50051' for a local self-hosted instance. | |
| HYPERSPACE_API_KEY | Yes | API key used to authenticate with the HyperspaceDB gRPC engine. For local default auth, use 'I_LOVE_HYPERSPACEDB'. |
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 | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| hyperspace_search_textB | Search a |
| hyperspace_search_wassersteinA | Advanced Optimal Transport (Wasserstein) search inside |
| hyperspace_insert_textB | Store a new factual claim or memory: insert |
| hyperspace_create_collectionC | Setup new memory spaces (collections) with specific vector dimension, metric geometry, and quantization level. Returns the created collection config as JSON result. |
| hyperspace_graph_traverseA | Deep graph exploration starting from node |
| hyperspace_get_neighborsB | Explore local connectivity of a concept in the vector index graph. Requires |
| hyperspace_find_clustersA | Detect emergent structure/hierarchy in |
| hyperspace_analyze_geometryA | Calculate Gromov Delta-hyperbolicity either for a named |
| hyperspace_analyze_thought_stabilityA | Calculate Lyapunov Convergence of a |
| hyperspace_trigger_reconsolidationB | AI Sleep Mode: trigger Flow Matching on the server to optimize the geometric representation of concepts in |
| hyperspace_freeze_collectionB | Freeze a collection to make it read-only, preventing new inserts. Returns ok/error status object. |
| hyperspace_unfreeze_collectionA | Unfreeze a previously frozen collection to allow inserts again. Returns ok/error status object. |
| hyperspace_list_collectionsA | List all active collections. Returns a JSON array of objects, each with {name, dimension, metric, count} metadata fields. |
| hyperspace_get_statsB | Get detailed statistics for the named |
| hyperspace_cache_statsB | Get cache statistics (hits, misses, policy, etc.) for a specific collection's L0 Hot Tier Cache. Returns stats object as JSON result. |
| hyperspace_cache_clearB | Clear / purge all items in the L0 Cache for a specific collection. Returns ok/error status object. |
| hyperspace_cache_configB | Update L0 Cache configuration (eviction policy, ANN threshold) for a specific collection. Returns updated config as JSON result. |
| hyperspace_delete_collectionB | Permanently delete a collection and all of its vectors. Returns a result object with ok status or error. |
| hyperspace_delete_pointsC | Delete a single vector point from a collection by its ID. Returns a result object with ok status or error. |
| hyperspace_get_pointsB | Retrieve vector coordinate and metadata for a list of point IDs. Requires |
| hyperspace_rebuild_indexB | Rebuild and optimize the HNSW index on the server for a specific collection. Returns rebuild status/result as JSON. |
| hyperspace_vacuumB | Perform vacuuming on the database to permanently purge deleted vectors and reclaim disk space. Returns vacuum status and reclaimed-space result. |
| hyperspace_get_subsumption_treeB | Retrieve the Lorentz hierarchy subsumption tree starting from a given |
| hyperspace_get_concept_parentsB | Retrieve parent concepts in a hierarchical collection. Requires |
| hyperspace_explore_graphB | Traverse the graph and return nodes and links in a format ready for visualization. Requires |
| hyperspace_predict_momentumB | Forecast future agent thought paths using Koopman momentum extrapolation. Requires |
| hyperspace_get_trust_scoreC | Evaluate stability and trust score for a given thought trajectory path. Requires |
| hyperspace_query_plannerA | Enterprise RAG Query Planner. Evaluates user intent before vector search: detects ambiguous/underspecified questions (requesting multiple-choice user clarification) and decomposes multi-part queries into parallel sub-queries. |
| clarify_and_split_intentB | Alias for hyperspace_query_planner. Evaluates intent clarity, asks clarifying questions if ambiguous, and splits multi-part questions into isolated search queries. |
| hyperspace_linkB | Create an explicit directed, labeled, weighted relationship edge between two entities in the native CSR vector-graph. Parameters: |
| hyperspace_link_batchB | Bulk-insert explicit directed edges in CSR graph atomically. Parameters: |
| hyperspace_unlinkC | Delete an explicit directed relationship edge with zero-lag invalidation. Parameters: |
| hyperspace_induce_edgesC | Declaratively induce explicit graph edges from existing document metadata attributes (path_hierarchy, foreign_key, exact_match). Parameters: |
| hyperspace_verify_generationC | Tribunal Router (Mathematical Anti-Hallucination Guardrail): Verify whether an LLM generated answer stays within the geometric entailment cones and geodesic boundaries of retrieved context IDs. |
| hyperspace_pdk_extensionB | Invoke a native HyperspaceDB PDK Extension (e.g. 'git_ast' for AST codebase indexing & blast radius, 'embed' for structure-aware Markdown ingestion, 'shield', 'chem', 'bio', 'fin', 'sec', 'legal', 'onto'). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 35 tools
Most tools are distinct, but there is direct duplication between hyperspace_query_planner and clarify_and_split_intent, which is explicitly an alias. Graph exploration tools (explore_graph, graph_traverse, get_neighbors, find_clusters) also overlap enough to cause misselection, despite descriptions helping.
Almost all tools follow a clear hyperspace_verb_noun snake_case pattern. The only notable deviation is clarify_and_split_intent, which lacks the server prefix and is an alias for another tool.
35 tools is heavy for the apparent scope, with many niche analysis, cache, and PDK extension operations. Several advanced tools feel bolted on rather than essential to the core vector-graph/memory workflow.
Coverage is broad: collections, points, text search, explicit and induced graph edges, traversal, clustering, cache, maintenance, and verification. Minor gaps exist around updating existing point content and updating collection configuration, but most workflows have a path.