Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

Paragraph (BYOK) — connector documentation

  • MCP endpoint: https://byok-paragraph.connectorbay.com/mcp
  • REST API: POST https://byok-paragraph.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-paragraph.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own Paragraph Paragraph API key (belongs to one publication), sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-paragraph.connectorbay.com/health · Tool schemas: https://byok-paragraph.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-paragraph · agent@connectorbay.com

What Paragraph (BYOK) is for

Paragraph (BYOK) lets an AI assistant read your own Paragraph data through the Paragraph API with a key you supply (Paragraph API key (belongs to one publication)). Read-only: 11 tools (get_my_publication, get_subscriber_count, get_publication_by_slug, list_my_posts, list_publication_posts, get_post, list_posts_feed, list_posts_by_tag, search_posts, search_publications, list_drafted_content). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to public.api.paragraph.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Paragraph. Paragraph and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "Which Paragraph publication is this key for?"
  • "How many subscribers does my Paragraph publication have?"
  • "Show the Paragraph publication with slug 'example'"
  • "What are my latest Paragraph drafts?"
  • "What has this Paragraph publication published?"
  • "Show this Paragraph post"

What it does

  • get_my_publication: Show the publication the API key belongs to: name, slug, custom domain, summary and plan.
  • get_subscriber_count: Get the total number of subscribers of a publication.
  • get_publication_by_slug: Get a public publication's details by its slug.
  • list_my_posts: List posts of your publication filtered by status (published, draft, scheduled or archived), newest first, without bodies unless asked.
  • list_publication_posts: List the published posts of any publication by its id.
  • get_post: Get one post by id (metadata; body only with include_content).
  • list_posts_feed: List the platform-wide curated feed of recent Paragraph posts.
  • list_posts_by_tag: List published posts that carry one tag, newest first.
  • search_posts: Search posts across all Paragraph publications by text, optionally inside one publication.
  • search_publications: Search Paragraph publications by name, slug or description.
  • list_drafted_content: List short-form content pieces (X posts, LinkedIn posts, newsletters, X articles) in your library with status and schedule flag.

BYOK key

You bring your own Paragraph Paragraph API key (belongs to one publication) (https://docs.paragraph.com/developers). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to public.api.paragraph.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the Paragraph API (public.api.paragraph.com) with a BYOK key; documentation: https://docs.paragraph.com/developers/api-reference. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by Paragraph. Paragraph and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your Paragraph account.

Built for: Worldwide. Languages: English.