{"_id":"@agentsnap/mcp","_rev":"4-8e8d8760ee1d05f5bc17ae1801a305a2","name":"@agentsnap/mcp","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@agentsnap/mcp","version":"0.1.0","keywords":["mcp","agentsnap","claude","ai-agents"],"author":{"name":"ViloTech"},"license":"MIT","_id":"@agentsnap/mcp@0.1.0","maintainers":[{"name":"nico.pinos.vt","email":"nico@vilotech.co"}],"bin":{"agentsnap-mcp":"dist/index.js"},"dist":{"shasum":"1a02494983576b319cd3b814869f63e0f839fa9a","tarball":"https://registry.npmjs.org/@agentsnap/mcp/-/mcp-0.1.0.tgz","fileCount":16,"integrity":"sha512-zh90MjCtJjgO7OsI9E3qu31q6bPMM4wLYzr0P/hfngSJwsgek49WtASpYbF2yJNooEBllIXdh2IyVjgD7YY+jA==","signatures":[{"sig":"MEUCIDckKB7q0GRNn3/xPFkTL288icNu82WVq1xJU/IMcJw2AiEAvA0dRkWfeW/8jTt/1LM2I1kvzL9f+Hehx4BBz7Cxejw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":29498},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","scripts":{"dev":"tsx src/index.ts","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"nico.pinos.vt","email":"nico@vilotech.co"},"_npmVersion":"10.9.3","description":"AgentSnap MCP server — create and manage AI agents from Claude","directories":{},"_nodeVersion":"22.19.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"~5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1780325618468_0.24755656740572363","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@agentsnap/mcp","version":"0.1.1","keywords":["mcp","agentsnap","claude","ai-agents"],"author":{"name":"ViloTech"},"license":"MIT","_id":"@agentsnap/mcp@0.1.1","maintainers":[{"name":"nico.pinos.vt","email":"nico@vilotech.co"}],"bin":{"agentsnap-mcp":"dist/index.js"},"dist":{"shasum":"f9de2f8ed6bfeba0a6f1872cb0f8b3a00d7dd086","tarball":"https://registry.npmjs.org/@agentsnap/mcp/-/mcp-0.1.1.tgz","fileCount":16,"integrity":"sha512-35flUdvkLzaziolCn4hPPTJ1TuH5RLddfSpH+zi802+dsglds33ybR2zczaWuRhWpZ3nootY8qc+EJcadSNUJA==","signatures":[{"sig":"MEUCIGM99H7Ifc932EAYBhyV5R7RoJ9P4rveyH9PsEOuqG6bAiEArCdIIF7GOjALEXlssGwxsVXlxqzt3nLEZOLJYK8vKis=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":32309},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","scripts":{"dev":"tsx src/index.ts","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"nico.pinos.vt","email":"nico@vilotech.co"},"_npmVersion":"10.9.3","description":"AgentSnap MCP server — create and manage AI agents from Claude","directories":{},"_nodeVersion":"22.19.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"~5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1780409134074_0.2771981677834172","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@agentsnap/mcp","version":"0.1.2","keywords":["mcp","agentsnap","claude","ai-agents"],"author":{"name":"ViloTech"},"license":"MIT","_id":"@agentsnap/mcp@0.1.2","maintainers":[{"name":"nico.pinos.vt","email":"nico@vilotech.co"}],"bin":{"agentsnap-mcp":"dist/index.js"},"dist":{"shasum":"3950fcb072c8cf049cc74885e14dfaf854127b5d","tarball":"https://registry.npmjs.org/@agentsnap/mcp/-/mcp-0.1.2.tgz","fileCount":16,"integrity":"sha512-ECwPLuKlcO8BavJyj3OSmTD08zhppvfVdwYS/W5QukqznfeB8wHWo6rrJEd0C22ovlop1EitjcG5IBW/0CW+FA==","signatures":[{"sig":"MEYCIQC1yycbhgZV7KSEr56IaMtZcXimv1DgJM3tUWAucdVuPwIhALVuzuCK/hQRa4SktvSACObNnPBwhPh86b7Sm/TuORmy","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":33574},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","scripts":{"dev":"tsx src/index.ts","build":"tsc","prepublishOnly":"npm run build"},"_npmUser":{"name":"nico.pinos.vt","email":"nico@vilotech.co"},"_npmVersion":"10.9.3","description":"AgentSnap MCP server — create and manage AI agents from Claude","directories":{},"_nodeVersion":"22.19.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"_hasShrinkwrap":false,"devDependencies":{"tsx":"^4.19.0","typescript":"~5.7.0","@types/node":"^22.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.2_1780410415644_0.39114041138503586","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@agentsnap/mcp","version":"0.1.3","description":"AgentSnap MCP server — create and manage AI agents from Claude","type":"module","bin":{"agentsnap-mcp":"dist/index.js"},"main":"./dist/index.js","scripts":{"build":"tsc","dev":"tsx src/index.ts","prepublishOnly":"npm run build"},"keywords":["mcp","agentsnap","claude","ai-agents"],"author":{"name":"ViloTech"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"devDependencies":{"@types/node":"^22.0.0","tsx":"^4.19.0","typescript":"~5.7.0"},"_id":"@agentsnap/mcp@0.1.3","types":"./dist/index.d.ts","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-DITXzGIHgsx4t2rHi0bpzLrHlEK4nRPISfcS557p+zsg83T9fuuDq66RPs8Aht04Zx5NoszvmYtRDtTMCCBiTA==","shasum":"79d98526e629c7d8ba1caa3a8e0e65b5abd7dc7d","tarball":"https://registry.npmjs.org/@agentsnap/mcp/-/mcp-0.1.3.tgz","fileCount":16,"unpackedSize":34814,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCEEdviIdBXBwLGSi+iUoZKBznL4UwJ8QxX14REAKJvewIgYwrm4vzJKGUoUzTAEmM3DQosOVvh7heHjaxIn7ejSwE="}]},"_npmUser":{"name":"nico.pinos.vt","email":"nico@vilotech.co"},"directories":{},"maintainers":[{"name":"nico.pinos.vt","email":"nico@vilotech.co"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.3_1780511187298_0.21621425574438624"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-01T14:53:38.320Z","modified":"2026-06-03T18:26:27.603Z","0.1.0":"2026-06-01T14:53:38.613Z","0.1.1":"2026-06-02T14:05:34.225Z","0.1.2":"2026-06-02T14:26:55.841Z","0.1.3":"2026-06-03T18:26:27.471Z"},"author":{"name":"ViloTech"},"license":"MIT","keywords":["mcp","agentsnap","claude","ai-agents"],"description":"AgentSnap MCP server — create and manage AI agents from Claude","maintainers":[{"name":"nico.pinos.vt","email":"nico@vilotech.co"}],"readme":"# @agentsnap/mcp\n\nMCP server for AgentSnap — create and manage AI agents from Claude Desktop, Claude Code, or any MCP-compatible client.\n\n## Setup\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentsnap\": {\n      \"command\": \"npx\",\n      \"args\": [\"@agentsnap/mcp\"],\n      \"env\": {\n        \"AGENTSNAP_API_URL\": \"https://agentsnapserver.vercel.app\",\n        \"AGENTSNAP_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdd the server with both env vars inline so the MCP can authenticate:\n\n```bash\nclaude mcp add agentsnap -s user \\\n  -e AGENTSNAP_API_URL=https://agentsnapserver.vercel.app \\\n  -e AGENTSNAP_API_KEY=as_your_key_here \\\n  -- npx @agentsnap/mcp\n```\n\n**Scopes** (pick one):\n\n| `-s` | Stored in | Use when |\n|---|---|---|\n| `user` | `~/.claude.json` (global) | One personal key, used across all your projects (typical) |\n| `local` | current project entry in `~/.claude.json` | Different keys per project |\n| `project` | committed `.mcp.json` | **Avoid for AgentSnap** — it commits your API key to git |\n\n**Keeping the key out of `~/.claude.json`**\n\nThe command above writes the literal key to `~/.claude.json`. To keep it in your shell instead (e.g. in `~/.zshrc` or a sourced `.env`), use Claude Code's `${VAR}` expansion:\n\n```bash\nclaude mcp add agentsnap -s user \\\n  -e AGENTSNAP_API_URL=https://agentsnapserver.vercel.app \\\n  -e 'AGENTSNAP_API_KEY=${AGENTSNAP_API_KEY}' \\\n  -- npx @agentsnap/mcp\n```\n\nThe single quotes are required — they stop your shell from expanding `${...}` before Claude Code sees it. The expansion happens when Claude Code spawns the MCP, reading from the parent shell's env. If `AGENTSNAP_API_KEY` is unset at that point Claude Code refuses to start the server, so make sure your shell exports it.\n\n**Get an API key**: in the AgentSnap UI go to Settings → API Keys → Create key. The full secret is shown only once.\n\n### Local development\n\n```bash\ncd agentsnap-mcp\nnpm install\nAGENTSNAP_API_URL=https://agentsnapserver.vercel.app npm run dev\n```\n\n## Tools\n\n### Agent Management\n- `list_agents` — List all your agents\n- `get_agent` — Get agent details\n- `create_agent` — Create a new agent with name, instructions, model, plugins\n- `update_agent` — Update agent configuration\n- `delete_agent` — Delete an agent\n- `list_plugins` — List available plugins\n- `list_models` — List available LLM providers and models\n\n### Templates\n- `list_templates` — List available templates (built-in + community)\n- `create_from_template` — Create an agent from a template\n- `export_agent_as_template` — Save an agent as a reusable template\n\n### Knowledge Management\n- `list_knowledge_sources` — List documents and web ingestions\n- `ingest_website` — Crawl a website and index its content\n- `ingest_url` — Fetch and index data from a JSON/CSV/XML endpoint\n- `upload_document` — Upload text/markdown content\n- `delete_document` — Remove a document\n- `delete_ingestion` — Remove a web ingestion\n\n### Chat\n- `chat_with_agent` — Send a message and get a response\n\n## Prompts\n\n- `create-agent-wizard` — Guided step-by-step agent creation flow\n- `configure-knowledge` — Add knowledge sources to an existing agent\n\n## Authentication\n\nRequires an AgentSnap API key. Set `AGENTSNAP_API_KEY` in your environment.\n\n## Environment Variables\n\n| Variable | Required | Description |\n|---|---|---|\n| `AGENTSNAP_API_URL` | Yes | AgentSnap server URL |\n| `AGENTSNAP_API_KEY` | Yes | Personal API key |\n\n## Tool annotations\n\nEvery tool ships with MCP annotations (`readOnlyHint`, `destructiveHint`, `idempotentHint`, `openWorldHint`) so compatible clients can decide when to auto-allow and when to prompt. Categories:\n\n- **Read-only:** `list_agents`, `get_agent`, `list_plugins`, `list_models`, `list_templates`, `list_knowledge_sources`\n- **Mutating:** `create_agent`, `update_agent`, `create_from_template`, `export_agent_as_template`, `chat_with_agent`, `ingest_website`, `ingest_url`, `upload_document`\n- **Destructive (cannot be undone):** `delete_agent`, `delete_document`, `delete_ingestion`\n \n## Claude Code permissions\n\nIn Claude Code, MCP tool permissions are keyed as `mcp__agentsnap__<tool>`. A reasonable default — auto-allow reads, prompt for writes, block destructive — looks like:\n\n```json\n{\n  \"permissions\": {\n    \"allow\": [\n      \"mcp__agentsnap__list_agents\",\n      \"mcp__agentsnap__get_agent\",\n      \"mcp__agentsnap__list_plugins\",\n      \"mcp__agentsnap__list_models\",\n      \"mcp__agentsnap__list_templates\",\n      \"mcp__agentsnap__list_knowledge_sources\"\n    ],\n    \"deny\": [\n      \"mcp__agentsnap__delete_agent\",\n      \"mcp__agentsnap__delete_document\",\n      \"mcp__agentsnap__delete_ingestion\"\n    ]\n  }\n}\n```\n\nUse `\"mcp__agentsnap\"` (bare server name) to allow every tool, but only do that on a trusted key — it covers destructive operations too.\n","readmeFilename":"README.md"}