{"_id":"@amityco/foundry-mcp","_rev":"4-3edf1d9a8fd62ac090388d187f2f564e","name":"@amityco/foundry-mcp","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.0":{"name":"@amityco/foundry-mcp","version":"0.1.0","keywords":["social-plus","mcp","model-context-protocol","sdk","ai-coding"],"license":"UNLICENSED","_id":"@amityco/foundry-mcp@0.1.0","maintainers":[{"name":"ekoapp","email":"developers@amity.co"},{"name":"touchaponk","email":"touchaponk@gmail.com"},{"name":"pakkawat","email":"pakkawat@amity.co"},{"name":"platform-butler","email":"platform@social.plus"},{"name":"phongnarin-anan","email":"phongnarin@social.plus"},{"name":"pasut","email":"pasut@social.plus"}],"homepage":"https://github.com/AmityCo/social-plus-foundry#readme","bugs":{"url":"https://github.com/AmityCo/social-plus-foundry/issues"},"bin":{"foundry-mcp":"dist/server.js","social-plus-foundry":"dist/server.js"},"dist":{"shasum":"50b2118b429a9085773503b50065ffa587330961","tarball":"https://registry.npmjs.org/@amityco/foundry-mcp/-/foundry-mcp-0.1.0.tgz","fileCount":10,"integrity":"sha512-vz7mV5tnWlv1Q58wApkRSDvMs232sZLShRuJOUe+x9+1Fu8hzZZ75UWEz9bT0wVNUXXdljONYRtphrS1eM5Avw==","signatures":[{"sig":"MEUCIQDMjLgwL0WCwWaLPP5x6pYgYGV8Mp+s4fxJsb+X46/xBAIgT1LY74Slss02zNkTs8t+KFq9vMLteggK9vQKhekDIVE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":106544},"type":"module","engines":{"node":">=18"},"gitHead":"425be21e6ae9fba546858f84404cec12b8678fd7","scripts":{"test":"npm run build && node test/run-fixtures.mjs","build":"tsc -p tsconfig.json","start":"node dist/server.js","test:cli":"npm run build && node test/run-cli.mjs","test:mcp":"npm run build && node test/run-mcp-smoke.mjs","validate":"npm run typecheck && npm test && npm run test:mcp && npm run test:cli && npm run test:improvements && npm run pack:check","typecheck":"tsc -p tsconfig.json --noEmit","pack:check":"npm pack --dry-run --cache /private/tmp/social-plus-foundry-npm-cache","publish:check":"npm run validate && npm publish --dry-run --access public --cache /private/tmp/social-plus-foundry-npm-cache","test:improvements":"npm run build && node test/run-improvements.mjs"},"_npmUser":{"name":"platform-butler","email":"platform@social.plus"},"repository":{"url":"git+https://github.com/AmityCo/social-plus-foundry.git","type":"git"},"_npmVersion":"11.4.1","description":"Local MCP server for social.plus SDK integration assistance.","directories":{},"_nodeVersion":"23.9.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.5","@types/node":"^20.11.30"},"_npmOperationalInternal":{"tmp":"tmp/foundry-mcp_0.1.0_1779268666726_0.5809372191890612","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@amityco/foundry-mcp","version":"0.1.1","keywords":["social-plus","mcp","model-context-protocol","sdk","ai-coding"],"license":"UNLICENSED","_id":"@amityco/foundry-mcp@0.1.1","maintainers":[{"name":"ekoapp","email":"developers@amity.co"},{"name":"touchaponk","email":"touchaponk@gmail.com"},{"name":"pakkawat","email":"pakkawat@amity.co"},{"name":"platform-butler","email":"platform@social.plus"},{"name":"phongnarin-anan","email":"phongnarin@social.plus"},{"name":"pasut","email":"pasut@social.plus"}],"homepage":"https://github.com/AmityCo/social-plus-foundry#readme","bugs":{"url":"https://github.com/AmityCo/social-plus-foundry/issues"},"bin":{"foundry-mcp":"dist/server.js","social-plus-foundry":"dist/server.js"},"dist":{"shasum":"33a55825fe2389c607b0cba913639a4b146d38e0","tarball":"https://registry.npmjs.org/@amityco/foundry-mcp/-/foundry-mcp-0.1.1.tgz","fileCount":10,"integrity":"sha512-OcySV0JqNiuMwcP/OWaRROffYq7lWF56RtllpPZkUE5Dl9WTz7Ua7oxvvfxVGfEhW+WP0Y3VgOKvUhdfQlzyuw==","signatures":[{"sig":"MEUCIFFSjp69qTxSrdtsSoSEGcbFK/vzO68B42T6nZ3KPSebAiEAoDL3vRlfdCLyPn68hlWlhUAs8z3F+pb9TNnwIEEeUGY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":106588},"type":"module","engines":{"node":">=18"},"gitHead":"425be21e6ae9fba546858f84404cec12b8678fd7","scripts":{"test":"npm run build && node test/run-fixtures.mjs","build":"tsc -p tsconfig.json","start":"node dist/server.js","test:cli":"npm run build && node test/run-cli.mjs","test:mcp":"npm run build && node test/run-mcp-smoke.mjs","validate":"npm run typecheck && npm test && npm run test:mcp && npm run test:cli && npm run test:improvements && npm run pack:check","postbuild":"chmod +x dist/server.js","typecheck":"tsc -p tsconfig.json --noEmit","pack:check":"npm pack --dry-run --cache /private/tmp/social-plus-foundry-npm-cache","publish:check":"npm run validate && npm publish --dry-run --access public --cache /private/tmp/social-plus-foundry-npm-cache","test:improvements":"npm run build && node test/run-improvements.mjs"},"_npmUser":{"name":"platform-butler","email":"platform@social.plus"},"repository":{"url":"git+https://github.com/AmityCo/social-plus-foundry.git","type":"git"},"_npmVersion":"11.4.1","description":"Local MCP server for social.plus SDK integration assistance.","directories":{},"_nodeVersion":"23.9.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.5","@types/node":"^20.11.30"},"_npmOperationalInternal":{"tmp":"tmp/foundry-mcp_0.1.1_1779269375089_0.28300524954679673","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@amityco/foundry-mcp","version":"0.1.2","keywords":["social-plus","mcp","model-context-protocol","sdk","ai-coding"],"license":"UNLICENSED","_id":"@amityco/foundry-mcp@0.1.2","maintainers":[{"name":"ekoapp","email":"developers@amity.co"},{"name":"touchaponk","email":"touchaponk@gmail.com"},{"name":"pakkawat","email":"pakkawat@amity.co"},{"name":"platform-butler","email":"platform@social.plus"},{"name":"phongnarin-anan","email":"phongnarin@social.plus"},{"name":"pasut","email":"pasut@social.plus"}],"homepage":"https://github.com/AmityCo/social-plus-foundry#readme","bugs":{"url":"https://github.com/AmityCo/social-plus-foundry/issues"},"bin":{"foundry-mcp":"dist/server.js","social-plus-foundry":"dist/server.js"},"dist":{"shasum":"83771eb0a7ba6e509f8154b6702b1c8dd20874fe","tarball":"https://registry.npmjs.org/@amityco/foundry-mcp/-/foundry-mcp-0.1.2.tgz","fileCount":10,"integrity":"sha512-Zz2BorTVrtOe4yDTqV9cbPH3IHcSjV0QOkxFzwmNbMqbdcYM5JcHFAnD2erUtSQAvcT46u8hrV5WCsc4qtggdQ==","signatures":[{"sig":"MEUCIQD2BSGi8A8FOonwDDSBz5H0BQFiX/qTwBrkTR+9qthsIwIgW+6snKysK5dekB3t89A/HaS6nZLNE274pO5qCte9fe4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":107400},"type":"module","engines":{"node":">=18"},"gitHead":"b819277f78b7725fee81e7dc1f19b699f0fe0056","scripts":{"test":"npm run build && node test/run-fixtures.mjs","build":"tsc -p tsconfig.json","start":"node dist/server.js","test:cli":"npm run build && node test/run-cli.mjs","test:mcp":"npm run build && node test/run-mcp-smoke.mjs","validate":"npm run typecheck && npm test && npm run test:mcp && npm run test:cli && npm run test:improvements && npm run pack:check","postbuild":"chmod +x dist/server.js","typecheck":"tsc -p tsconfig.json --noEmit","pack:check":"npm pack --dry-run --cache /private/tmp/social-plus-foundry-npm-cache","publish:check":"npm run validate && npm publish --dry-run --access public --cache /private/tmp/social-plus-foundry-npm-cache","test:improvements":"npm run build && node test/run-improvements.mjs"},"_npmUser":{"name":"platform-butler","email":"platform@social.plus"},"repository":{"url":"git+https://github.com/AmityCo/social-plus-foundry.git","type":"git"},"_npmVersion":"11.4.1","description":"Local MCP server for social.plus SDK integration assistance.","directories":{},"_nodeVersion":"23.9.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.4.5","@types/node":"^20.11.30"},"_npmOperationalInternal":{"tmp":"tmp/foundry-mcp_0.1.2_1779280030328_0.3326362541170065","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@amityco/foundry-mcp","version":"0.1.3","description":"Local MCP server for social.plus SDK integration assistance.","license":"UNLICENSED","type":"module","repository":{"type":"git","url":"git+https://github.com/AmityCo/social-plus-foundry.git"},"homepage":"https://github.com/AmityCo/social-plus-foundry#readme","bugs":{"url":"https://github.com/AmityCo/social-plus-foundry/issues"},"keywords":["social-plus","mcp","model-context-protocol","sdk","ai-coding"],"engines":{"node":">=18"},"publishConfig":{"access":"public"},"bin":{"foundry-mcp":"dist/server.js","social-plus-foundry":"dist/server.js"},"scripts":{"build":"tsc -p tsconfig.json","postbuild":"chmod +x dist/server.js","pack:check":"npm pack --dry-run --cache /private/tmp/social-plus-foundry-npm-cache","publish:check":"npm run validate && npm publish --dry-run --access public --cache /private/tmp/social-plus-foundry-npm-cache","start":"node dist/server.js","test":"npm run build && node test/run-fixtures.mjs","test:cli":"npm run build && node test/run-cli.mjs","test:improvements":"npm run build && node test/run-improvements.mjs","test:mcp":"npm run build && node test/run-mcp-smoke.mjs","typecheck":"tsc -p tsconfig.json --noEmit","validate":"npm run typecheck && npm test && npm run test:mcp && npm run test:cli && npm run test:improvements && npm run pack:check"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.0"},"devDependencies":{"@types/node":"^20.11.30","typescript":"^5.4.5"},"_id":"@amityco/foundry-mcp@0.1.3","gitHead":"95350faeaf88fd84f92a25dc754d45b32c1db362","_nodeVersion":"23.9.0","_npmVersion":"11.4.1","dist":{"integrity":"sha512-w6nyaY4rzXa7w7LYtylT9DuteSrehyWzLq4wg1pRW1hM2oJ2lNeE5KNx2AY3kjVmYCjUmvoze0bdoNF+9AQ5Bw==","shasum":"2867704d9c6242411c484efb9d03a35e9a57d352","tarball":"https://registry.npmjs.org/@amityco/foundry-mcp/-/foundry-mcp-0.1.3.tgz","fileCount":10,"unpackedSize":111841,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEdTog90lXKx2llhPMxnNP8pyzZKA/7+6Kqq5FNxy9Q9AiEA+Po2WpoR4gJELx/AYQ+wjwdwwcl7GqY/GiR0euY04lI="}]},"_npmUser":{"name":"platform-butler","email":"platform@social.plus"},"directories":{},"maintainers":[{"name":"ekoapp","email":"developers@amity.co"},{"name":"touchaponk","email":"touchaponk@gmail.com"},{"name":"pakkawat","email":"pakkawat@amity.co"},{"name":"platform-butler","email":"platform@social.plus"},{"name":"phongnarin-anan","email":"phongnarin@social.plus"},{"name":"pasut","email":"pasut@social.plus"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/foundry-mcp_0.1.3_1779282992289_0.7326826954430392"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-20T09:17:46.602Z","modified":"2026-05-20T13:16:32.697Z","0.1.0":"2026-05-20T09:17:46.970Z","0.1.1":"2026-05-20T09:29:35.297Z","0.1.2":"2026-05-20T12:27:10.483Z","0.1.3":"2026-05-20T13:16:32.446Z"},"bugs":{"url":"https://github.com/AmityCo/social-plus-foundry/issues"},"license":"UNLICENSED","homepage":"https://github.com/AmityCo/social-plus-foundry#readme","keywords":["social-plus","mcp","model-context-protocol","sdk","ai-coding"],"repository":{"type":"git","url":"git+https://github.com/AmityCo/social-plus-foundry.git"},"description":"Local MCP server for social.plus SDK integration assistance.","maintainers":[{"name":"ekoapp","email":"developers@amity.co"},{"name":"touchaponk","email":"touchaponk@gmail.com"},{"name":"pakkawat","email":"pakkawat@amity.co"},{"name":"platform-butler","email":"platform@social.plus"},{"name":"phongnarin-anan","email":"phongnarin@social.plus"},{"name":"pasut","email":"pasut@social.plus"}],"readme":"# Foundry MCP Server\n\nThis is a small stdio MCP server for local social.plus integration assistance.\n\nThe server can inspect repositories, detect design/theme signals, search hosted docs, plan harness guides/sensors, produce grounded integration plans with structured intake questions, validate setup patterns, and run detected project sensors.\n\nFoundry is shipped as a local MCP server because SDK implementation quality depends on both hosted social.plus docs and the customer's local project context. Local MCP lets the host coding tool inspect manifests, app surfaces, design tokens, lifecycle code, and constrained command sensors while keeping source code on the customer's machine.\n\nRemote MCP is better for hosted data or cloud actions, but a remote-only Foundry would either lose project signals or require customers to expose repository context to a hosted service. Assistant-specific skills, instruction packs, and plugins can be useful companions later, but they are not the core product boundary: Foundry keeps quality controls in MCP tool contracts, validators, sensors, and fixtures so the same package works across MCP-capable coding tools.\n\nFrequent customer paths have dedicated guardrails:\n\n- feed and post creation: concrete feed target, no invented communityId/targetId/feedId, no inline API keys\n- notification setup: platform credentials, token source, registration after login, unregister on logout/user switch\n- Live Objects/Collections: object vs collection, observed domain, lifecycle owner, loading/error states, cleanup\n- monorepos: detected app surfaces can be selected with `surfacePath`\n\n`run_sensors` is constrained to detected project commands. It does not accept arbitrary shell input.\n\n## Commands\n\n```sh\nnpm install\nnpm run build\nnpm start\n```\n\nCLI checks:\n\n```sh\nnode dist/server.js --version\nnode dist/server.js doctor\n```\n\nFull local validation:\n\n```sh\nnpm run validate\n```\n\nProduct-oriented Foundry improvement discovery:\n\n```sh\nnpm run test:improvements\n```\n\n## Docs Source\n\nBy default, docs are read from:\n\n```text\nhttps://learn.social.plus/llms-full.txt\n```\n\nMaintainers can set `SOCIAL_PLUS_DOCS_ROOT` to test against a local `social-plus-docs` checkout.\n","readmeFilename":"README.md"}