{"_id":"@agent-tags/mcp","_rev":"6-9000921549c6730af41f4200815654ac","name":"@agent-tags/mcp","dist-tags":{"latest":"0.2.0"},"versions":{"0.1.0":{"name":"@agent-tags/mcp","version":"0.1.0","author":{"name":"4rcadia"},"license":"Apache-2.0","_id":"@agent-tags/mcp@0.1.0","maintainers":[{"name":"4rcadia","email":"4rcadia.0@gmail.com"}],"homepage":"https://github.com/Arcadi4/tags#readme","bugs":{"url":"https://github.com/Arcadi4/tags/issues"},"dist":{"shasum":"ae7fbe64dfbfdba7f0b271b50fe2df6055a2147c","tarball":"https://registry.npmjs.org/@agent-tags/mcp/-/mcp-0.1.0.tgz","fileCount":50,"integrity":"sha512-FasvFRtEjWXcbnQOl7eCyUvB5fz8lWiuJTMq5ZqStJQmWqppvm5JYm8CPYSJXF3vkT+kdWu4eu8LHdvchqFm2A==","signatures":[{"sig":"MEUCIQChSRq3fU20iDancYntGibddrr5Vwg5gVyaUZFY9QzphgIgWV19+qYqHtU609dQYiocqrNlTlSlqiQVbP9tdAA6CAo=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":52068},"main":"dist/index.js","pnpm":{"onlyBuiltDependencies":["esbuild"]},"type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"b62b877d38a401a08101a8f9d49bf2d47877779c","scripts":{"dev":"tsx watch src/index.ts","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js"},"_npmUser":{"name":"4rcadia","email":"4rcadia.0@gmail.com"},"repository":{"url":"git+https://github.com/Arcadi4/tags.git","type":"git"},"_npmVersion":"11.12.1","description":"Tags are active, composable, and atomic agent directions.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.6.1"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.1.2+sha512.415a1cc25974731e75455c1468371be74c5aa5fb7621b50d4056d222451609f11412f23fd602e6169f1e060466641f798597e1be961a10688836a67b16569499","devDependencies":{"tsx":"^4.19.2","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1779083696994_0.030214839314680164","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@agent-tags/mcp","version":"0.1.1","author":{"name":"4rcadia"},"license":"Apache-2.0","_id":"@agent-tags/mcp@0.1.1","maintainers":[{"name":"4rcadia","email":"4rcadia.0@gmail.com"}],"homepage":"https://github.com/Arcadi4/tags#readme","bugs":{"url":"https://github.com/Arcadi4/tags/issues"},"bin":{"tags-mcp":"dist/index.js"},"dist":{"shasum":"8e2d0ecb15fca4057c322675e59c1472fd1b4b4a","tarball":"https://registry.npmjs.org/@agent-tags/mcp/-/mcp-0.1.1.tgz","fileCount":46,"integrity":"sha512-Izqyz+q8il7dN1+f9LOak/Yzn1TsiIQXoVvzh+fWgSx+psiUrqw26I6qpne2aABlJAG4Znh0xcv07RWfA99OJg==","signatures":[{"sig":"MEQCID0Gl1+LVJGRQn1F0avAF7aLTquBu8mrv9KWiLMVL8DhAiBxicSwuh9yXBEFmJopwuaIgrRzAA9QoHrQxn4ttJp+fA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42012},"main":"dist/index.js","pnpm":{"onlyBuiltDependencies":["esbuild"]},"type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"a8bf2650b75841bc23b0786d6d6653ed60b96fca","scripts":{"dev":"tsx watch src/index.ts","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","prepack":"npm run build"},"_npmUser":{"name":"4rcadia","email":"4rcadia.0@gmail.com"},"repository":{"url":"git+https://github.com/Arcadi4/tags.git","type":"git"},"_npmVersion":"11.12.1","description":"Tags are active, composable, and atomic agent directions.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.6.1"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.1.2+sha512.415a1cc25974731e75455c1468371be74c5aa5fb7621b50d4056d222451609f11412f23fd602e6169f1e060466641f798597e1be961a10688836a67b16569499","devDependencies":{"tsx":"^4.19.2","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1779084385417_0.8836878805534389","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@agent-tags/mcp","version":"0.1.2","author":{"name":"4rcadia"},"license":"Apache-2.0","_id":"@agent-tags/mcp@0.1.2","maintainers":[{"name":"4rcadia","email":"4rcadia.0@gmail.com"}],"homepage":"https://github.com/Arcadi4/tags#readme","bugs":{"url":"https://github.com/Arcadi4/tags/issues"},"bin":{"tags-mcp":"dist/index.js"},"dist":{"shasum":"802380a35df1c9a2e608edfe8efb9b8ab8f67dbe","tarball":"https://registry.npmjs.org/@agent-tags/mcp/-/mcp-0.1.2.tgz","fileCount":46,"integrity":"sha512-pT33CFapf/W4oTsGvIlTNSCSghWeQh/dNMRZnPIXJaPvy4wpRrr4AUDEp/rU2Zsu5fKIDSOnlzk2PsbQuPxx0A==","signatures":[{"sig":"MEUCIF0et5CfSP/Q16/2ueMzfXlL7n3lIerjXofdzm4Y6q2XAiEAqN60j7o86T8u4v5ErtFbThZheE6Il1g5mMzboylSOUY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42049},"main":"dist/index.js","pnpm":{"onlyBuiltDependencies":["esbuild"]},"type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"8f6465e4aabf92f7dc4a5c11a4ed3232e5816bdf","scripts":{"dev":"tsx watch src/index.ts","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","prepack":"npm run build"},"_npmUser":{"name":"4rcadia","email":"4rcadia.0@gmail.com"},"repository":{"url":"git+https://github.com/Arcadi4/tags.git","type":"git"},"_npmVersion":"11.12.1","description":"Tags are active, composable, and atomic agent directions.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.6.1"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.1.2+sha512.415a1cc25974731e75455c1468371be74c5aa5fb7621b50d4056d222451609f11412f23fd602e6169f1e060466641f798597e1be961a10688836a67b16569499","devDependencies":{"tsx":"^4.19.2","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.2_1779085267379_0.8634614896799986","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@agent-tags/mcp","version":"0.1.3","author":{"name":"4rcadia"},"license":"Apache-2.0","_id":"@agent-tags/mcp@0.1.3","maintainers":[{"name":"4rcadia","email":"4rcadia.0@gmail.com"}],"homepage":"https://github.com/Arcadi4/tags#readme","bugs":{"url":"https://github.com/Arcadi4/tags/issues"},"bin":{"tags-mcp":"dist/index.js"},"dist":{"shasum":"b2bc605149c059976052471ab9e79c716bc9a9e7","tarball":"https://registry.npmjs.org/@agent-tags/mcp/-/mcp-0.1.3.tgz","fileCount":46,"integrity":"sha512-q/E0Nniu5T6TnkHA3JJgPzSdki9/0wudwlKKbjOpV01M+tqhtgJYHzhw4wLtQYkIY/prSLlvrsPkmlWdjMY4bg==","signatures":[{"sig":"MEQCIAUIPxV21lDmIXVwnP3mqqyzwFn3oIi4CaLwxisqe0SGAiAduE30r17nseukV+2e+33n+vyI18N75e8kWj2AIna0xQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":41619},"main":"dist/index.js","pnpm":{"onlyBuiltDependencies":["esbuild"]},"type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"5b261e5ea27fc3b179b865a50398a3e0f6e30cb1","scripts":{"dev":"tsx watch src/index.ts","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","prepack":"npm run build"},"_npmUser":{"name":"4rcadia","email":"4rcadia.0@gmail.com"},"repository":{"url":"git+https://github.com/Arcadi4/tags.git","type":"git"},"_npmVersion":"11.12.1","description":"Tags are active, composable, and atomic agent directions.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.6.1"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.1.2+sha512.415a1cc25974731e75455c1468371be74c5aa5fb7621b50d4056d222451609f11412f23fd602e6169f1e060466641f798597e1be961a10688836a67b16569499","devDependencies":{"tsx":"^4.19.2","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.3_1779088975908_0.509856908567881","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@agent-tags/mcp","version":"0.1.4","author":{"name":"4rcadia"},"license":"Apache-2.0","_id":"@agent-tags/mcp@0.1.4","maintainers":[{"name":"4rcadia","email":"4rcadia.0@gmail.com"}],"homepage":"https://github.com/Arcadi4/tags#readme","bugs":{"url":"https://github.com/Arcadi4/tags/issues"},"bin":{"tags-mcp":"dist/index.js"},"dist":{"shasum":"57b67f9d29fa08c79955f49d659d604398f2575f","tarball":"https://registry.npmjs.org/@agent-tags/mcp/-/mcp-0.1.4.tgz","fileCount":46,"integrity":"sha512-oy/aAGjvedBZY0dmOpJl6cbErEUMvJe+J1uRipu9InxxvmQZCTsr96b1H5Q29fk2XQ2j309r71I5LyzXsO5qYA==","signatures":[{"sig":"MEYCIQDzbsaaRBqoTax0P0R7l1c4IEnTqKcNlMknarUtC2ynvQIhAIx5gUok91aTroeRihM6pJSE9h39R3hdRc27EaG8frTj","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42719},"main":"dist/index.js","pnpm":{"onlyBuiltDependencies":["esbuild"]},"type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"e86a2f68bba09b56394456e9745900cdc0c639b9","scripts":{"dev":"tsx watch src/index.ts","build":"tsc","clean":"rm -rf dist","start":"node dist/index.js","prepack":"npm run build"},"_npmUser":{"name":"4rcadia","email":"4rcadia.0@gmail.com"},"repository":{"url":"git+https://github.com/Arcadi4/tags.git","type":"git"},"_npmVersion":"11.12.1","description":"Tags are active, composable, and atomic agent directions.","directories":{},"_nodeVersion":"26.0.0","dependencies":{"zod":"^3.23.8","@modelcontextprotocol/sdk":"^1.6.1"},"_hasShrinkwrap":false,"packageManager":"pnpm@11.1.2+sha512.415a1cc25974731e75455c1468371be74c5aa5fb7621b50d4056d222451609f11412f23fd602e6169f1e060466641f798597e1be961a10688836a67b16569499","devDependencies":{"tsx":"^4.19.2","typescript":"^5.7.2","@types/node":"^22.10.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.4_1779090734094_0.9967171758618489","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@agent-tags/mcp","version":"0.2.0","description":"Tags are active, composable, and atomic agent directions.","homepage":"https://github.com/Arcadi4/tags#readme","bugs":{"url":"https://github.com/Arcadi4/tags/issues"},"repository":{"type":"git","url":"git+https://github.com/Arcadi4/tags.git"},"license":"Apache-2.0","author":{"name":"4rcadia"},"type":"module","main":"dist/index.js","bin":{"tags-mcp":"dist/index.js"},"engines":{"node":">=18"},"scripts":{"build":"tsc","prepack":"npm run build","start":"node dist/index.js","dev":"tsx watch src/index.ts","clean":"rm -rf dist"},"dependencies":{"@modelcontextprotocol/sdk":"^1.6.1","zod":"^3.23.8"},"devDependencies":{"@types/node":"^22.10.0","tsx":"^4.19.2","typescript":"^5.7.2"},"pnpm":{"onlyBuiltDependencies":["esbuild"]},"packageManager":"pnpm@11.1.2+sha512.415a1cc25974731e75455c1468371be74c5aa5fb7621b50d4056d222451609f11412f23fd602e6169f1e060466641f798597e1be961a10688836a67b16569499","gitHead":"05bea7bf6200781f05241f9691c33052bb756f5b","types":"./dist/index.d.ts","_id":"@agent-tags/mcp@0.2.0","_nodeVersion":"26.0.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-ZPC0ZI2V+Ns5cUclEzIjhrONpRsHXCCMFHvggssfbQFX9bGMdY8OxjkTz7fzeFdp0ftN5vD1fr2t+aVxQwmaJw==","shasum":"5b75ed5eaeaea9b463c195c42d3f2b8dc6e4b1ad","tarball":"https://registry.npmjs.org/@agent-tags/mcp/-/mcp-0.2.0.tgz","fileCount":62,"unpackedSize":72579,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCQv46GpvackTR64vixWtaIiOceZb6WvCW2fqKnEuHcYQIgNNjJwy/s51YSfHUuK8jXAjeUeD5JPITv3tHbwsdq7b0="}]},"_npmUser":{"name":"4rcadia","email":"4rcadia.0@gmail.com"},"directories":{},"maintainers":[{"name":"4rcadia","email":"4rcadia.0@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.2.0_1779133599898_0.1401214384372833"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-18T05:54:56.908Z","modified":"2026-05-18T19:46:40.253Z","0.1.0":"2026-05-18T05:54:57.153Z","0.1.1":"2026-05-18T06:06:25.562Z","0.1.2":"2026-05-18T06:21:07.512Z","0.1.3":"2026-05-18T07:22:56.070Z","0.1.4":"2026-05-18T07:52:14.244Z","0.2.0":"2026-05-18T19:46:40.141Z"},"bugs":{"url":"https://github.com/Arcadi4/tags/issues"},"author":{"name":"4rcadia"},"license":"Apache-2.0","homepage":"https://github.com/Arcadi4/tags#readme","repository":{"type":"git","url":"git+https://github.com/Arcadi4/tags.git"},"description":"Tags are active, composable, and atomic agent directions.","maintainers":[{"name":"4rcadia","email":"4rcadia.0@gmail.com"}],"readme":"# @agent-tags/mcp\n\nThe MCP server behind [Tags](../README.md). Expands `#tag` markers in user prompts into XML directives so agents receive composable, location-aware instructions.\n\nThe server exposes two tools:\n\n- **`parse_tags`** — always-on prompt expander. Replaces `#tag` markers with `<tag/>` references and prepends each tag's directive body once at the top.\n- **`load_tag_creation_skill`** — preflight for tag-authoring tasks. Returns the canonical guide for writing new `.agents/tags/*.md` files.\n\nFor end-user install instructions across OpenCode, Claude Code, Codex, Gemini CLI, Qoder, etc., see the [project README](../README.md). This document is for running the server directly, configuring a local checkout, or contributing.\n\n## Quick Use (Published Package)\n\nThe published package is `@agent-tags/mcp`. Most agents only need one line of config pointing at `npx`:\n\n```jsonc\n{\n  \"mcpServers\": {\n    \"tags\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@agent-tags/mcp@latest\"]\n    }\n  }\n}\n```\n\nThe server defaults `workspace` to `process.cwd()`, which the agent sets to the project root. No env var or flag is required for normal use.\n\n### Using Without `npx`\n\nYou may also install the MCP as a global package. This can make the config simpler. The local binary will be linked as `tags-mcp`:\n\n```bash\nnpm install -g @agent-tags/mcp\n```\n\nThen, point your agent config to `tags-mcp` instead of `npx`:\n\n```jsonc\n{\n  \"mcpServers\": {\n    \"tags\": {\n      \"command\": \"tags-mcp\"\n    }\n  }\n}\n```\n\n## Workspace Resolution\n\nResolved in this order, first match wins:\n\n1. `--workspace <abs-path>` CLI flag\n2. `TAGS_WORKSPACE` environment variable\n3. `process.cwd()`\n\nTags are then discovered from two locations:\n\n- `~/.agents/tags/*.{md,txt}` — global, available everywhere\n- `<workspace>/.agents/tags/*.{md,txt}` — project-scoped, shadows globals on name collision\n\nFilename = tag name. File body = directive content. Both `#tag_name` and `#tag-name` resolve to the same definition.\n\n## CLI Flags\n\n| Flag | Effect |\n| --- | --- |\n| `--workspace <path>` | Override the workspace root. Useful when stdio cwd is unreliable. |\n| `--no-builtin-tags` | Disable the bundled tags below. Project / global tags still load. |\n\n## Built-in Tags\n\nBundled by default. Override by writing a global or project tag with the same name; disable entirely with `--no-builtin-tags`.\n\n| Tag | Purpose |\n| --- | --- |\n| `#fyi` | Accept information silently as latest fact; don't act on it. |\n| `#explore` | Investigate the marked concept across the codebase before continuing. |\n| `#example` | Treat the list as non-exhaustive and infer the underlying pattern. |\n| `#use-skill` | Load a skill mentioned by the user, or find a relevant one. |\n| `#btw` | Incidental aside; keep as background, don't treat as a topic switch. |\n\n## Limits\n\n- One-pass non-recursive expansion — tags inside tag bodies are not expanded.\n- Code-fence stripping is basic CommonMark (triple backticks and inline backticks); tilde fences and indented code blocks are not recognized.\n- No YAML frontmatter parsing; the entire file body becomes the directive.\n- No file watching or hot reload; restart the server after editing tag files.\n- stdio transport only.\n","readmeFilename":"README.md"}