{"_id":"@aiformasses/mcp-server","name":"@aiformasses/mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@aiformasses/mcp-server","version":"0.1.0","description":"Publish safe static HTML pages through MCP.","keywords":["ai-agents","html","mcp","model-context-protocol","static-publishing"],"homepage":"https://github.com/arunai30/share-html-mcp#readme","bugs":{"url":"https://github.com/arunai30/share-html-mcp/issues"},"repository":{"type":"git","url":"git+https://github.com/arunai30/share-html-mcp.git"},"type":"module","bin":{"share-html-mcp":"dist/index.js"},"exports":{".":{"types":"./dist/server.d.ts","import":"./dist/server.js"},"./client":{"types":"./dist/api-client.d.ts","import":"./dist/api-client.js"}},"scripts":{"clean":"node scripts/clean-dist.mjs","build":"npm run clean && tsc -p tsconfig.json","prepack":"npm run build && node scripts/package-check.mjs","test:release":"node scripts/release-check.mjs","test:cli":"npm run build && node scripts/cli-config.mjs","test:contract":"npm run build && node scripts/contract.mjs","test:mock":"npm run build && node scripts/mock-integration.mjs","test:public":"npm run test:contract && npm run test:cli && npm run test:mock"},"dependencies":{"@modelcontextprotocol/server":"2.0.0","zod":"4.4.3"},"devDependencies":{"@modelcontextprotocol/client":"2.0.0","@types/node":"^22.10.0","typescript":"^5.7.0"},"engines":{"node":">=20.19.0"},"license":"MIT","publishConfig":{"access":"public"},"_id":"@aiformasses/mcp-server@0.1.0","_integrity":"sha512-eiw8hi5owpFvI+8cfWBcSWBzKbB8CX7V1KR+PUAN5xsLKUd0Adj+WTFVfUcv4+ut6thWt0Lt5Dlq3KN0FVxdAw==","_resolved":"/tmp/aiformasses-mcp-release.Sz75wq/aiformasses-mcp-server-0.1.0.tgz","_from":"file:/tmp/aiformasses-mcp-release.Sz75wq/aiformasses-mcp-server-0.1.0.tgz","_nodeVersion":"25.2.0","_npmVersion":"11.6.2","dist":{"integrity":"sha512-eiw8hi5owpFvI+8cfWBcSWBzKbB8CX7V1KR+PUAN5xsLKUd0Adj+WTFVfUcv4+ut6thWt0Lt5Dlq3KN0FVxdAw==","shasum":"36fc778f374b96e221edcb526af0131405c23c2d","tarball":"https://registry.npmjs.org/@aiformasses/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":11,"unpackedSize":17578,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC+iXm54jcoWWCtU5K74k5YwZhbctfMonV8RBYG9htHOgIhAO69dST82LAvHpkr6PTnWR9fkc+UgYginZD1H0+pNdJ1"}]},"_npmUser":{"name":"arun542","email":"arunsingh150693@gmail.com"},"directories":{},"maintainers":[{"name":"arun542","email":"arunsingh150693@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.0_1787439158479_0.4564816886343235"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-22T22:52:38.329Z","0.1.0":"2026-08-22T22:52:38.665Z","modified":"2026-08-22T22:52:38.950Z"},"maintainers":[{"name":"arun542","email":"arunsingh150693@gmail.com"}],"description":"Publish safe static HTML pages through MCP.","homepage":"https://github.com/arunai30/share-html-mcp#readme","keywords":["ai-agents","html","mcp","model-context-protocol","static-publishing"],"repository":{"type":"git","url":"git+https://github.com/arunai30/share-html-mcp.git"},"bugs":{"url":"https://github.com/arunai30/share-html-mcp/issues"},"license":"MIT","readme":"# @aiformasses/mcp-server\n\nPublish safe static HTML pages from an MCP agent and receive a shareable URL.\n\n## Preferred: hosted OAuth\n\nCodex users can connect without installing this package or creating a permanent\ntoken:\n\n```bash\nnpx -y @openai/codex@0.149.0 mcp add share-html --url https://share-html-app-alpha.vercel.app/api/mcp --oauth-client-registration cimd\n```\n\nThe browser authorization flow grants access to your share/html account. Open\nthe [connection page](https://share-html-app-alpha.vercel.app/connect) for the\nlatest verified setup.\n\n## Personal-token fallback\n\nUse this package when your MCP client does not support the hosted OAuth flow.\nIt requires Node.js 20.19 or newer and `npx`:\n\n```bash\nnode --version\nnpx --version\n```\n\nCreate a personal-token connection on the\n[connection page](https://share-html-app-alpha.vercel.app/connect). Copy the\nconfiguration when it appears; share/html cannot display the token again. The\ntoken remains active until you revoke that connection.\n\n### Codex\n\nAdd the server to `~/.codex/config.toml`, then restart only the share-html MCP\nserver from Codex settings. The first start downloads the pinned package through\n`npx`.\n\n```toml\n[mcp_servers.\"share-html\"]\ncommand = \"npx\"\nargs = [\"-y\", \"@aiformasses/mcp-server@0.1.0\"]\n\n[mcp_servers.\"share-html\".env]\nSHARE_HTML_API_BASE_URL = \"https://share-html-app-alpha.vercel.app/api/v1\"\nSHARE_HTML_API_TOKEN = \"shp_...\"\n```\n\n### Standard MCP JSON\n\n```json\n{\n  \"mcpServers\": {\n    \"share-html\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aiformasses/mcp-server@0.1.0\"],\n      \"env\": {\n        \"SHARE_HTML_API_BASE_URL\": \"https://share-html-app-alpha.vercel.app/api/v1\",\n        \"SHARE_HTML_API_TOKEN\": \"shp_...\"\n      }\n    }\n  }\n}\n```\n\nTreat `SHARE_HTML_API_TOKEN` like a password. Do not commit it, paste it into\nHTML, or send it to anyone. If it is lost or exposed, revoke the connection at\nthe connection page and create another.\n\n## Tools\n\nThe server exposes `publish_html`, `update_page`, `get_page`, `list_pages`,\n`publish_page`, `unpublish_page`, and `delete_page`.\n\nThe share/html API sanitizes every document. JavaScript, forms, embeds, and\nexternal network calls are removed or blocked before a page is published.\n\n## Troubleshooting\n\n- `npx: command not found`: install Node.js 20.19 or newer, then reopen your\n  terminal or MCP client.\n- `invalid_api_token`: replace a revoked or incorrect token with a newly created\n  personal-token connection.\n- Request timeout: a mutation may have completed. Use `list_pages` or `get_page`\n  before asking the agent to retry it.\n- Connection failure: confirm the API URL uses HTTPS and that your network can\n  reach `share-html-app-alpha.vercel.app`.\n\nSource and issues: [arunai30/share-html-mcp](https://github.com/arunai30/share-html-mcp)\n","readmeFilename":"README.md","_rev":"1-166df2d0afb46c35afd080fd95664146"}