{"_id":"@agent-workbench-for-copilot-studio/mcp-server","name":"@agent-workbench-for-copilot-studio/mcp-server","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@agent-workbench-for-copilot-studio/mcp-server","version":"1.0.0","description":"Model Context Protocol server exposing Agent Workbench for Copilot Studio knowledge, parsing, and assessment tools for any MCP-aware LLM client.","license":"MIT","repository":{"type":"git","url":"git+https://github.com/nlloydjenkins/CPSAgentKit.git","directory":"packages/mcp-server"},"homepage":"https://github.com/nlloydjenkins/CPSAgentKit/tree/main/packages/mcp-server#readme","bugs":{"url":"https://github.com/nlloydjenkins/CPSAgentKit/issues"},"keywords":["mcp","model-context-protocol","copilot-studio","cps","power-platform","llm","knowledge","assessment"],"main":"./dist/index.js","bin":{"agent-workbench-mcp":"dist/bin.js","cpsagentkit-mcp":"dist/bin.js"},"scripts":{"prebuild":"node ../../scripts/copy-shared-assets.js","compile":"npm run prebuild && tsc -p ./","bundle":"npm run prebuild && node scripts/bundle.js","watch":"npm run prebuild && tsc -watch -p ./","start:stdio":"node ./out/bin.js --transport=stdio","start:http":"node ./out/bin.js --transport=http","lint":"eslint src --ext ts","test":"vitest run","prepublishOnly":"npm run bundle"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","zod":"~3.25.0"},"devDependencies":{"@agent-workbench-for-copilot-studio/core":"1.0.0","@types/node":"^20.11.0","esbuild":"^0.24.0","typescript":"^5.3.0"},"engines":{"node":">=18.0.0"},"publishConfig":{"access":"public"},"_id":"@agent-workbench-for-copilot-studio/mcp-server@1.0.0","gitHead":"cf17e8fdbdc62265277f0e3f0119fb1e75481c6f","_nodeVersion":"22.19.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-6DpUsoGqhjJ50xVpmv+yif++DWASWLtFumQuTCkvU8zg2dZPTiMvjr9h1drMALX90HCVXSnPjs1jB4lQ4Qogdg==","shasum":"1dc88c7c4ad94e202a75f9cab853e7bd2bd0b385","tarball":"https://registry.npmjs.org/@agent-workbench-for-copilot-studio/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":34,"unpackedSize":1012110,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAYztEMj8RdQdxB/VL/TuBGM5REy94qOhkf6dTejzc8VAiBsM52bD1+e/Qr7YCiu8seWlA4M3Y6QE1SawDwVyKhNkQ=="}]},"_npmUser":{"name":"nlloydjenkins","email":"nick@lloyd-jenkins.com"},"directories":{},"maintainers":[{"name":"nlloydjenkins","email":"nick@lloyd-jenkins.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.0_1779881078157_0.6171983360450917"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-27T11:24:38.049Z","1.0.0":"2026-05-27T11:24:38.323Z","modified":"2026-05-27T11:24:38.481Z"},"maintainers":[{"name":"nlloydjenkins","email":"nick@lloyd-jenkins.com"}],"description":"Model Context Protocol server exposing Agent Workbench for Copilot Studio knowledge, parsing, and assessment tools for any MCP-aware LLM client.","homepage":"https://github.com/nlloydjenkins/CPSAgentKit/tree/main/packages/mcp-server#readme","keywords":["mcp","model-context-protocol","copilot-studio","cps","power-platform","llm","knowledge","assessment"],"repository":{"type":"git","url":"git+https://github.com/nlloydjenkins/CPSAgentKit.git","directory":"packages/mcp-server"},"bugs":{"url":"https://github.com/nlloydjenkins/CPSAgentKit/issues"},"license":"MIT","readme":"# @cpsagentkit/mcp-server\r\n\r\n**Model Context Protocol server** exposing [Agent Workbench for Copilot Studio](https://github.com/nlloydjenkins/CPSAgentKit)'s Copilot Studio knowledge, parsing, and assessment tools to any MCP-aware LLM client (Claude Desktop, VS Code, Cursor, custom agents).\r\n\r\n## Install\r\n\r\n```bash\r\n# One-shot via npx (no install)\r\nnpx @cpsagentkit/mcp-server --transport=stdio\r\n\r\n# Or install globally\r\nnpm install -g @cpsagentkit/mcp-server\r\ncpsagentkit-mcp --transport=stdio\r\n```\r\n\r\n## Transports\r\n\r\n- **stdio** (default): for MCP clients that spawn the server as a subprocess\r\n- **HTTP (Streamable)**: for clients that connect to a long-running server\r\n\r\n```bash\r\ncpsagentkit-mcp --transport=stdio\r\ncpsagentkit-mcp --transport=http --host=127.0.0.1 --port=3333\r\n```\r\n\r\nThe HTTP endpoint is `POST /mcp` and follows the MCP Streamable HTTP spec.\r\n\r\n## Claude Desktop / MCP client config\r\n\r\nAdd to your `claude_desktop_config.json` (or equivalent):\r\n\r\n```json\r\n{\r\n  \"mcpServers\": {\r\n    \"cpsagentkit\": {\r\n      \"command\": \"npx\",\r\n      \"args\": [\"-y\", \"@cpsagentkit/mcp-server\", \"--transport=stdio\"]\r\n    }\r\n  }\r\n}\r\n```\r\n\r\n## Tools\r\n\r\nThe server registers the following tools:\r\n\r\n### Knowledge retrieval\r\n\r\n- **`cps_list_knowledge_topics`** — lists every bundled CPS knowledge and best-practice document. Optional `category` filter (`knowledge` | `bestpractices`).\r\n- **`cps_get_knowledge`** — returns the full markdown body of a knowledge document by slug.\r\n- **`cps_get_best_practice`** — returns the full markdown body of a best-practice document by slug.\r\n\r\n### Workspace parsing\r\n\r\n- **`cps_detect_project_state`** — snapshot of a workspace (initialised? spec/arch present? agents cloned?).\r\n- **`cps_list_agents`** — finds all cloned CPS agent folders in a workspace.\r\n- **`cps_parse_agent`** — reads one cloned agent folder into a structured snapshot (settings, topics, actions, knowledge).\r\n- **`cps_parse_solution`** — reads an exported CPS solution folder (solution.xml + botcomponents/) into agent snapshots plus metadata.\r\n- **`cps_find_solution_folders`** — scans a directory for exported CPS solution folders.\r\n\r\n### Assessment\r\n\r\n- **`cps_validate_tool_description`** — lint-checks a tool/topic/agent description against CPS prompt-engineering rules.\r\n- **`cps_compose_review_prompt`** — assembles a complete solution review prompt from workspace + bundled rules; scope can be `full` | `prompts` | `descriptions` | `architecture`.\r\n\r\n### Build context\r\n\r\n- **`cps_generate_topic_scaffolds`** — extracts topic scaffolds from architecture.md.\r\n- **`cps_detect_dataverse_mcp`** — checks for Dataverse MCP configuration in `.vscode/mcp.json`.\r\n\r\n## Resources\r\n\r\nEvery bundled knowledge and best-practice document is also registered as an MCP resource with URI `cpsagentkit://<category>/<slug>`, so clients with resource UIs can browse them without invoking tools.\r\n\r\n## License\r\n\r\nMIT — see [LICENSE](../../LICENSE).\r\n\r\n## Hosted endpoint\r\n\r\nA public anonymous instance is hosted on Azure Container Apps:\r\n\r\n```\r\nhttps://ca-mcp-6frsoq6bw5vuk.salmonstone-8b839f60.uksouth.azurecontainerapps.io/mcp\r\n```\r\n\r\n(Once DNS is configured, `https://cpsagentkit.codeworks.app/mcp` will resolve to the same endpoint.)\r\n\r\nThe hosted instance runs with `MCP_HOSTED=1`, which exposes only the tools that don't need access to your local workspace: `cps_list_knowledge_topics`, `cps_get_knowledge`, `cps_get_best_practice`, `cps_validate_tool_description`, `cps_parse_prompt_config`, `cps_build_prompt_update`. For workspace parsing / review composition use the stdio transport described above.\r\n\r\nVS Code `.vscode/mcp.json`:\r\n\r\n```jsonc\r\n{\r\n  \"servers\": {\r\n    \"cpsagentkit-hosted\": {\r\n      \"type\": \"http\",\r\n      \"url\": \"https://ca-mcp-6frsoq6bw5vuk.salmonstone-8b839f60.uksouth.azurecontainerapps.io/mcp\"\r\n    }\r\n  }\r\n}\r\n```\r\n\r\nDeployment details, including how to enable optional API-key auth, live in [`docs/deployment/mcp-server-azure.md`](../../docs/deployment/mcp-server-azure.md).\r\n","readmeFilename":"README.md","_rev":"1-7bd900a49f00f5c05290e7c636178203"}