Prismism

@prismism/mcp-server

MCP server for Prismism — DocSend for AI agents.

Upload any file → get a tracked, shareable link. PDF, HTML, Markdown, images, video. Access control, analytics, email capture, webhooks.

Quick Start

1. Get an API key

Create a free account at prismism.dev or use the prismism_register tool after setup.

2. Connect your client

Hosted endpoint (recommended)

No install needed — connect directly to the Prismism API:

Claude Code

claude mcp add prismism --transport http https://prismism.dev/mcp \  --header "x-api-key: pal_your_key_here"

Claude Desktop — edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{  "mcpServers": {    "prismism": {      "url": "https://prismism.dev/mcp",      "headers": {        "x-api-key": "pal_your_key_here"      }    }  }}

Cursor — edit .cursor/mcp.json:

{  "mcpServers": {    "prismism": {      "url": "https://prismism.dev/mcp",      "headers": {        "x-api-key": "pal_your_key_here"      }    }  }}

Windsurf — edit ~/.codeium/windsurf/mcp_config.json:

{  "mcpServers": {    "prismism": {      "serverUrl": "https://prismism.dev/mcp",      "headers": {        "x-api-key": "pal_your_key_here"      }    }  }}

VS Code — edit .vscode/mcp.json:

{  "servers": {    "prismism": {      "type": "http",      "url": "https://prismism.dev/mcp",      "headers": {        "x-api-key": "pal_your_key_here"      }    }  }}

Local (stdio) — alternative

Run via npx if you prefer local transport:

{  "mcpServers": {    "prismism": {      "command": "npx",      "args": ["@prismism/mcp-server"],      "env": {        "PRISMISM_API_KEY": "pal_your_key_here"      }    }  }}

3. Verify it works

Ask your agent: "Use the prismism_health tool to check the connection"

Tools

Publishing

"Publish this report as a shareable link"

The prismism_publish tool supports three modes:

• File upload — Set content (plain text or base64) + filename. Use encoding: "base64" for binary files.
• Inline HTML — Set html with raw HTML content. No file needed.
• Inline Markdown — Set markdown with raw Markdown content. No file needed.

All modes support optional access, password, requireEmail, allowedDomains, allowedEmails, expiresAt, and allowNetwork parameters.

Supported file formats: PDF, HTML, Markdown, Images (PNG/JPG/GIF/SVG/WebP), Video (MP4).

Fetching content

"Get the content of my artifact abc123"

The 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.

Access control

"Make this artifact private""Set allowlist access with [email protected]"

The prismism_update tool supports access (public/private/allowlist), allowedEmails, password, requireEmail, and allowedDomains. Changing to private/allowlist silently clears password and email gates.

Registering without a key

If you don't have an API key yet, the prismism_register tool can create an account:

"Register me on Prismism with my email"

It returns the API key once — the agent will help you save it to your config.

Environment Variables

Response Format

All tools return a consistent JSON envelope:

{  "ok": true,  "data": { ... },  "_hints": ["Actionable guidance for the agent"]}

On error:

{  "ok": false,  "error": { "code": "STORAGE_LIMIT", "message": "..." },  "_hints": ["Upgrade at https://prismism.dev/settings/billing"]}

Requirements

• Hosted endpoint: No requirements — works with any MCP client
• Local (stdio): Node.js 18+, npm or npx

License

MIT

Links

• Prismism — Shareable links for any file
• API Documentation
• OpenAPI Spec