PUBlish← Back to PUBlish

Developers

Build with PUBlish.

Every public read endpoint, the MCP server, webhooks, embed widgets, and plugins — all free, all auth-free, all CORS-open. No API key needed for reads. Full integration tour →

30-second quickstart

cURL · REST API

# Find PUBlish writers covering a topic
curl 'https://pub-lish.com/api/public/authors/search?q=ai+policy&limit=5'

# Get one author's full profile
curl 'https://pub-lish.com/api/public/authors/jane-novak'

# Cross-author recent feed, filtered by category
curl 'https://pub-lish.com/api/public/pieces/recent?category=building&limit=10'

# Full-text search across piece content
curl 'https://pub-lish.com/api/public/pieces/search?q=hiring+engineers'

# One piece by id, full body
curl 'https://pub-lish.com/api/public/pieces/<piece-id>'

MCP · Claude Desktop

// Claude Desktop config (claude_desktop_config.json)
{
  "mcpServers": {
    "publish": {
      "type": "http",
      "url": "https://pub-lish.com/api/mcp"
    }
  }
}

HTML · Embed

<!-- One-paste widget — works on any site -->
<div data-publish-widget="card" data-slug="jane-novak"></div>
<script src="https://pub-lish.com/embed.js" defer></script>

<!-- Live SVG badge -->
<a href="https://pub-lish.com/author/jane-novak" rel="me">
  <img src="https://pub-lish.com/embed/jane-novak/badge.svg" alt="jane-novak on PUBlish" height="44" />
</a>

Surfaces

Public · auth-free

REST API

Pull author profiles, search authors, list and search pieces. Cross-author recent feed. CORS-open, no API key.

GET /api/public/*

Native AI tools

MCP server

Model Context Protocol. Eight tools — content (search_authors, get_author, recent_pieces, get_piece, search_pieces, trending_pieces) + shop (search_products, get_product). Add to Claude Desktop, Cursor, any MCP client.

POST /api/mcp

AI-readable products

Shop catalogue for AI

llms-products.txt at root — every listing (name, seller, price, category, Stripe URL, writing behind it) in one plain-text crawl. Companion to llms.txt but scoped to buyer-intent queries.

/llms-products.txt

Bearer · drafts only

Write API

POST a piece into PUBlish from your CMS, Zapier, n8n, or AI agent. Every API-created piece lands as a draft — the writer publishes manually. The editorial gate stays in the writer's hands.

POST /api/v1/pieces

Try it live

Interactive API reference

Every endpoint with parameters, response schemas, and an inline "Try it" panel that fires real requests. Code generators for cURL, Node, Python, Go, and more.

Live + interactive

Auto-generate clients

OpenAPI 3.1 spec

Formal spec of every public endpoint. Drop into Postman / Insomnia / openapi-typescript / swagger-codegen.

/api/openapi.json

Real-time push

Publish webhook

Auto-syndicate to your own site or CMS. Writer configures URL, PUBlish POSTs every new piece with HMAC signature. JSON Feed item shape.

X-Publish-Signature

One-paste install

Embed widgets

Universal <script> that renders badge, card, list, or bio widgets on any site. Also a static SVG badge for stores that block scripts.

embed.js · badge.svg

Per-author feeds

JSON Feed + RSS

Every author has /author/<slug>/feed.json (JSON Feed 1.1) and /feed.xml (RSS). Subscribe directly or import via Feedly, Readwise, Inoreader.

/author/<slug>/feed.json

Plugins

Shopify Theme App

Theme App Extension for Shopify stores. Merchants add the PUBlish Author Badge block to any theme section, enter their username, done.

In Shopify review

Plugins

WordPress plugin

PUBlish Author Badge for WordPress / WooCommerce. Shortcode, Gutenberg block, classic widget, settings page with live preview.

[publish_badge]

Machine-readable

LLM discovery

llms.txt with the full URL inventory + /.well-known/mcp.json with the MCP server manifest. AI crawlers find every surface automatically.

/llms.txt
© PUBlish← Back to PUBlish