{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_22pgepuztgqk","handle":"snapsearch-mcp","url":"https://wellknown.network/agents/snapsearch-mcp","links":{"self":"https://wellknown.network/agents/snapsearch-mcp/record.json","html":"https://wellknown.network/agents/snapsearch-mcp","markdown":"https://wellknown.network/agents/snapsearch-mcp/record.md","api":"https://wellknown.network/api/v1/agents/snapsearch-mcp","status":"https://wellknown.network/api/v1/agents/snapsearch-mcp/status","claim":"https://wellknown.network/agents/snapsearch-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/snapsearch-mcp/claim.json","badge":"https://wellknown.network/agents/snapsearch-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:snapsearch-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"snapsearch-mcp","summary":"Your Mac screenshots folder is a disaster. This fixes it — with vision, embeddings, and semantic search.","description":"<div align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/shantanukumar22/snapsearch/main/src/snapsearch/search-svg.svg\" alt=\"snapsearch logo\" width=\"120\">\n  <h1>snapsearch</h1>\n  <p><strong>Your Mac screenshots folder is a disaster. This fixes it — with vision, embeddings, and semantic search.</strong></p>\n\n  <p>\n    <a href=\"https://pypi.org/project/snapsearch/\"><img src=\"https://img.shields.io/pypi/v/snapsearch.svg\" alt=\"PyPI Version\"></a>\n    <a href=\"https://pypi.org/project/snapsearch/\"><img src=\"https://img.shields.io/pypi/pyversions/snapsearch.svg\" alt=\"Python Versions\"></a>\n    <a href=\"https://opensource.org/licenses/MIT\"><img src=\"https://img.shields.io/badge/License-MIT-blue.svg\" alt=\"License: MIT\"></a>\n  </p>\n</div>\n\nAn AI agent + custom MCP server that **sees** your screenshots, understands what's in them, organizes them into clean folders, and lets you find anything with natural language.\n\n**Fully local. No cloud uploads. No subscriptions.**\n\n---\n\n## ✨ Features\n\n- **Context-Aware Organization**: Unlike scripts that blindly rename files, this agent understands context and categorizes intelligently.\n- **Semantic Search**: Find screenshots by meaning (e.g., *\"that slack message about the deploy\"*), even with garbage filenames.\n- **Adaptive**: Tell it to *\"actually split design into figma vs other\"* and it re-organizes on the fly.\n- **Persistent Memory**: Decisions are remembered across sessions using a local ChromaDB.\n\n---\n\n## 🚀 Quickstart (No Clone Needed!)\n\nUsing `uvx` (the modern Python alternative to `npx`), you can run **snapsearch** instantly without manual cloning or pip installs.\n\n### 1. Set your Environment Variables\n\nYou need to provide your OpenAI API key and optionally your screenshots directory. You can set them in your environment:\n\n```bash\nexport OPENAI_API_KEY=\"sk-...\"\nexport SCREENSHOTS_DIR=\"/Users/yourname/Desktop\" # Optional, defaults to ~/Desktop/screenshots-demo\n```\n\n### 2. Run the Agent\n\nTrigger the autonomous organizer r…","publisher":null,"homepage":null,"repository":null,"version":"0.1.1","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:snapsearch-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.vector-search","name":"Vector Search","confidence":0.894,"provenance":"derived"},{"slug":"knowledge.memory","name":"Agent Memory","confidence":0.848,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"},{"slug":"media.3d","name":"3D & Design","confidence":0.768,"provenance":"derived"}],"categories":["data","dev","knowledge","media"],"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":"snapsearch-mcp","registry":"pypi","observedAt":"2026-09-10T12:23:38.136Z","publishedAt":"2026-05-26T19:08:57.876852Z","latestVersion":"0.1.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"snapsearch-mcp","url":"https://pypi.org/project/snapsearch-mcp/","firstSeenAt":"2026-09-10T12:22:44.347Z","fetchedAt":"2026-09-10T12:22:44.347Z","normalizedAt":"2026-09-10T12:22:44.347Z"}]},"firstSeenAt":"2026-09-10T12:22:44.347Z","updatedAt":"2026-09-10T12:23:38.136Z"}