{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_ua4hys3upncj","handle":"smos-mcp","url":"https://wellknown.network/agents/smos-mcp","links":{"self":"https://wellknown.network/agents/smos-mcp/record.json","html":"https://wellknown.network/agents/smos-mcp","markdown":"https://wellknown.network/agents/smos-mcp/record.md","api":"https://wellknown.network/api/v1/agents/smos-mcp","status":"https://wellknown.network/api/v1/agents/smos-mcp/status","claim":"https://wellknown.network/agents/smos-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/smos-mcp/claim.json","badge":"https://wellknown.network/agents/smos-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:smos-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"smos-mcp","summary":"Semantic Memory Operating System — persistent memory MCP server for Claude Code","description":"<h1 align=\"center\">SMOS</h1>\n\n<p align=\"center\"><strong>Semantic Memory Operating System for Claude Code</strong></p>\n\n<p align=\"center\">\n  Compress files out of context. Query knowledge by meaning. Persist across sessions.\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/Witchd0ct0r/Semantic_Memory_Operating_System_SMOS/stargazers\"><img src=\"https://img.shields.io/github/stars/Witchd0ct0r/Semantic_Memory_Operating_System_SMOS?style=flat&color=blue\" alt=\"Stars\"></a>\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/github/license/Witchd0ct0r/Semantic_Memory_Operating_System_SMOS?style=flat\" alt=\"License\"></a>\n  <a href=\"https://pypi.org/project/smos-mcp/\"><img src=\"https://img.shields.io/pypi/v/smos-mcp?style=flat\" alt=\"PyPI\"></a>\n  <img src=\"https://img.shields.io/badge/python-3.10%2B-blue?style=flat\" alt=\"Python\">\n</p>\n\n<p align=\"center\">\n  <a href=\"#the-problem\">Problem</a> •\n  <a href=\"#how-it-works\">How it works</a> •\n  <a href=\"#compression-in-practice\">In practice</a> •\n  <a href=\"#repository-ingestion\">Repo ingestion</a> •\n  <a href=\"#real-world-test--smos-analyzed-itself\">Self-test</a> •\n  <a href=\"#install\">Install</a> •\n  <a href=\"#benchmarks\">Benchmarks</a> •\n  <a href=\"#example-use-cases\">Examples</a> •\n  <a href=\"#tools\">Tools</a> •\n  <a href=\"#configuration\">Config</a> •\n  <a href=\"#update\">Update</a> •\n  <a href=\"#uninstall\">Uninstall</a>\n</p>\n\n---\n\n## The problem\n\nEvery file Claude reads stays in the context window until the session ends. On a 20-file codebase, by the time Claude reaches synthesis it's carrying 40,000+ tokens of raw source — most of which it already processed, will never need again verbatim, and is paying for on every single API call.\n\n**Caveman** compresses what Claude *says*. **SMOS** compresses what Claude *holds* — the files, the prior analysis, the context window itself.\n\n---\n\n## How it works\n\nSMOS is an MCP server that gives Claude a persistent memory layer: FAISS vector search + SQLite, powered by a local LLM (qwen2…","publisher":null,"homepage":"https://github.com/Witchd0ct0r/Semantic_Memory_Operating_System_SMOS","repository":"https://github.com/Witchd0ct0r/Semantic_Memory_Operating_System_SMOS","version":"0.1.4","license":"MIT","protocols":["mcp"],"tags":["claude","mcp","memory","semantic","ai","llm"],"pricing":null,"endpoints":[{"url":"pypi:smos-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"knowledge.memory","name":"Agent Memory","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.825,"provenance":"derived"},{"slug":"data.database","name":"Databases","confidence":0.768,"provenance":"derived"}],"categories":["data","dev","knowledge"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"smos-mcp","registry":"pypi","observedAt":"2026-09-10T12:23:37.362Z","publishedAt":"2026-06-23T07:56:48.922755Z","latestVersion":"0.1.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"smos-mcp","url":"https://pypi.org/project/smos-mcp/","firstSeenAt":"2026-09-10T12:22:41.102Z","fetchedAt":"2026-09-10T12:22:41.102Z","normalizedAt":"2026-09-10T12:22:41.102Z"}]},"firstSeenAt":"2026-09-10T12:22:41.102Z","updatedAt":"2026-09-10T12:23:37.362Z"}