SilvaLabs
io.github.opensylva/silvalabs · v1.0.1 · MCP 2025-11-25
Personal knowledge base MCP: agents read only materials you open.
Reachability
reachable
checked 2026-11-21 05:32 UTC
Registry status active
Tools pinned 17
8dbd05c0a200
Tools last changed
unchanged since first capture 2026-11-21
Provenance
Registry namespace io.github.opensylva
(GitHub-account verified by the official registry)
Remote endpoints
https://mcp.silvalabs.app/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-21 05:32 | first capture | 17 tools pinned |
Pinned tool definitions (17)
| Tool | Description |
|---|---|
| list_collections | When to use: folder tree / find which folder exists. Not for docs inside a folder (get_index), not for keyword search (search_docs), not for a pasted workset (get_workset). List the Silvalabs folder tree for the agent: every node on the... |
| get_index | When to use: list docs in one known folder (or unfiled). Not for folder tree (list_collections), not for keyword search across folders (search_docs), not for a workset id (get_workset). Table of contents for one folder: only docs with... |
| get_workset | When to use: only with a workset UUID / silvalabs:workset/… paste. Not a folder (get_index), not folder tree (list_collections), not keyword search (search_docs). Flat list of docs in one Silvalabs workset (a temporary task selection,... |
| get_doc | Read one document: metadata + compact brief/TOC by default to save context. Do NOT use view='full' unless you specifically need the complete raw text or code. Prefer reading specific sections via get_doc_section using the chunk_index or... |
| create_doc | Create a new Silvalabs library card from the agent (needs API key scope ingest:write). Accepts markdown text OR a http(s) URL — not both. Files/PDF/DOCX uploads are NOT supported; if you have a file, save a link (url) instead.... |
| update_agent_md | Update working agent notes (artifact agent_md) only on cards created by the agent (source_type=api). Human url/file cards → forbidden. Does NOT replace the source text (clean_md). Needs ingest:write. Pass id as UUID or... |
| update_doc_body | Replace the document body (clean_md) only on cards created by the agent (source_type=api). Human url/file cards → forbidden. Needs ingest:write. PUT /api/v1/source-items/{id}/agent/clean-md base_fingerprint is REQUIRED — take... |
| delete_doc | Write: soft-delete an agent-owned doc/card (source_type=api) only. Human url/file cards → forbidden via MCP. After success the doc is no longer visible to the agent (soft-delete, not a hard wipe). DELETE /api/v1/source-items/{id}/agent... |
| get_doc_section | Read one section of a document from the index (FULL_TEXT_CHUNKS). Use chunk_index or heading from get_doc toc — prefer this over view=full. heading match is fuzzy (case-insensitive; leading # ignored; path leaf / segment). If the index... |
| search_docs | When to use: keyword/hybrid search when the folder is unknown or the question spans folders. Not for browsing one known folder (get_index), not for folder tree (list_collections), not for a workset list (get_workset). Prefer... |
| get_procedure | Read-only: procedure overview — status, current step summary, next_action (needs scenario:execute). Not a single-step body (use view_step). Never invent attempt_id; follow next_action. Without grant you may read but cannot claim; with... |
| view_step | Read-only: current or given procedure step plus previous_attempts; follow next_action. Omit step_id for the current step. Pass attempt_id only for your own attempt. Does not claim or mutate; use take_step / complete_step / block_step to... |
| take_step | Write: claim a WAITING_AGENT step (needs grant). Returns attempt_id; follow next_action. For an already RUNNING step use resume_step. Do not invent attempt ids. Optional expected_*_revision for optimistic concurrency (stale → conflict). |
| resume_step | Write: resume or take over a RUNNING step (needs grant). Returns attempt_id; follow next_action. Set confirm_takeover=true only for another agent's RUNNING step. For WAITING_AGENT use take_step. Optional expected_*_revision for... |
| complete_step | Write: successfully finish your attempt_id (scenario:execute). For failure/blocker use block_step instead. report = short human-readable summary; outputs = flat key/values (string|number|boolean|null) only. Grant required unless... |
| block_step | Write: block your attempt with a reason; procedure becomes WAITING_HUMAN (needs grant). Then run await_human: one block, then up to 3 poll retries spaced by retry_after, then tell the user. Use complete_step to finish successfully instead. |
| await_human | Wait for human decision on WAITING_HUMAN (scenario:execute + grant). Modes: block (long-poll up to timeout_s, default/max 90 — always pass timeout_s=90), poll (one shot), peek (one shot). Pass since_version from the wait_human response... |
Get alerted when this changes.
Email the moment io.github.opensylva/silvalabs drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.github.opensylva/silvalabs)
Maintain this server? Add the badge to your README. It links your users to this live status page.