Skip to main content
Glama
Sign In
deenesjakoruzh
Paragraph MCP

Paragraph MCP

Official
by paragraph-xyz
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

@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

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive
ResponsivenessOutdated data

Resources

Related MCP Connectors

Related MCP Servers