@prismism/mcp-server

Servidor MCP para Prismism — DocSend para agentes de IA.

Sube cualquier archivo → obtén un enlace rastreable y compartible. PDF, HTML, Markdown, imágenes, vídeo. Control de acceso, análisis, captura de correo electrónico, webhooks.

Inicio rápido

1. Obtén una clave API

Crea una cuenta gratuita en prismism.dev o utiliza la herramienta prismism_register después de la configuración.

2. Conecta tu cliente

Endpoint alojado (recomendado)

No requiere instalación: conéctate directamente a la API de Prismism:

Claude Code

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

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

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

Cursor — edita .cursor/mcp.json:

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

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

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

VS Code — edita .vscode/mcp.json:

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

Local (stdio) — alternativa

Ejecuta mediante npx si prefieres el transporte local:

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

3. Verifica que funciona

Pregunta a tu agente: "Use the prismism_health tool to check the connection"

Herramientas

Publicación

"Publish this report as a shareable link"

La herramienta prismism_publish admite tres modos:

• Carga de archivos — Establece content (texto plano o base64) + filename. Usa encoding: "base64" para archivos binarios.

• HTML en línea — Establece html con contenido HTML bruto. No se necesita archivo.

• Markdown en línea — Establece markdown con contenido Markdown bruto. No se necesita archivo.

Todos los modos admiten parámetros opcionales: access, password, requireEmail, allowedDomains, allowedEmails, expiresAt y allowNetwork.

Formatos de archivo admitidos: PDF, HTML, Markdown, Imágenes (PNG/JPG/GIF/SVG/WebP), Vídeo (MP4).

Obtención de contenido

"Get the content of my artifact abc123"

La herramienta prismism_content obtiene el contenido bruto del artefacto. Los formatos de texto se devuelven como cadenas UTF-8, los formatos binarios se devuelven como base64. La clave API del propietario omite todas las puertas automáticamente. Para contenido protegido no propio, pasa los parámetros password o email.

Control de acceso

"Make this artifact private"
"Set allowlist access with alice@acme.com"

La herramienta prismism_update admite access (público/privado/lista de permitidos), allowedEmails, password, requireEmail y allowedDomains. Cambiar a privado/lista de permitidos borra silenciosamente las puertas de contraseña y correo electrónico.

Registro sin clave

Si aún no tienes una clave API, la herramienta prismism_register puede crear una cuenta:

"Register me on Prismism with my email"

Devuelve la clave API una vez: el agente te ayudará a guardarla en tu configuración.

Variables de entorno

Formato de respuesta

Todas las herramientas devuelven un sobre JSON consistente:

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

En caso de error:

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

Requisitos

• Endpoint alojado: Sin requisitos: funciona con cualquier cliente MCP

• Local (stdio): Node.js 18+, npm o npx

Licencia

MIT

Enlaces

• Prismism — Enlaces compartibles para cualquier archivo

• Documentación de la API

• Especificación OpenAPI