@paragraph-com/mcp

Servidor MCP (Model Context Protocol) para Paragraph — expón tu publicación a agentes de IA en Claude Desktop, Cursor, VS Code Copilot y cualquier cliente compatible con MCP.

Servidor remoto (recomendado)

Usa el servidor alojado en mcp.paragraph.com — no se requiere instalación ni gestión de claves API. Te autenticarás a través de tu cuenta de Paragraph en el navegador.

Claude Code

claude mcp add paragraph --transport http https://mcp.paragraph.com/mcp

Claude Desktop

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

Cursor

Añade a .cursor/mcp.json:

{
  "mcpServers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

VS Code

Añade a .vscode/mcp.json:

{
  "servers": {
    "paragraph": {
      "url": "https://mcp.paragraph.com/mcp"
    }
  }
}

Related MCP server: thegraph-mcp

Servidor local

Si prefieres ejecutar el servidor localmente, puedes usar npx. Requiere Node.js 18+.

npx @paragraph-com/mcp

Autenticación (solo local)

El servidor remoto gestiona la autenticación automáticamente. Para uso local, configura tu clave API mediante la variable de entorno:

PARAGRAPH_API_KEY=your-key npx @paragraph-com/mcp

O inicia sesión con la Paragraph CLI — el servidor MCP comparte la misma configuración:

npx @paragraph-com/cli login
npx @paragraph-com/mcp

Configuración local por cliente

claude mcp add paragraph -- npx @paragraph-com/mcp

Añade a claude_desktop_config.json:

{
  "mcpServers": {
    "paragraph": {
      "command": "npx",
      "args": ["@paragraph-com/mcp"],
      "env": {
        "PARAGRAPH_API_KEY": "your-key"
      }
    }
  }
}

Añade a .cursor/mcp.json o .vscode/mcp.json:

{
  "servers": {
    "paragraph": {
      "command": "npx",
      "args": ["@paragraph-com/mcp"],
      "env": {
        "PARAGRAPH_API_KEY": "your-key"
      }
    }
  }
}

Streamable HTTP (local)

npx @paragraph-com/mcp --http --port 3100

El modo HTTP se vincula a 127.0.0.1 (solo localhost) y acepta solicitudes POST. Hay una comprobación de estado disponible en GET /health.

Herramientas disponibles

Posts

• get-post — Obtén un post por ID o slugs

• list-posts — Lista los posts de una publicación o tus propios posts

• create-post — Crea un nuevo post (markdown)

• update-post — Actualiza un post existente

• delete-post — Elimina un post

• send-test-email — Envía un boletín de prueba para un borrador

Contenido

Contenido breve en borrador: posts e hilos de X, posts de LinkedIn, correos electrónicos puntuales y X Articles. Estas herramientas solo redactan; el redactor envía la pieza desde la aplicación de Paragraph.

• create-content — Guarda una pieza en la biblioteca de tu publicación

• list-content — Lista tu biblioteca, filtrable por tipo y estado

• get-content — Obtén una pieza, con su cuerpo

• update-content — Renombra una pieza o reemplaza su cuerpo

• archive-content — Archiva una pieza sin eliminarla

• restore-content — Recupera una pieza archivada

Publicaciones

• get-publication — Obtén los metadatos de la publicación por ID, slug o dominio

Suscriptores

• list-subscribers — Lista tus suscriptores

• get-subscriber-count — Obtén el número de suscriptores

• add-subscriber — Añade un suscriptor por correo electrónico o wallet

Usuarios

• get-user — Obtén el perfil de usuario por ID o wallet

Monedas

• get-coin — Obtén los metadatos de una moneda o lista las monedas populares

• list-coin-holders — Obtén los tenedores de la moneda

Búsqueda

• search-posts — Busca posts

• search-blogs — Busca publicaciones

• search-coins — Busca monedas

Feed

• get-feed — Obtén el feed curado de la plataforma

Mi cuenta

• get-me — Obtén la información de tu publicación autenticada

Analítica

• analytics-query — Ejecuta una consulta SQL de solo lectura contra las analíticas de tu publicación (tasas de apertura, CTR, número de suscriptores, posts principales, etc.)

• analytics-schema — Lista las tablas y columnas disponibles en el esquema de analíticas

Filtrado de conjuntos de herramientas

Expón únicamente las herramientas que tu agente necesite:

npx @paragraph-com/mcp --toolsets posts,search

Conjuntos de herramientas disponibles: posts, content, publications, subscribers, users, coins, search, feed, me, analytics, emails

Ejemplos

Buscar y resumir posts sobre un tema

Prompt: "Busca posts sobre gobernanza onchain y dame un resumen de los mejores resultados"

El servidor MCP llama a search-posts con la consulta. Claude recibe los posts coincidentes y sintetiza un resumen de los temas, autores y publicaciones clave.

Redactar y publicar un post de blog

Prompt: "Escribe un post titulado 'Weekly Update #12' sobre nuestra nueva función de token-gating y luego publícalo"

El servidor llama a create-post con el título y el contenido markdown generado, creándolo como borrador. Después de que confirmes, llama a update-post para establecer el estado en published, publicándolo en tu publicación.

Obtener analíticas de suscriptores

Prompt: "¿Cuántos suscriptores tiene mi publicación? Muéstrame los más recientes."

El servidor llama a get-me para identificar tu publicación, luego a get-subscriber-count para el total, y a list-subscribers para devolver los suscriptores más recientes con sus detalles.

Responder preguntas sobre el rendimiento del boletín

Prompt: "¿Cuál es mi tasa de apertura media en los últimos 30 días y qué posts tuvieron mejor rendimiento?"

El servidor llama a analytics-query con una consulta SQL acotada contra post_analytics_summary, devolviendo tasas de apertura, CTR y vistas para cada post. Claude resume la tendencia y destaca los de mejor rendimiento.

Explorar el feed de la plataforma

Prompt: "¿Qué está en tendencia en Paragraph ahora mismo?"

El servidor llama a get-feed para recuperar el feed curado de la plataforma y Claude resume los posts principales, sus autores y temas.

Gestionar el ciclo de vida de los posts

Prompt: "Muéstrame mis borradores y envía un correo de prueba para el más reciente"

El servidor llama a list-posts con status: draft para recuperar tus borradores, y luego a send-test-email con el ID del borrador más reciente para que puedas previsualizar el boletín en tu bandeja de entrada antes de enviarlo a los suscriptores.

Soporte

• Problemas y errores: GitHub Issues

• Correo electrónico: support@paragraph.com

• Sitio web: paragraph.com

Lanzamiento

npm run release patch   # 1.0.0 → 1.0.1
npm run release minor   # 1.0.0 → 1.1.0
npm run release major   # 1.0.0 → 2.0.0

Compila, ejecuta pruebas, publica en npm, despliega el Cloudflare Worker en mcp.paragraph.com y crea un release de GitHub. El script solicitará las credenciales que falten.

Política de privacidad

Este servidor MCP se conecta a la API de Paragraph en tu nombre. Consulta la Política de privacidad de Paragraph para obtener detalles sobre la recopilación, el uso, el almacenamiento de datos y tus derechos.

Licencia

MIT