> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pdfnoodle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Integration

> Connect AI assistants to pdf noodle using the Model Context Protocol

The Model Context Protocol (MCP) is an open standard that enables AI assistants to interact with external services. With pdf noodle's MCP integration, you can generate professional PDFs directly from conversations with AI tools like Claude, Cursor, and ChatGPT.

```
AI Assistant  ───────▶  MCP Server  ───────▶  pdf noodle API
(Claude, Cursor,       (Local or              (PDF Generation)
 ChatGPT, etc.)         Remote)
```

The MCP server acts as a bridge between your AI assistant and the pdf noodle API, enabling natural language PDF generation.

## Why Use MCP?

<CardGroup cols={2}>
  <Card title="Natural Language" icon="message">
    Generate PDFs by simply describing what you need. No code required.
  </Card>

  <Card title="AI-Powered" icon="brain">
    Let AI handle the complexity of HTML formatting and PDF parameters.
  </Card>

  <Card title="Template Management" icon="copy">
    Create, list, and use templates directly from your AI assistant.
  </Card>

  <Card title="Best Practices Built-in" icon="check">
    AI follows PDF best practices automatically for professional output.
  </Card>
</CardGroup>

## Connection Options

pdf noodle MCP supports two deployment modes to fit your workflow:

<Tabs>
  <Tab title="Remote Server (Recommended)">
    Connect to our hosted MCP endpoint. No installation required—just configure your AI assistant with the remote URL.

    ```
    https://mcp.pdfnoodle.com/mcp?api_key=YOUR_API_KEY
    ```

    **Best for:** ChatGPT, Claude.ai (web), quick setup, always up-to-date
  </Tab>

  <Tab title="Local Server">
    Run the MCP server on your machine using Node.js. Your API key stays local.

    ```bash theme={null}
    npx mcp-server-pdfnoodle
    ```

    **Best for:** Claude Desktop, Cursor, offline access, enterprise environments
  </Tab>
</Tabs>

## Supported AI Assistants

| Assistant       | Remote | Local | Recommended |
| --------------- | ------ | ----- | ----------- |
| Claude Desktop  | ✅      | ✅     | Local       |
| Cursor          | ✅      | ✅     | Local       |
| Windsurf        | ✅      | ✅     | Local       |
| ChatGPT         | ✅      | ❌     | Remote      |
| Claude.ai (Web) | ✅      | ❌     | Remote      |
| n8n             | ✅      | ❌     | Remote      |

## What You Can Do

### Generate PDFs

<AccordionGroup>
  <Accordion title="From Templates" icon="file-invoice">
    Use pre-built templates with dynamic data:

    * Invoices with line items and totals
    * Reports with charts and tables
    * Certificates with custom names and dates
    * Letters with personalized content
  </Accordion>

  <Accordion title="From HTML" icon="code">
    Convert any HTML directly to PDF:

    * Custom documents with full CSS control
    * Dynamic content generated by AI
    * Complex layouts with images and tables
    * Multi-page documents with headers/footers
  </Accordion>
</AccordionGroup>

### Manage Templates

* **List templates** in your account
* **View template details** and required variables
* **Create new templates** using AI from natural language descriptions
* **Get template schemas** to understand what data is needed

## Quick Example

Here's how simple it is to generate a PDF with MCP:

<CodeGroup>
  ```text User Prompt theme={null}
  Create an invoice PDF for Acme Corp with the following:
  - Invoice number: INV-2025-001
  - Client: John Smith, 123 Main St
  - Items: Web Development ($2,500), Hosting ($500), Support ($300)
  - Due date: March 1, 2025
  ```

  ```text AI Response theme={null}
  I've created your invoice! Here's the PDF:

  📄 Download: https://pdfnoodle.com/pdf/abc123...

  The invoice includes:
  - Professional header with Acme Corp branding
  - Itemized table with all services
  - Subtotal, tax calculation, and total
  - Payment terms and due date
  ```
</CodeGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Setup Guide" icon="gear" href="/integrations/mcp/setup">
    Configure MCP for your AI assistant
  </Card>

  <Card title="Tools Reference" icon="wrench" href="/integrations/mcp/tools">
    Explore all available MCP tools
  </Card>

  <Card title="Examples" icon="lightbulb" href="/integrations/mcp/examples">
    Real-world prompts and use cases
  </Card>

  <Card title="Best Practices" icon="star" href="/integrations/mcp/best-practices">
    Learn the PDF Best Practices skill
  </Card>
</CardGroup>

## Resources

* [GitHub Repository](https://github.com/pdfnoodle/mcp-server-pdfnoodle) - Source code and issues
* [npm Package](https://www.npmjs.com/package/mcp-server-pdfnoodle) - Install via npm
* [PDF Best Practices](https://github.com/pdfnoodle/pdf-best-practices) - HTML-to-PDF guidelines
* [MCP Protocol Specification](https://modelcontextprotocol.io) - Official MCP documentation