{
  "markdown": "# @aistoragedepot/mcp\n\nA [Model Context Protocol](https://modelcontextprotocol.io) server that exposes **your\n[AIStorageDepot](https://www.aistoragedepot.com) library** to any MCP-aware AI client —\nClaude Desktop, Cursor, Cline, Windsurf, and others.\n\nYour stored content shows up where you actually work:\n\n- **Prompts** → the items you mark with **/** in the app become MCP prompts (slash-commands) — any type, with each prompt's\n  `[field]` surfaced as a prompt argument you fill in.\n- **Resources** → every item (rules, docs, skills, MCP configs, prompts) is readable at\n  `aisd://item/<id>`, so an agent can pull \"my coding rules\" or \"my project guidelines\"\n  into context on demand.\n- **Tools** → `search_library(query)` and `get_item(id)` let an agent find and fetch\n  anything in your library programmatically.\n\n## Try it with no account (sample mode)\n\n`AISD_TOKEN` is **optional**. Run the server with **no token** and it serves a free, read-only\nsample of the **public curated library** — a good way to see AIStorageDepot inside your editor\nbefore signing up. Add a token later to switch to **your own & team libraries**. Add the server\nwith an empty `env` (or omit `AISD_TOKEN`):\n\n```json\n{\n  \"mcpServers\": {\n    \"aisd\": { \"command\": \"npx\", \"args\": [\"-y\", \"@aistoragedepot/mcp\"] }\n  }\n}\n```\n\n## Setup\n\n> **👉 Easiest path:** step-by-step instructions for each app (config-file locations and all)\n> are at **<https://www.aistoragedepot.com/connect>**. The manual version:\n\n1. In AIStorageDepot, go to **Settings → API tokens** and create a token (free for\n   individuals). Copy it.\n2. Add the server to your MCP client's config. Example (Claude Desktop /\n   `claude_desktop_config.json`, Cursor `~/.cursor/mcp.json`, etc.):\n\n```json\n{\n  \"mcpServers\": {\n    \"aisd\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aistoragedepot/mcp\"],\n      \"env\": {\n        \"AISD_TOKEN\": \"aisd_xxxxxxxxxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\n3. Restart the client. The items you marked **/** appear as slash-commands; everything is available as\n   resources; and the `search_library` / `get_item` tools are ready.\n\n## Configuration\n\n| Env var | Required | Default | Notes |\n| --- | --- | --- | --- |\n| `AISD_TOKEN` | no | — | Token from Settings → API tokens. **No token = anonymous sample mode** (the free public curated library, read-only). **With a token** you get your own & team libraries. Has full access to your account — keep it secret. |\n| `AISD_BASE_URL` | no | `https://www.aistoragedepot.com` | Point at a self-hosted / dev instance if needed. |\n| `AISD_WORKSPACES` | no | — | **Retired.** Your slash menu is now the items you mark **/** in the app (strict opt-in); this variable is ignored. Search and resources still cover every workspace. |\n\n## Slash-commands (`pull`)\n\nNot every client turns MCP prompts into `/` slash-commands (some only use the tools). To get\nyour library as **native** slash-commands, sync it to command files — for every AI tool you\nuse, not just Claude:\n\n```bash\nnpx -y @aistoragedepot/mcp pull --token=aisd_your_token --to=all\n```\n\n| Target | Writes to | Commands appear as |\n| --- | --- | --- |\n| `claude` *(default)* | `~/.claude/commands/aisd/` | `/aisd:<name>` |\n| `cursor` | `~/.cursor/commands/` | `/aisd-<name>` |\n| `vscode` | your VS Code profile's `prompts/` folder (Copilot Chat) | `/aisd-<name>` |\n| `windsurf` | `~/.codeium/windsurf/global_workflows/` (Cascade) | `/aisd-<name>` |\n| `codex` | `~/.codex/prompts/` | `/prompts:aisd-<name>` |\n\nTools that aren't installed are skipped automatically. Each tool gets its own dialect\n(frontmatter, argument hints, `$ARGUMENTS` where supported). **Skills** run as-is.\n**Prompts** take input: their `[fields]` show as an argument hint, and whatever you type\nafter the command fills them —\n\n```\n/aisd:cold-outreach Jane at Globex, about our payments API\n```\n\n— with the AI asking for any value you left out.\n\n| Option | Default | |\n| --- | --- | --- |\n| `--to=…` | `claude` | Which tools to write commands for — comma list, or `all`. |\n| `--token=…` | `AISD_TOKEN` env | Your API token. |\n| `--types=…` | `skill,prompt` | Which item types become commands (e.g. `skill` for skills only). |\n| `--workspaces=\"A,B\"` | your personal library | Which workspaces to pull (names, or `all`). |\n| `--project` | off | Write into the current repo instead: `.claude/commands/`, `.cursor/commands/`, `.github/prompts/`, `.windsurf/workflows/`. |\n| `--dir=<path>` | per-target | Write somewhere else entirely (single `--to` only). |\n\nRe-runs are safe: each target only clears its own files (claude: its namespaced folder;\nthe others: only files with the `aisd-` prefix — your own commands are never touched).\n\n## Notes\n\n- Read-only in v0.1 (it surfaces and fetches your content; it doesn't write back).\n- The library snapshot is cached for ~30s, so a burst of calls hits the API once.\n- Revoke a token any time in Settings → API tokens; the server loses access immediately.\n\n## Local development\n\n```bash\nnpm install\nAISD_TOKEN=<token> AISD_BASE_URL=http://localhost:3100 npm run test:client\n```\n",
  "bytes": 5072,
  "sha": "c343f51dd28960458a39cb815ef3416163d6d607b728e31372d9674d60df0ef6",
  "repo_slug": "aistoragedepot/aistoragedepot-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_aistoragedepot_admin_aistorage_6739e226/readme"
}