Smart Connections MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SC_EMBED_MODEL | No | Override the embedding model (must be bge-micro-v2-family). Defaults to vault's configured model or TaylorAI/bge-micro-v2. | |
| SMART_VAULT_PATH | Yes | Absolute path to the Obsidian vault |
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 |
|---|---|
| get_similar_notesB | Find notes semantically similar to a given note using embeddings. Returns paths, similarity scores, and available blocks. |
| get_connection_graphA | Build a multi-level connection graph starting from a note, showing how notes are semantically connected. |
| search_notesA | Semantic search over the vault. Returns an envelope, not a bare array: |
| resolve_linkA | Turn a wikilink into a real file path, the way Obsidian would. Accepts bare text ("Throughline"), full link syntax ("[[Throughline|the CRM tracker]]"), or a path, and honors |
| get_backlinksA | Which notes explicitly link TO this one. This answers a different question from semantic search: backlinks are edges the author wrote by hand, so they show what the vault has decided this note is load-bearing for, regardless of whether the prose is similar. Use it to judge how important a note is, to find every place a decision is cited before changing it, and to trace how a concept actually gets used. Set include_outbound to also get what this note links to. |
| check_vault_integrityA | Find wikilinks that point at notes which do not exist. Git proves two machines agree on what is COMMITTED; it is silent about a note written outside the vault folder or written on another machine and never committed, and both fail the same silent way, as a link that resolves to nothing. Results are ranked by how many DISTINCT notes reference each missing target, because one note pointing at an unwritten note is an ordinary forward reference while six pointing at the same target means the vault treats it as real and it is either a concept that never got a home note or a note this machine cannot see. Run at session start alongside check_search_health. |
| check_search_healthA | Positive control for retrieval. Asks the index for notes that are known to be there, by their own titles, and reports whether they come back. Use this at session start, before trusting any empty search result, and any time a vault has been quiet or moved between machines. Returns |
| get_embedding_neighborsB | Find nearest neighbors for a given embedding vector. Useful for custom similarity searches. |
| get_note_contentA | Retrieve the full content of a note, optionally with specific blocks/sections extracted. |
| get_statsA | Get statistics about the Smart Connections knowledge base (total notes, blocks, embedding model, etc.). |
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 10 tools
Most tools are clearly distinct by resource and action, but get_similar_notes, search_notes, and get_embedding_neighbors all touch semantic retrieval and could cause misselection. The descriptions do a good job separating note-based, query-based, and vector-based retrieval, so only one or two tools are genuinely confusable.
Every tool follows a consistent snake_case verb_noun pattern: get_* for retrieval, search_notes for querying, resolve_link for resolution, and check_* for diagnostics. The naming is predictable and makes the toolset easy to navigate.
Ten tools is well-scoped for a read-only vault intelligence server. Each tool earns its place by covering a distinct retrieval, linking, analysis, or health-check function without unnecessary duplication.
The toolset covers the core domain well: semantic search, similar notes, backlinks, connection graphs, note content, wikilink resolution, and retrieval health. Minor gaps exist around explicit vault browsing/list-all-notes or index rebuilding, but agents can complete normal workflows without dead ends.