{"_id":"@ai-agencee/mcp","_rev":"3-889808b49217d4e31dd934040cc492f2","name":"@ai-agencee/mcp","dist-tags":{"latest":"1.3.9"},"versions":{"1.3.5":{"name":"@ai-agencee/mcp","version":"1.3.5","_id":"@ai-agencee/mcp@1.3.5","maintainers":[{"name":"formular.dev","email":"pianatadeo@hotmail.com"}],"bin":{"ai-kit-mcp":"dist/index.js"},"dist":{"shasum":"7af254e001e1b8573d5c55763af44e00c3ef5e4e","tarball":"https://registry.npmjs.org/@ai-agencee/mcp/-/mcp-1.3.5.tgz","fileCount":27,"integrity":"sha512-B8tic0edl6c5lqzOfhgd+9l/LWm88YN36QG232g3CwC+4CIi/ZgfsecQdKTWHPeDtSG+PpwomIfWb+KRSaC9NQ==","signatures":[{"sig":"MEQCIG2oFgKcDTMJ6pqM/9CfZOXTDV6TlpU0GzObL3eJMu6qAiAWVTk/Sj3XFpyugriwPeRqYJ2p95gDEY58RM9bCPrSaQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":112282},"main":"./dist/index.js","type":"module","_from":"file:ai-agencee-mcp-1.3.5.tgz","types":"./dist/index.d.ts","scripts":{"dev":"tsc --watch","lint":"tsc --noEmit","test":"jest --passWithNoTests","build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"formular.dev","email":"pianatadeo@hotmail.com"},"_resolved":"/tmp/6f7348f32c2af2ce3cd38ca864fda4d4/ai-agencee-mcp-1.3.5.tgz","_integrity":"sha512-B8tic0edl6c5lqzOfhgd+9l/LWm88YN36QG232g3CwC+4CIi/ZgfsecQdKTWHPeDtSG+PpwomIfWb+KRSaC9NQ==","_npmVersion":"10.8.2","description":"MCP Server for AI Agencee","directories":{},"_nodeVersion":"20.20.0","dependencies":{"@ai-agencee/core":"^1.1.0","@ai-agencee/engine":"^1.1.0","@modelcontextprotocol/sdk":"^1.27.1"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^30.2.0","ts-jest":"^29.1.5","typescript":"^5.4.5","@types/jest":"^30.0.0","@types/node":"^25.3.5"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.3.5_1772914847560_0.8851874675661433","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This package is legacy and no longer maintained."},"1.3.9":{"name":"@ai-agencee/mcp","version":"1.3.9","_id":"@ai-agencee/mcp@1.3.9","maintainers":[{"name":"formular.dev","email":"pianatadeo@hotmail.com"}],"bin":{"ai-kit-mcp":"dist/index.js"},"dist":{"shasum":"583c02cbee3148ca8b559ad3d09e3a75ce518599","tarball":"https://registry.npmjs.org/@ai-agencee/mcp/-/mcp-1.3.9.tgz","fileCount":410,"integrity":"sha512-d9qPpWPf5Zqh1XReKaQpkm8/ZfYsLnnIhRl72+pjCIkWua64jQIcS+tH7lR7kelKS4vK2xZ8X/Zv+O97J7/xaQ==","signatures":[{"sig":"MEQCIEs5lXDxw/cxI7x7KRq1ZYFrj8YFv4V5BvBCWP9aR3XOAiAhKKfUMOowQ3ZYgEzltMen4KSdp+p4T+dwFCRwl6cl/A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":418866},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"057758a6bf88ee28e086d4976f26e2d4ecfbe7b0","scripts":{"dev":"tsc --watch","lint":"tsc --noEmit","test":"jest --passWithNoTests","build":"tsc","start":"node dist/index.js","prepublishOnly":"pnpm run build"},"_npmUser":{"name":"formular.dev","email":"pianatadeo@hotmail.com"},"_npmVersion":"10.9.0","description":"MCP Server for AI Agencee","directories":{},"_nodeVersion":"24.12.0","dependencies":{"@ai-agencee/core":"workspace:^","@ai-agencee/engine":"workspace:^","@ai-agencee/galileus":"workspace:^","@atomos-web/structura-mcp":"^1.1.4","@modelcontextprotocol/sdk":"^1.29.0","@atomos-web/structura-core":"^1.1.3"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"jest":"^30.3.0","ts-jest":"^29.4.9","typescript":"^5.9.3","@types/jest":"^30.0.0","@types/node":"^25.6.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.3.9_1778145973458_0.0946614876451024","host":"s3://npm-registry-packages-npm-production"},"deprecated":"This package is legacy and no longer maintained."}},"time":{"created":"2026-03-07T20:20:47.324Z","modified":"2026-07-01T08:49:59.725Z","1.3.5":"2026-03-07T20:20:47.702Z","1.3.9":"2026-05-07T09:26:13.607Z"},"description":"MCP Server for AI Agencee","maintainers":[{"name":"formular.dev","email":"pianatadeo@hotmail.com"}],"readme":"# @ai-agencee/mcp\r\n\r\n[![npm](https://img.shields.io/npm/v/@ai-agencee/mcp)](https://www.npmjs.com/package/@ai-agencee/mcp)\r\n[![license](https://img.shields.io/npm/l/@ai-agencee/mcp)](https://github.com/binaryjack/ai-agencee/blob/main/LICENSE)\r\n\r\nMCP (Model Context Protocol) server for the **AI Agencee** toolkit. Exposes DAG agent orchestration, project standard enforcement, and live event streaming directly to AI assistants — no API keys required when running through VS Code Copilot.\r\n\r\n> **⚠️ IMPORTANT ARCHITECTURE NOTE**  \r\n> This MCP server is designed for **cloud applications** and **remote access** to codebases (e.g., Claude Desktop, AI Agencee cloud app).  \r\n>   \r\n> **DO NOT** use this in the VS Code extension directly — the extension has native VS Code APIs (`workspace.findFiles()`, `workspace.symbols`, `workspace.fs`) for local codebase access.  \r\n> Using MCP from the extension spawns unnecessary subprocesses and adds architectural complexity.\r\n>   \r\n> **Use cases:**\r\n> - ✅ AI Agencee cloud app accessing remote workspace via MCP\r\n> - ✅ Claude Desktop MCP integration for local codebase queries\r\n> - ❌ VS Code extension (use native `vscode` API instead)\r\n\r\n---\r\n\r\n## Installation\r\n\r\n```bash\r\nnpm install @ai-agencee/mcp\r\n# or\r\npnpm add @ai-agencee/mcp\r\n```\r\n\r\n> **Node ≥ 20** required. ES module. Runtime dependencies: `@ai-agencee/core`, `@ai-agencee/engine`, `@modelcontextprotocol/sdk`.\r\n\r\n---\r\n\r\n## Quick Start\r\n\r\n### VS Code / Copilot (no API keys needed)\r\n\r\nAdd to your VS Code MCP settings or `.vscode/mcp.json`:\r\n\r\n```json\r\n{\r\n  \"servers\": {\r\n    \"ai-kit\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"@ai-agencee/mcp\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nThe server bridges LLM calls back to VS Code Copilot via the MCP sampling protocol — no `ANTHROPIC_API_KEY` or `OPENAI_API_KEY` required.\r\n\r\n### Claude Desktop\r\n\r\nEdit `~/.config/Claude/claude_desktop_config.json` (`%APPDATA%\\Claude\\claude_desktop_config.json` on Windows):\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"ai-kit\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"@ai-agencee/mcp\"],\r\n      \"env\": {\r\n        \"ANTHROPIC_API_KEY\": \"sk-ant-...\"\r\n      }\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n### Standalone server\r\n\r\n```bash\r\nnpx @ai-agencee/mcp\r\n# or, after installing globally:\r\nai-kit-mcp\r\n```\r\n\r\n---\r\n\r\n## MCP Tools\r\n\r\n### `init`\r\n\r\nInitialize an AI session with ULTRA_HIGH standards. Loads all project rule files and prints the active configuration.\r\n\r\n```\r\nParameters:\r\n  strict  boolean  Enable STRICT_MODE (default: true)\r\n```\r\n\r\n### `check`\r\n\r\nValidate current project structure against required files, kebab-case naming rules, and forbidden code patterns.\r\n\r\n### `rules`\r\n\r\nReturn coding standards and conventions from `src/.ai/rules.md`.\r\n\r\n```\r\nParameters:\r\n  format  'markdown' | 'text'  (default: 'markdown')\r\n```\r\n\r\n### `patterns`\r\n\r\nReturn design patterns and architecture guidelines from `src/.ai/patterns.md`.\r\n\r\n```\r\nParameters:\r\n  format  'markdown' | 'text'  (default: 'markdown')\r\n```\r\n\r\n### `bootstrap`\r\n\r\nReturn session bootstrap guide from `src/.ai/bootstrap.md`.\r\n\r\n```\r\nParameters:\r\n  format  'markdown' | 'text' | 'config'  (default: 'markdown')\r\n```\r\n\r\n### `agent-dag`\r\n\r\nRun a full multi-lane supervised DAG execution. LLM calls are delegated back to the AI assistant via MCP sampling — no API keys needed.\r\n\r\n```\r\nParameters:\r\n  dagFile      string   Path to dag.json (default: 'agents/dag.json')\r\n  projectRoot  string   Absolute path to project root (default: cwd)\r\n  verbose      boolean  Emit per-checkpoint log lines (default: false)\r\n  budgetCapUSD number   Abort when estimated spend exceeds this USD amount\r\n```\r\n\r\n### `agent-breakdown`\r\n\r\nUse the Business Analyst agent to break down a specification into structured tasks.\r\n\r\n```\r\nParameters:\r\n  specification  string  (required)  Feature description to analyse\r\n```\r\n\r\n### `agent-workflow`\r\n\r\nRun the full 6-agent pipeline: BA → Architecture → Backend → Frontend → Testing → E2E.\r\n\r\n```\r\nParameters:\r\n  specification  string  (required)  Complete feature specification\r\n  featureName    string  (required)  Feature identifier\r\n```\r\n\r\n### `agent-validate`\r\n\r\nUse the Supervisor agent to validate implementation output against ULTRA_HIGH standards.\r\n\r\n```\r\nParameters:\r\n  output       string    (required)  Code or output to validate\r\n  checkpoints  string[]  Which standards to check (all, code-quality, architecture, testing)\r\n```\r\n\r\n### `agent-status`\r\n\r\nCheck workflow progress and active run state.\r\n\r\n---\r\n\r\n## MCP Resources\r\n\r\nThe server exposes project documentation as MCP resources, readable by any compatible client:\r\n\r\n| URI | Contents |\r\n|-----|----------|\r\n| `bootstrap://init` | AI session initialization guide |\r\n| `bootstrap://rules` | Coding rules (`src/.ai/rules.md`) |\r\n| `bootstrap://patterns` | Design patterns (`src/.ai/patterns.md`) |\r\n| `bootstrap://manifest` | Project manifest and capabilities |\r\n\r\n---\r\n\r\n## Live Event Stream (SSE)\r\n\r\nSet the `AIKIT_SSE_PORT` environment variable to also start an HTTP Server-Sent Events server alongside the MCP stdio server:\r\n\r\n```bash\r\nAIKIT_SSE_PORT=3747 npx @ai-agencee/mcp\r\n```\r\n\r\nSubscribe from any HTTP client:\r\n\r\n```js\r\nconst evtSource = new EventSource('http://localhost:3747/events');\r\nevtSource.addEventListener('lane:end', (e) => console.log(JSON.parse(e.data)));\r\n\r\n// Subscribe to a specific run only:\r\nconst evtSource = new EventSource('http://localhost:3747/events?runId=abc123');\r\n```\r\n\r\nEmitted event types: `dag:start`, `dag:end`, `lane:start`, `lane:end`, `llm:call`, `budget:exceeded`, `rbac:denied`, `checkpoint:complete`.\r\n\r\n---\r\n\r\n## OIDC Authentication\r\n\r\nFor enterprise deployments, set `AIKIT_OIDC_ISSUER` to enable OIDC JWT validation on the SSE endpoint:\r\n\r\n```bash\r\nAIKIT_SSE_PORT=3747 \\\r\nAIKIT_OIDC_ISSUER=https://login.microsoftonline.com/<tenant>/v2.0 \\\r\nnpx @ai-agencee/mcp\r\n```\r\n\r\n---\r\n\r\n## ULTRA_HIGH Standards Enforced\r\n\r\n| Rule | Value |\r\n|------|-------|\r\n| File naming | kebab-case only |\r\n| Files | One export per file |\r\n| Types | No `any` allowed |\r\n| Functions | `export const Name = function(...) { ... }` |\r\n| Classes | FORBIDDEN |\r\n| Test coverage | ≥ 95% |\r\n| Performance | ≤ 10% solid-js overhead |\r\n\r\n---\r\n\r\n## Architecture\r\n\r\n- **Transport**: stdio (MCP protocol) + optional HTTP SSE\r\n- **Engine**: delegates DAG execution to [`@ai-agencee/engine`](https://www.npmjs.com/package/@ai-agencee/engine)\r\n- **VS Code bridge**: `createVSCodeSamplingBridge()` routes LLM calls back to Copilot\r\n- **GitHub reporter**: posts DAG run summaries as PR comments\r\n- **OIDC middleware**: JWT validation for the SSE endpoint\r\n\r\n---\r\n\r\n## Related Packages\r\n\r\n| Package | Description |\r\n|---------|-------------|\r\n| [`@ai-agencee/core`](https://www.npmjs.com/package/@ai-agencee/core) | File system utilities and project validation |\r\n| [`@ai-agencee/engine`](https://www.npmjs.com/package/@ai-agencee/engine) | Multi-lane supervised DAG execution engine |\r\n| [`@ai-agencee/cli`](https://www.npmjs.com/package/@ai-agencee/cli) | CLI tool — `ai-kit agent:dag` / `agent:plan` |\r\n\r\n---\r\n\r\n## License\r\n\r\nMIT — see [LICENSE](https://github.com/binaryjack/ai-agencee/blob/main/LICENSE)\r\n\r\n### With Claude\r\n\r\n```\r\n👤 User: @init\r\n\r\n🤖 Assistant: \r\n# AI SESSION INITIALIZED\r\n\r\n## Configuration\r\nU=OWNER\r\nSTD=ULTRA_HIGH\r\n...\r\n\r\nReady to start development with strict standards applied!\r\n\r\n---\r\n\r\n👤 User: @rules\r\n\r\nHow should I name my variables?\r\n\r\n🤖 Assistant:\r\nAll variables must use kebab-case naming:\r\n✓ user-input\r\n✓ api-response  \r\n✗ userData\r\n✗ apiResponse\r\n```\r\n\r\n### With Other AI Assistants\r\n\r\nAny MCP-compatible client can use this server:\r\n- Anthropic Claude\r\n- OpenAI Assistants (with MCP wrapper)\r\n- Cline/cursor\r\n- VS Code Copilot (with MCP integration)\r\n\r\n## Troubleshooting\r\n\r\n### Server not starting\r\n\r\nEnsure you have Node.js 18+ installed:\r\n\r\n```bash\r\nnode --version  # Should be v18.0.0 or higher\r\n```\r\n\r\n### Cannot find project files\r\n\r\nThe server reads files from the current working directory. Make sure you're running it from your project root:\r\n\r\n```bash\r\ncd /path/to/project\r\nnpx @ai-agencee/mcp\r\n```\r\n\r\n### File not found errors\r\n\r\nThe server looks for these paths relative to project root:\r\n- `.github/copilot-instructions.md`\r\n- `src/.ai/rules.md`\r\n- `src/.ai/patterns.md`\r\n- `.github/ai/manifest.xml`\r\n\r\nCreate these files using [@ai-agencee/cli](https://www.npmjs.com/package/@ai-agencee/cli):\r\n\r\n```bash\r\nnpx @ai-agencee/cli init --strict\r\n```\r\n\r\n## License\r\n\r\nMIT - See [LICENSE](../../LICENSE) for details\r\n\r\n## Related Packages\r\n\r\n- [@ai-agencee/cli](https://www.npmjs.com/package/@ai-agencee/cli) - Command-line scaffolding tool\r\n- [@ai-agencee/core](https://www.npmjs.com/package/@ai-agencee/core) - Shared utilities and templates\r\n","readmeFilename":"README.md"}