@docujson/mcp

DocuJSON Model Context Protocol (MCP) server. Connect AI assistants like Claude Desktop, Cursor, and other MCP-compatible tools to DocuJSON for PDF generation, template management, and API key operations via natural language.

What it does

This package is a thin stdio bridge that forwards MCP requests from your AI assistant to the hosted DocuJSON MCP server at https://mcp.docujson.com.

With this connected, you can ask your AI assistant things like:

• "Generate an invoice PDF for Acme Corp with 3 line items totaling $4,500"
• "Create a weekly status report template"
• "Show me my PDF usage this month"
• "List all my custom templates"
• "Revise the invoice template to use a blue header"

Installation

You don't install it directly — your MCP client (Claude Desktop) runs npx @docujson/mcp on demand.

Setup

1. Get a DocuJSON API key

1. Sign up at docujson.com/signup
2. Go to Dashboard → API Keys
3. Create a new key (starts with dj_)

2. Configure your MCP client

Claude Desktop

Edit your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the DocuJSON server:

{
  "mcpServers": {
    "docujson": {
      "command": "npx",
      "args": ["-y", "@docujson/mcp"],
      "env": {
        "DOCUJSON_API_KEY": "dj_your_api_key_here"
      }
    }
  }
}

Restart Claude Desktop. You should see DocuJSON tools available in the tools panel.

Cursor (HTTP — recommended)

Cursor supports the HTTP transport directly, so you don't need this stdio bridge. Use the hosted server URL:

Cursor Settings → MCP → Add server:

• Name: docujson
• URL: https://mcp.docujson.com?apiKey=dj_your_api_key

Continue, Zed, or other MCP clients

Use the HTTP URL if your client supports it. Otherwise use the stdio config pattern from the Claude Desktop example above.

Available tools

• generate_pdf — Generate a PDF from any template
• preview_template — Generate a preview (doesn't count toward quota)
• list_templates — List all built-in and custom templates
• get_template — Get template details and JSON schema
• create_custom_template — AI-generate a new template from a description
• update_custom_template — Update template metadata or sample data
• delete_custom_template — Delete a custom template (requires confirmation)
• revise_template — Submit a natural-language revision request
• publish_template — Publish a draft template
• list_api_keys — List workspace API keys
• create_api_key — Create a new API key
• revoke_api_key — Revoke (deactivate) an API key
• get_usage — Monthly PDF usage stats
• get_workspace — Current workspace information
• list_integrations — Supported integration platforms
• get_integration_script — Code snippet for a specific integration

Full tool reference: docujson.com/mcp

Environment variables

• DOCUJSON_API_KEY (required) — Your DocuJSON API key
• DOCUJSON_MCP_URL (optional) — Override the MCP server URL. Defaults to https://mcp.docujson.com

Troubleshooting

"Missing DOCUJSON_API_KEY"

Set the environment variable in your MCP client config (see Setup above).

Tools don't show up in Claude Desktop

• Restart Claude Desktop completely
• Check the developer logs: View → Developer → Open Developer Tools
• Verify the config JSON is valid (trailing commas break it)

"Unauthorized" errors

• Verify your API key is active in the DocuJSON dashboard
• Make sure it starts with dj_

License

MIT

Links

• Documentation: docujson.com/mcp
• API Reference: docujson.com/docs
• Dashboard: docujson.com/dashboard
• Support: support@docujson.com