llms.txt
Compare with other sites' llms.txt files →# Paragraph
> Paragraph is a media engine for your company. You get a website and a newsletter you own, plus an agent that researches topics, drafts in your voice, publishes across channels, and reports what worked. Nothing goes out without your approval.
Paragraph gives company teams one workspace for publishing and distribution. One agent researches topics, drafts posts, builds and maintains an Astro website, generates images and video, posts to X and LinkedIn, sends the newsletter, and reports on performance. Every draft waits for a human. Approval is enforced in the product, not offered as a setting.
## Company
Paragraph was founded in 2022 by [Colin Armstrong](https://armstr.ng/), its CEO. Before Paragraph he led anti-abuse and privacy engineering teams at Google and worked on payments at Coinbase. In May 2024 Paragraph acquired Mirror and raised $5 million from USV and Coinbase Ventures; it has raised $7 million in total.
The platform is built to be read by machines as well as people. Every publication exposes RSS, and publications on paid plans add sitemaps, per-post Markdown, and their own llms.txt. The same data is available through a REST API, a TypeScript SDK, a CLI, and a hosted MCP server.
## What the agent can do
- Research a topic using web search and full-page reads, then draft in your brand voice
- Check a draft before publishing for structure, sourcing, internal links, send timing, and AI-writing tells
- Publish to your site and email your subscribers in one step
- Write and publish X posts and threads, and LinkedIn posts including PDF carousels
- Build, validate, and deploy a custom website, then review its own work from screenshots
- Generate cover images, social cards, and Remotion videos
- Run recurring or event-triggered automations, each scoped to the tools you authorize
- Report on web traffic, newsletter engagement, campaign attribution, and which AI assistants cite your work
## Product
- [Homepage](https://paragraph.com/): Your website, your newsletter, and an agent that runs the work between them
- [Draft](https://paragraph.com/features/draft): The agent researches a topic and writes a first draft in your voice
- [Approve](https://paragraph.com/features/approve): Review every draft before it goes out. Nothing publishes on its own
- [Distribute](https://paragraph.com/features/distribute): Publish to your site, email your subscribers, and post to X and LinkedIn
- [Maintain](https://paragraph.com/features/maintain): Daily upkeep on your site: broken links, metadata, page weight, and SEO
- [Pricing](https://paragraph.com/pricing): Plans, credits, and what each tier includes
- [Free site audit](https://paragraph.com/audit): Check how your site performs for search engines and AI assistants. No account needed
- [Integrations](https://paragraph.com/integrations): Connect the agent to 900+ tools through the Model Context Protocol
- [Website themes](https://paragraph.com/themes): Starting designs for an agent-built Astro site
- [For writers](https://paragraph.com/writers): Own your site, your list, and your reader relationships
- [Glossary](https://paragraph.com/glossary): Publishing, SEO, and AI-search terms explained
## Documentation
- [Quickstart](https://docs.paragraph.com/getting-started/quickstart): Sign up, set up your workspace, and publish your first content
- [Agents](https://docs.paragraph.com/agents): Named agents that run recurring content work, like the Changelog
- [Changelog](https://docs.paragraph.com/agents/changelog): Turn what your team merges on GitHub into articles and posts
- [Distribution](https://docs.paragraph.com/distribute): X posts, LinkedIn posts, X Articles, and newsletters
- [Calendar](https://docs.paragraph.com/distribute/calendar): Review, approve, and schedule everything that goes out
- [Meet Paragraph](https://docs.paragraph.com/paragraph): What Paragraph does and how you work with it
- [Voice and brand](https://docs.paragraph.com/paragraph/voice-and-memory): Teach Paragraph your voice and visual brand
- [Connections](https://docs.paragraph.com/paragraph/connections): Connect X, LinkedIn, Telegram, Slack, and other tools
- [Automations](https://docs.paragraph.com/paragraph/automations): Event-triggered jobs and what they're allowed to do
- [Editor](https://docs.paragraph.com/publishing/editor): Write, format, and publish articles
- [Your website](https://docs.paragraph.com/publishing/website): The default design, a custom site, and SEO
- [Custom domains](https://docs.paragraph.com/publishing/custom-domains): Point your own domain at your website
- [Subscribers](https://docs.paragraph.com/audience/subscribers): Manage, import, and export subscribers
- [Analytics](https://docs.paragraph.com/audience/analytics): Web, newsletter, social, campaign attribution, and AI-assistant traffic
- [Plans and credits](https://docs.paragraph.com/account/plans-and-credits): How credits work, with a link to current pricing
## Discovery
- [Sitemap index](https://paragraph.com/sitemap.xml): Every publication, in chunked sitemaps
- [Trending sitemap](https://paragraph.com/sitemap-trending.xml): Popular content
- [Google News sitemap](https://paragraph.com/sitemap-news.xml): Recent news content
- [Agent skills index](https://paragraph.com/.well-known/agent-skills/index.json): Installable skills that teach an AI agent to use Paragraph
Every publication serves an RSS feed. Publications on paid plans also serve their own `llms.txt` and a Markdown version of each post at the post URL with a `.md` suffix.
## CLI (Command-Line Interface)
The [Paragraph CLI](https://docs.paragraph.com/developers/cli) (`@paragraph-com/cli`) lets you manage posts, publications, and subscribers from the terminal. Designed for both human and agent/programmatic usage. Source: [GitHub](https://github.com/paragraph-xyz/paragraph-cli).
### Install
```bash
npm install -g @paragraph-com/cli
```
Or via Homebrew: `brew tap paragraph-xyz/tap && brew install paragraph`
### Authentication
```bash
paragraph login --token <api-key>
echo "<api-key>" | paragraph login --with-token
PARAGRAPH_API_KEY=<api-key> paragraph post list
```
Get your API key from app.paragraph.com under Settings → API keys.
### Key Commands
```bash
paragraph post list
paragraph post get <id-or-slug>
paragraph post create --title "Title" --file ./draft.md
paragraph post publish <id-or-slug>
paragraph post publish <id-or-slug> --newsletter
paragraph search post --query "topic"
paragraph subscriber list
paragraph analytics query --sql "select 1"
```
### Agent Usage
All commands support `--json` for structured output. Data goes to stdout, status messages to stderr.
```bash
paragraph --json post list | jq '.data[0].title'
paragraph --json post get <id> --field markdown > post.md
```
Set `CI=true` or `PARAGRAPH_NON_INTERACTIVE=1` to disable the interactive TUI. Destructive commands require `--yes` in non-TTY environments and support `--dry-run`.
Run `paragraph --help` for all commands.
### Agent Skills
Install the [Paragraph Agent Skills](https://docs.paragraph.com/developers/agent-skills) to teach AI agents how to use the CLI, REST API, SDK, and MCP server:
```bash
npx skills add paragraph-xyz/skill
```
## MCP Server
The [Paragraph MCP server](https://docs.paragraph.com/developers/mcp) connects AI agents directly to Paragraph via the [Model Context Protocol](https://modelcontextprotocol.io). Manage posts, publications, subscribers, and analytics from any MCP-compatible client. Source: [GitHub](https://github.com/paragraph-xyz/paragraph-mcp).
### Remote server (recommended)
Use the hosted server at `mcp.paragraph.com`. No installation or API key management required. Authentication happens automatically through your Paragraph account in the browser.
Claude Code: `claude mcp add --transport http --scope user paragraph https://mcp.paragraph.com/mcp`, then run `/mcp` to sign in.
Codex: `codex mcp add paragraph --url https://mcp.paragraph.com/mcp`
Cursor and other clients: add to your MCP config:
```json
{
"mcpServers": {
"paragraph": {
"url": "https://mcp.paragraph.com/mcp"
}
}
}
```
To have an agent set itself up, point it at [agent setup](https://docs.paragraph.com/developers/agent-setup.md), which is written for the agent to follow.
### Local server
Alternatively, run the server locally with npx (requires Node.js 18+):
```bash
npx @paragraph-com/mcp
```
Claude Code: `claude mcp add paragraph -- npx @paragraph-com/mcp`
Claude Desktop, Cursor, VS Code: add to your MCP config:
```json
{
"mcpServers": {
"paragraph": {
"command": "npx",
"args": ["@paragraph-com/mcp"],
"env": { "PARAGRAPH_API_KEY": "your-key" }
}
}
}
```
For local usage, set `PARAGRAPH_API_KEY` as an environment variable or log in via the CLI (`npx @paragraph-com/cli login`). Read-only tools work without authentication.
### Available Toolsets
The server exposes 30 tools organized into toolsets: posts (create, update, delete, list, get, send test email), content (short-form drafts), buckets (group drafts with the post they came from), publications (get and update), subscribers (list, count, add, remove), analytics (query your own data with SQL, read the schema), emails, search (posts and publications), users (get profile), feed (curated platform feed), and me (the signed-in publication).
Expose only the tools you need: `npx @paragraph-com/mcp --toolsets posts,search`
## Optional
- [Content Guidelines](https://paragraph.com/content-guidelines): Publishing guidelines
- [Terms of Use](https://paragraph.com/terms-of-use): Platform terms
- [Privacy Policy](https://paragraph.com/privacy): Data protection practices
- [Brand](https://paragraph.com/brand): Logos, names, and usage