Skip to main content

MCP Server Overview

The Json2doc MCP (Model Context Protocol) Server enables AI assistants to interact with the Json2doc API through a standardized protocol. This allows you to generate documents using natural language conversations with your favorite AI tools.

What is MCP?​

The Model Context Protocol (MCP) is an open standard that allows AI assistants to connect to external tools and services. It provides a unified way for AI models to:

  • Access external APIs and services
  • Execute tools and functions
  • Retrieve and manipulate data
  • Interact with specialized systems

Json2doc MCP Server​

Json2doc provides a public MCP server that you can use immediately without any setup or hosting:

https://mcp.json2doc.com

Key Features​

  • ✅ Public & Ready to Use - No self-hosting required
  • ✅ Streamable HTTP - Real-time communication via HTTP streaming
  • ✅ Multi-tenant - Each user provides their own API key
  • ✅ Secure - API keys are never stored, only forwarded
  • ✅ Smart Caching - 6-hour schema caching for optimal performance
  • ✅ Full API Access - All Json2doc features available

How It Works​

The Json2doc MCP server acts as a bridge between your AI assistant and the Json2doc API:

  1. You configure your AI assistant with the MCP server URL
  2. You provide your Json2doc API key in the configuration
  3. The MCP server forwards your API key to the Json2doc API
  4. All operations are performed using your account and quota
info

The MCP server acts as a bridge and does not store your API key. It only forwards it with each request to the Json2doc API.

Supported AI Assistants​

The Json2doc MCP server works with any MCP-compatible AI assistant. We provide detailed setup guides for:

What You Can Do​

Once configured, your AI assistant can help you:

Document Creation​

  • Create PDFs and DOCX documents from natural language descriptions
  • Build complex multi-section documents incrementally
  • Generate documents with custom styling and formatting
  • Use templates for consistent document generation

Content Management​

  • Organize and retrieve generated documents
  • Handle document versioning

Workflow Automation​

  • Generate documents based on data or context
  • Create document series with consistent formatting
  • Automate report generation
  • Build custom document pipelines

Example Conversations​

Simple Document​

You: "Create a PDF with a title 'Project Proposal' and a paragraph explaining our new feature."

AI: "I'll create that document for you..."
[Creates document builder session, adds sections, generates PDF]

AI: "Done! Your document is ready. Job ID: job_abc123"

Complex Report​

You: "Create a quarterly report with:
- Cover page with our logo
- Executive summary
- Financial charts
- Conclusion with recommendations"

AI: "I'll build this report step by step..."
[Creates session, adds cover, summary, charts, conclusion]

AI: "Your quarterly report is ready for download!"

Template-Based​

You: "Generate an invoice for customer John Doe, amount $1,500"

AI: "I'll use your invoice template..."
[Finds template, fills in variables, generates document]

AI: "Invoice generated successfully!"

Getting Started​

To start using the MCP server:

  1. Get a Json2doc API Key

    • Sign up at app.json2doc.com
    • Navigate to Settings → API Keys
    • Create and copy your API key

  2. Choose Your AI Assistant

    • Select from Claude Desktop, Windsurf, or Cursor
    • Follow the specific setup guide

  3. Configure the Connection

    • Add the MCP server URL
    • Provide your API key
    • Restart your AI assistant

  4. Start Creating

    • Ask your AI to create documents
    • The AI will use Json2doc automatically

Technical Details​

Transport Protocol​

The MCP server uses Streamable HTTP for communication:

  • Endpoint: https://mcp.json2doc.com/mcp
  • Protocol: MCP 2024-11-05
  • Authentication: x-api-key header

Performance​

  • Schema Caching: 6 hours TTL
  • Response Time: Less than 100ms for cached schemas
  • Availability: 99.9% uptime SLA

Rate Limiting​

Rate limits are enforced by the Json2doc API based on your subscription plan:

  • Free Plan: 100 requests/day
  • Hobby Plan: 1,000 requests/day
  • Pro Plan: 10,000 requests/day

Check your dashboard for current limits.

Best Practices​

1. Use Document Builder for Complex Documents​

For documents with multiple sections:

  • ✅ Let the AI use Document Builder sessions
  • ✅ Build incrementally, section by section
  • ✅ Review and modify before final generation

2. Provide Clear Instructions​

Be specific about:

  • Document type (PDF or DOCX)
  • Page size and orientation
  • Content structure and sections
  • Styling requirements

3. Leverage Templates​

For recurring documents:

  • Create templates in the dashboard
  • Reference them in conversations
  • Let the AI fill in variables

4. Monitor Your Usage​

  • Check your dashboard regularly
  • Monitor API quota usage
  • Upgrade plan if needed

Security & Privacy​

API Key Security​

  • ✅ API keys are transmitted securely via HTTPS
  • ✅ Keys are never stored on the MCP server
  • ✅ Each request is authenticated individually
  • ✅ You can revoke keys anytime in the dashboard

Data Privacy​

  • Your documents are processed by Json2doc API
  • Generated files are stored according to your plan
  • Files are automatically deleted after TTL expires
  • No data is shared with third parties

Support​

Need help with the MCP integration?

Next Steps​

Choose your AI assistant to get started: