@paragraph-com/mcp

MCP-Server (Model Context Protocol) für Paragraph — machen Sie Ihre Publikation für KI-Agenten in Claude Desktop, Cursor, VS Code Copilot und jedem MCP-kompatiblen Client zugänglich.

Remote-Server (empfohlen)

Nutzen Sie den gehosteten Server unter mcp.paragraph.com — keine Installation oder Verwaltung von API-Schlüsseln erforderlich. Sie authentifizieren sich im Browser über Ihr Paragraph-Konto.

Claude Code

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

Claude Desktop

Fügen Sie zu claude_desktop_config.json hinzu:

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

Cursor

Fügen Sie zu .cursor/mcp.json hinzu:

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

VS Code

Fügen Sie zu .vscode/mcp.json hinzu:

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

Related MCP server: thegraph-mcp

Lokaler Server

Wenn Sie den Server lieber lokal ausführen möchten, können Sie npx verwenden. Erfordert Node.js 18+.

npx @paragraph-com/mcp

Authentifizierung (nur lokal)

Der Remote-Server übernimmt die Authentifizierung automatisch. Für die lokale Nutzung legen Sie Ihren API-Schlüssel über eine Umgebungsvariable fest:

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

Oder melden Sie sich mit der Paragraph CLI an — der MCP-Server verwendet dieselbe Konfiguration:

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

Lokale Einrichtung pro Client

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

Fügen Sie zu claude_desktop_config.json hinzu:

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

Fügen Sie zu .cursor/mcp.json oder .vscode/mcp.json hinzu:

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

Streamable HTTP (lokal)

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

Der HTTP-Modus bindet an 127.0.0.1 (nur localhost) und akzeptiert POST-Anfragen. Ein Health-Check ist unter GET /health verfügbar.

Verfügbare Tools

Posts

• get-post — Ruft einen Beitrag anhand von ID oder Slugs ab

• list-posts — Listet Beiträge einer Publikation oder Ihre eigenen Beiträge auf

• create-post — Erstellt einen neuen Beitrag (Markdown)

• update-post — Aktualisiert einen vorhandenen Beitrag

• delete-post — Löscht einen Beitrag

• send-test-email — Sendet einen Test-Newsletter für einen Entwurf

Content

Kurzform-Inhalte als Entwurf — X-Posts und Threads, LinkedIn-Posts, einmalige E-Mails und X Articles. Diese Tools erstellen nur Entwürfe; der Autor sendet den Beitrag aus der Paragraph-App.

• create-content — Speichert einen Beitrag in der Bibliothek Ihrer Publikation

• list-content — Listet Ihre Bibliothek auf, filterbar nach Art und Status

• get-content — Ruft einen Beitrag mit seinem Inhalt ab

• update-content — Benennt einen Beitrag um oder ersetzt seinen Inhalt

• archive-content — Legt einen Beitrag ab, ohne ihn zu löschen

• restore-content — Stellt einen archivierten Beitrag wieder her

Publications

• get-publication — Ruft Metadaten einer Publikation anhand von ID, Slug oder Domain ab

Subscribers

• list-subscribers — Listet Ihre Abonnenten auf

• get-subscriber-count — Ruft die Anzahl der Abonnenten ab

• add-subscriber — Fügt einen Abonnenten per E-Mail oder Wallet hinzu

Users

• get-user — Ruft ein Benutzerprofil anhand von ID oder Wallet ab

Coins

• get-coin — Ruft Coin-Metadaten ab oder listet beliebte Coins auf

• list-coin-holders — Ruft Coin-Inhaber ab

Search

• search-posts — Durchsucht Beiträge

• search-blogs — Durchsucht Publikationen

• search-coins — Durchsucht Coins

Feed

• get-feed — Ruft den kuratierten Plattform-Feed ab

Me

• get-me — Ruft Informationen zu Ihrer authentifizierten Publikation ab

Analytics

• analytics-query — Führt eine schreibgeschützte SQL-Abfrage gegen die Analysedaten Ihrer Publikation aus (Öffnungsraten, CTR, Abonnentenzahlen, Top-Beiträge usw.)

• analytics-schema — Listet verfügbare Tabellen und Spalten im Analytics-Schema auf

Toolset-Filterung

Stellen Sie Ihrem Agenten nur die Tools bereit, die er benötigt:

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

Verfügbare Toolsets: posts, content, publications, subscribers, users, coins, search, feed, me, analytics, emails

Beispiele

Beiträge zu einem Thema suchen und zusammenfassen

Prompt: „Suche nach Beiträgen über Onchain-Governance und gib mir eine Zusammenfassung der besten Ergebnisse"

Der MCP-Server ruft search-posts mit der Abfrage auf. Claude erhält die passenden Beiträge und erstellt eine Zusammenfassung der wichtigsten Themen, Autoren und Publikationen.

Einen Blogbeitrag entwerfen und veröffentlichen

Prompt: „Schreibe einen Beitrag mit dem Titel ‚Weekly Update #12' über unsere neue Token-Gating-Funktion und veröffentliche ihn dann"

Der Server ruft create-post mit dem Titel und dem generierten Markdown-Inhalt auf und erstellt ihn als Entwurf. Nach Ihrer Bestätigung ruft er update-post auf, um den Status auf published zu setzen und den Beitrag auf Ihrer Publikation live zu schalten.

Abonnenten-Analysen abrufen

Prompt: „Wie viele Abonnenten hat meine Publikation? Zeig mir die neuesten."

Der Server ruft get-me auf, um Ihre Publikation zu identifizieren, dann get-subscriber-count für die Gesamtzahl und list-subscribers, um die neuesten Abonnenten mit ihren Details zurückzugeben.

Fragen zur Newsletter-Performance beantworten

Prompt: „Wie hoch ist meine durchschnittliche Öffnungsrate in den letzten 30 Tagen, und welche Beiträge waren am erfolgreichsten?"

Der Server ruft analytics-query mit einer eingeschränkten SQL-Abfrage gegen post_analytics_summary auf und liefert Öffnungsraten, CTR und Aufrufe für jeden Beitrag. Claude fasst den Trend zusammen und hebt die besten Beiträge hervor.

Den Plattform-Feed erkunden

Prompt: „Was ist gerade auf Paragraph im Trend?"

Der Server ruft get-feed auf, um den kuratierten Plattform-Feed abzurufen, und Claude fasst die Top-Beiträge, ihre Autoren und Themen zusammen.

Den Lebenszyklus von Beiträgen verwalten

Prompt: „Zeig mir meine Entwürfe und sende eine Test-E-Mail für den neuesten"

Der Server ruft list-posts mit status: draft auf, um Ihre Entwürfe abzurufen, und dann send-test-email mit der ID des neuesten Entwurfs, damit Sie den Newsletter vor dem Senden an Abonnenten in Ihrem Posteingang in der Vorschau ansehen können.

Support

• Probleme & Fehler: GitHub Issues

• E-Mail: support@paragraph.com

• Website: paragraph.com

Veröffentlichung

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

Erstellt Builds, führt Tests aus, veröffentlicht auf npm, stellt den Cloudflare Worker unter mcp.paragraph.com bereit und erstellt ein GitHub-Release. Das Skript fragt nach fehlenden Anmeldedaten.

Datenschutzerklärung

Dieser MCP-Server verbindet sich in Ihrem Namen mit der Paragraph-API. Einzelheiten zur Datenerfassung, -nutzung, -speicherung und zu Ihren Rechten finden Sie in der Datenschutzerklärung von Paragraph.

Lizenz

MIT