{"_id":"@aimodes/mcp-server","_rev":"2-60f3d37bdbed02c8dcc4db34d4fadb91","name":"@aimodes/mcp-server","dist-tags":{"latest":"0.1.1"},"versions":{"0.1.0":{"name":"@aimodes/mcp-server","version":"0.1.0","keywords":["aimodes","ai-engagement","mcp","mcp-server","modelcontextprotocol"],"author":{"url":"https://aimodes.ai","name":"AI Modes"},"license":"MIT","_id":"@aimodes/mcp-server@0.1.0","maintainers":[{"name":"calelamb","email":"calejlamb@gmail.com"}],"homepage":"https://aimodes.ai","bugs":{"url":"https://github.com/mk-bold/aimodes-site/issues"},"bin":{"aimodes-mcp":"dist/index.js"},"dist":{"shasum":"aed9abead4392a50fc0483b135a782febc9f913a","tarball":"https://registry.npmjs.org/@aimodes/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":44,"integrity":"sha512-ov5NE8pxaElc5CJKGrn6JcfT/Hgu7vHZXsGDvo4DOg6zW9RuGJDEaO+hd1FgL9ftp/vBVcDlZQJ1fCbmEFGIHA==","signatures":[{"sig":"MEQCIGlTKOwMS3M/jLKAVDqVWvT6Jq+KX6ePmYFVpyeDyxrEAiAivc17ZFxz+/KYmuMgGZ97FEGGlySRi1vDr1vq/E0urg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":134160},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"dev":"node --watch dist/index.js","test":"node --test --experimental-strip-types src/*.test.ts","build":"tsc -p tsconfig.json","start":"node dist/index.js","typecheck":"tsc -p tsconfig.json --noEmit","prepublishOnly":"npm run build"},"_npmUser":{"name":"calelamb","email":"calejlamb@gmail.com"},"repository":{"url":"git+https://github.com/mk-bold/aimodes-site.git","type":"git","directory":"connectors/servers/mcp"},"_npmVersion":"10.9.2","description":"Standalone AI Modes MCP server — score AI conversations against the eight-mode engagement typology from any MCP host (Claude Desktop, Gemini CLI, VSCode, Cursor).","directories":{},"_nodeVersion":"22.13.1","dependencies":{"zod":"^3.23.8","@aimodes/connector-core":"^0.1.0","@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.14.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1782942295124_0.424342692746968","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@aimodes/mcp-server","version":"0.1.1","description":"Standalone AI Modes MCP server — score AI conversations against the eight-mode engagement typology from any MCP host (Claude Desktop, Gemini CLI, VSCode, Cursor).","type":"module","license":"MIT","author":{"name":"AI Modes","url":"https://aimodes.ai"},"homepage":"https://aimodes.ai","repository":{"type":"git","url":"git+https://github.com/mk-bold/aimodes-site.git","directory":"connectors/servers/mcp"},"keywords":["aimodes","ai-engagement","mcp","mcp-server","modelcontextprotocol"],"bin":{"aimodes-mcp":"dist/index.js"},"main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"publishConfig":{"access":"public"},"scripts":{"build":"tsc -p tsconfig.json","typecheck":"tsc -p tsconfig.json --noEmit","test":"node --test --experimental-strip-types src/*.test.ts","start":"node dist/index.js","dev":"node --watch dist/index.js","prepublishOnly":"npm run build"},"engines":{"node":">=18"},"dependencies":{"@aimodes/connector-core":"^0.1.0","@modelcontextprotocol/sdk":"^1.12.0","zod":"^3.23.8"},"devDependencies":{"typescript":"^5.5.0","@types/node":"^20.14.0"},"_id":"@aimodes/mcp-server@0.1.1","bugs":{"url":"https://github.com/mk-bold/aimodes-site/issues"},"_nodeVersion":"22.13.1","_npmVersion":"10.9.2","dist":{"integrity":"sha512-i99Ytr6h4e4sP2bw6JyJWFTSb9bszAjRNQEt9Oged8ElH4SXl+yrzZ23foeLHpYuMYtbBcr/Vk8ivhxZbONTRw==","shasum":"2847d1a79c94f940431d16cc766c23948c714e56","tarball":"https://registry.npmjs.org/@aimodes/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":44,"unpackedSize":135338,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIEkF0rkpsCOFzh4WagUCUy0s5QA/McO+nE+lzEprbbgdAiB7Fl49SF97OK22POIN69VR8Mmix+/hMu+xxnWXEe3XUg=="}]},"_npmUser":{"name":"calelamb","email":"calejlamb@gmail.com"},"directories":{},"maintainers":[{"name":"calelamb","email":"calejlamb@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.1_1782944110321_0.008066282585267981"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-01T21:44:54.994Z","modified":"2026-07-01T22:15:10.737Z","0.1.0":"2026-07-01T21:44:55.313Z","0.1.1":"2026-07-01T22:15:10.540Z"},"bugs":{"url":"https://github.com/mk-bold/aimodes-site/issues"},"author":{"name":"AI Modes","url":"https://aimodes.ai"},"license":"MIT","homepage":"https://aimodes.ai","keywords":["aimodes","ai-engagement","mcp","mcp-server","modelcontextprotocol"],"repository":{"type":"git","url":"git+https://github.com/mk-bold/aimodes-site.git","directory":"connectors/servers/mcp"},"description":"Standalone AI Modes MCP server — score AI conversations against the eight-mode engagement typology from any MCP host (Claude Desktop, Gemini CLI, VSCode, Cursor).","maintainers":[{"name":"calelamb","email":"calejlamb@gmail.com"}],"readme":"# @aimodes/mcp-server\n\nStandalone [AI Modes](https://aimodes.ai) MCP server — score AI conversations\nagainst the eight-mode engagement typology from any MCP host: Claude Desktop,\nGemini CLI, VSCode (Copilot agent mode), Cursor, and ChatGPT connectors.\n\nAI Modes scores conversations 0–100 against a research-backed engagement\nframework developed at BYU and returns a per-mode breakdown. This server\nexposes that scoring pipeline as MCP tools, authenticated with the same device\ntoken the AI Modes Chrome extension uses.\n\n## Quick start\n\n1. Mint a device token at <https://aimodes.ai/apps/ai-engagement/extension/auth>\n2. Run the server:\n\n```bash\nAIMODES_DEVICE_TOKEN=<token> npx -y @aimodes/mcp-server\n```\n\nBy default the server speaks **stdio** (what desktop apps and IDEs expect).\nPass `--http` for a stateless streamable-HTTP server instead:\n\n```bash\nAIMODES_DEVICE_TOKEN=<token> npx -y @aimodes/mcp-server --http --port 8787\n```\n\n## MCP host configuration\n\nTypical `mcp.json` / MCP server entry:\n\n```json\n{\n  \"mcpServers\": {\n    \"aimodes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aimodes/mcp-server\"],\n      \"env\": { \"AIMODES_DEVICE_TOKEN\": \"<token>\" }\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `submit_conversation` | Submit role-tagged turns for scoring on aimodes.ai |\n| `score_transcript` | Score a loose pasted transcript (parsed into turns first) |\n| `get_status` | Check auth/device-token status |\n| `get_results` | Fetch the score breakdown for a prior submission |\n| `list_modes` | List the eight engagement modes |\n| `explain_mode` | Explain one mode in depth |\n\n## Configuration\n\n| Setting | How | Default |\n|---|---|---|\n| Device token | `AIMODES_DEVICE_TOKEN` env var | required for scoring |\n| API base URL | `AIMODES_API_URL` env var or `--api-url` | `https://aimodes.ai` |\n| Transport | `--http` flag | stdio |\n| HTTP port | `--port` | 8787 |\n\nBuilt on [`@aimodes/connector-core`](https://www.npmjs.com/package/@aimodes/connector-core)\nand the official [MCP SDK](https://www.npmjs.com/package/@modelcontextprotocol/sdk).\n\n## License\n\nMIT © AI Modes\n","readmeFilename":"README.md"}