# Tailprint — Tailwind-Native Render & PDF Engine + AI Web Scraper

> High-performance developer API and Model Context Protocol (MCP) server for converting Tailwind CSS HTML into vector PDFs, EU Factur-X e-invoices, cached Open Graph preview images, and token-efficient LLM Markdown in under 500ms.

## Core Capabilities
- **Tailwind-Native PDF Engine**: Submits raw HTML styled with arbitrary Tailwind CSS classes (including JIT syntax like `w-[350px]` and dynamic grids) and generates vector-sharp, print-ready PDF documents without build steps or headless browser maintenance.
- **European E-Invoicing (Factur-X / ZUGFeRD / EN 16931)**: Generates legally compliant hybrid PDF/A-3 invoices with embedded CrossIndustryInvoice XML for automated ERP ingestion (DATEV, SAP, Dinero, Billy, Chorus Pro).
- **Open Graph Card Generator**: Renders social preview cards (PNG/JPEG) with automatic SHA-256 caching and sub-400ms cached delivery.
- **LLM Web Scraper**: Scrapes public URLs, strips ads, scripts, and clutter with Mozilla Readability, and outputs token-efficient structured Markdown saving 90%+ context window tokens.
- **Model Context Protocol (MCP)**: Native Remote SSE and stdio CLI integration for Claude Desktop, Cursor, Windsurf, and autonomous AI agents exposing 22 production tools.
- **Developer Tools**: LinkedIn Carousel generator, 3D Device Mockup maker, Visual Regression diff heatmap, and URL-to-Video Reel synthesizer.

## Quick API Reference
- Base URL: https://tailprint.com
- Documentation: https://tailprint.com/docs
- MCP Remote SSE Endpoint: https://tailprint.com/v1/mcp/sse
- Developer Free Tier: 100 free monthly renders with zero credit card required

### Key Endpoints
- POST /v1/render/pdf : Compiles raw HTML + Tailwind CSS to vector PDF
- POST /v1/render/einvoice : Generates EU-compliant Factur-X hybrid PDF/A-3 invoice with embedded XML
- POST /v1/render/image : Compiles raw HTML + Tailwind CSS to 1200x630 PNG/JPEG
- POST /v1/scrape/markdown : Scrapes public URL to clean LLM-ready Markdown
- POST /v1/tools/carousel : Generates 1080x1350 multi-page PDF & cover from Markdown
- POST /v1/tools/visual-diff : Compares before/after URLs and returns visual diff heatmap
- POST /v1/tools/mockup : 3D MacBook Pro + iPhone mockup generator
- POST /v1/tools/reel/script : AI storyboard script & mobile screenrecord video from any article URL
- POST /v1/tools/reel : Renders 9:16 vertical decks, 4:5 carousels, or 16:9 presentations
- POST /v1/auth/claim-free-key : Claim instant free developer API key (100 renders/mo)
- GET /v1/usage : Real-time quota and monthly billing cycle check

## Model Context Protocol (MCP) Setup (22 Tools)
Tailprint includes 22 native tools: `render_pdf`, `render_image`, `generate_einvoice`, `scrape_markdown`, `render_chart`, `generate_qr`, `render_device_mockup`, `stamp_pdf`, `compare_snapshots`, `render_carousel`, `merge_pdfs`, `split_pdf`, `fill_pdf_form`, `compress_pdf`, `render_mermaid`, `render_presentation`, `generate_social_card`, `extract_tables_from_url`, `audit_webpage`, `list_templates`, `render_template`, `get_template_source`.

Claude Desktop (`claude_desktop_config.json`):
```json
{
  "mcpServers": {
    "tailprint": {
      "command": "npx",
      "args": ["-y", "tailprint"],
      "env": {
        "TAILPRINT_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}
```

Cursor IDE & Windsurf:
- Type: sse
- URL: https://tailprint.com/v1/mcp/sse?api_key=YOUR_API_KEY

## Technical Guides & Architecture
- Customer Stories & Showcase: https://tailprint.com/showcase
- Next.js Tailwind to PDF: https://tailprint.com/guides/tailwind-html-to-pdf-nextjs
- European Factur-X & ZUGFeRD E-Invoicing API: https://tailprint.com/guides/factur-x-zugferd-pdf-api
- Why Puppeteer in Serverless Fails (And Alternatives): https://tailprint.com/guides/puppeteer-serverless-pdf-alternatives
- Best MCP Servers for Claude & Cursor (2026): https://tailprint.com/guides/best-mcp-servers-claude-cursor
- Dynamic Open Graph Images with Tailwind & Edge Caching: https://tailprint.com/guides/dynamic-open-graph-images-tailwind
- Automate Social Media Content from Blog URLs: https://tailprint.com/guides/automate-social-media-content-from-blog-url
- Turn Any Article URL into Short-Form Video & Reels: https://tailprint.com/guides/url-to-video-reels-api
- Interactive Reel Maker Tool: https://tailprint.com/tools/reel
- Guides Knowledge Hub: https://tailprint.com/guides