{
  "markdown": "# @prismism/mcp-server\n\nMCP server for [Prismism](https://prismism.dev) — **DocSend for AI agents.**\n\nUpload any file → get a tracked, shareable link. PDF, HTML, Markdown, images, video. Access control, analytics, email capture, webhooks.\n\n## Quick Start\n\n### 1. Get an API key\n\nCreate a free account at [prismism.dev](https://prismism.dev) or use the `prismism_register` tool after setup.\n\n### 2. Connect your client\n\n#### Hosted endpoint (recommended)\n\nNo install needed — connect directly to the Prismism API:\n\n**Claude Code**\n\n```bash\nclaude mcp add prismism --transport http https://prismism.dev/mcp \\\n  --header \"x-api-key: pal_your_key_here\"\n```\n\n**Claude Desktop** — edit `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"prismism\": {\n      \"url\": \"https://prismism.dev/mcp\",\n      \"headers\": {\n        \"x-api-key\": \"pal_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Cursor** — edit `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"prismism\": {\n      \"url\": \"https://prismism.dev/mcp\",\n      \"headers\": {\n        \"x-api-key\": \"pal_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**Windsurf** — edit `~/.codeium/windsurf/mcp_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"prismism\": {\n      \"serverUrl\": \"https://prismism.dev/mcp\",\n      \"headers\": {\n        \"x-api-key\": \"pal_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n**VS Code** — edit `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"prismism\": {\n      \"type\": \"http\",\n      \"url\": \"https://prismism.dev/mcp\",\n      \"headers\": {\n        \"x-api-key\": \"pal_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n#### Local (stdio) — alternative\n\nRun via npx if you prefer local transport:\n\n```json\n{\n  \"mcpServers\": {\n    \"prismism\": {\n      \"command\": \"npx\",\n      \"args\": [\"@prismism/mcp-server\"],\n      \"env\": {\n        \"PRISMISM_API_KEY\": \"pal_your_key_here\"\n      }\n    }\n  }\n}\n```\n\n### 3. Verify it works\n\nAsk your agent: **\"Use the prismism_health tool to check the connection\"**\n\n## Tools\n\n| Tool | Auth required | Description |\n|------|:---:|-------------|\n| `prismism_health` | — | Check connection and auth status |\n| `prismism_register` | — | Create account + get API key (one-time) |\n| `prismism_publish` | ✓ | Publish a file, HTML, or Markdown and get a shareable link |\n| `prismism_list` | ✓ | List your artifacts with pagination |\n| `prismism_get` | ✓ | Get artifact details + analytics |\n| `prismism_update` | ✓ | Update title, access level, gates, content, or expiration |\n| `prismism_content` | ✓ | Fetch raw artifact content (text or base64) |\n| `prismism_delete` | ✓ | Permanently delete an artifact |\n| `prismism_account` | ✓ | Get account info, plan, and usage |\n\n### Publishing\n\n```\n\"Publish this report as a shareable link\"\n```\n\nThe `prismism_publish` tool supports three modes:\n\n- **File upload** — Set `content` (plain text or base64) + `filename`. Use `encoding: \"base64\"` for binary files.\n- **Inline HTML** — Set `html` with raw HTML content. No file needed.\n- **Inline Markdown** — Set `markdown` with raw Markdown content. No file needed.\n\nAll modes support optional `access`, `password`, `requireEmail`, `allowedDomains`, `allowedEmails`, `expiresAt`, and `allowNetwork` parameters.\n\nSupported file formats: PDF, HTML, Markdown, Images (PNG/JPG/GIF/SVG/WebP), Video (MP4).\n\n### Fetching content\n\n```\n\"Get the content of my artifact abc123\"\n```\n\nThe `prismism_content` tool fetches raw artifact content. Text formats return as UTF-8 strings, binary formats return as base64. Owner API key bypasses all gates automatically. For non-owned gated content, pass `password` or `email` parameters.\n\n### Access control\n\n```\n\"Make this artifact private\"\n\"Set allowlist access with alice@acme.com\"\n```\n\nThe `prismism_update` tool supports `access` (public/private/allowlist), `allowedEmails`, `password`, `requireEmail`, and `allowedDomains`. Changing to private/allowlist silently clears password and email gates.\n\n### Registering without a key\n\nIf you don't have an API key yet, the `prismism_register` tool can create an account:\n\n```\n\"Register me on Prismism with my email\"\n```\n\nIt returns the API key once — the agent will help you save it to your config.\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `PRISMISM_API_KEY` | For most tools | — | Your Prismism API key |\n| `PRISMISM_BASE_URL` | No | `https://prismism.dev` | API base URL |\n\n## Response Format\n\nAll tools return a consistent JSON envelope:\n\n```json\n{\n  \"ok\": true,\n  \"data\": { ... },\n  \"_hints\": [\"Actionable guidance for the agent\"]\n}\n```\n\nOn error:\n\n```json\n{\n  \"ok\": false,\n  \"error\": { \"code\": \"STORAGE_LIMIT\", \"message\": \"...\" },\n  \"_hints\": [\"Upgrade at https://prismism.dev/settings/billing\"]\n}\n```\n\n## Requirements\n\n- **Hosted endpoint**: No requirements — works with any MCP client\n- **Local (stdio)**: Node.js 18+, npm or npx\n\n## License\n\nMIT\n\n## Links\n\n- [Prismism](https://prismism.dev) — Shareable links for any file\n- [API Documentation](https://prismism.dev/docs)\n- [OpenAPI Spec](https://prismism.dev/openapi.yaml)\n",
  "bytes": 5088,
  "sha": "cadc2a176cff1f221aeba6a0fb2d8e679525f3a4c802832a4310bd10966b5d09",
  "repo_slug": "prismism-dev/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_dev_prismism_mcp_67dae2cf/readme"
}