ZeBridge
Documentation

Complete Platform Documentation

Everything you need to integrate ZeBridge with your AI agents and applications

Getting Started

ZeBridge is a secure MCP (Model Context Protocol) server that connects AI agents to powerful document processing, image manipulation, and data transformation tools.

Quick Start

  1. Sign Up: Create your account at zebridge.vercel.app
  2. Generate API Key: Navigate to Dashboard → API Keys
  3. Configure MCP: Add ZeBridge to your AI agent's MCP configuration
  4. Start Building: Use any of our 13+ tools through your AI agent

Authentication

ZeBridge uses API key authentication for secure access to all endpoints and tools.

Getting Your API Key

  1. Sign in to your ZeBridge dashboard
  2. Go to the "API Keys" tab
  3. Click "Generate New Key"
  4. Give your key a descriptive name
  5. Copy and securely store your API key

⚠️ Security Best Practices

  • Never commit API keys to version control
  • Store keys in environment variables
  • Rotate keys periodically
  • Revoke unused keys immediately

MCP Configuration

Configure ZeBridge with any MCP-compatible client (Kiro IDE, Claude Desktop, etc.)

For Kiro IDE

Add to .kiro/settings/mcp.json:

{
  "mcpServers": {
    "zebridge": {
      "url": "https://zebridge.vercel.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

For Claude Desktop

Add to Claude's MCP settings file:

{
  "mcpServers": {
    "zebridge": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-http"],
      "env": {
        "MCP_HTTP_URL": "https://zebridge.vercel.app/mcp",
        "MCP_HTTP_HEADERS": "Authorization: Bearer YOUR_API_KEY"
      }
    }
  }
}

REST API Reference

All tools are also available via REST API for direct integration.

Base URL

https://zebridge.vercel.app/v1/tools

Authentication Header

Authorization: Bearer YOUR_API_KEY

Example: PDF Merge

POST /v1/tools/pdf-merge
Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

{
  "pdfUrls": [
    "https://example.com/doc1.pdf",
    "https://example.com/doc2.pdf"
  ],
  "outputFilename": "merged.pdf"
}

Response Format

{
  "success": true,
  "fileUrl": "https://zebridge.vercel.app/v1/download/outputs/...",
  "filename": "merged.pdf",
  "size": 524288,
  "executionId": "uuid-here"
}

Available Tools

PDF Merge

Combine multiple PDFs

/v1/tools/pdf-merge

PDF Split

Split PDF by pages

/v1/tools/pdf-split

PDF to DOCX

Convert PDF to Word

/v1/tools/pdf-to-docx

Image Upscale

Enhance image resolution

/v1/tools/image-upscale

Remove Background

Remove image backgrounds

/v1/tools/remove-background

Generate QR Code

Create QR codes

/v1/tools/generate-qrcode

Generate Invoice

Create professional invoices

/v1/tools/generate-invoice

Generate Receipt

Create receipts

/v1/tools/generate-receipt

HTML to PDF

Convert HTML to PDF

/v1/tools/html-to-pdf

Markdown to PDF

Convert Markdown to PDF

/v1/tools/markdown-to-pdf

Text to DOCX

Create Word documents

/v1/tools/text-to-docx

JSON to Excel

Convert JSON to spreadsheet

/v1/tools/json-to-excel

OCR Extract Text

Extract text from images

/v1/tools/ocr-extract-text

Usage Examples

With Kiro IDE

Once configured, simply ask your AI agent:

"Merge these two PDFs: doc1.pdf and doc2.pdf"

"Generate a QR code for https://example.com"

"Remove the background from image.png"

JavaScript Example

const response = await fetch('https://zebridge.vercel.app/v1/tools/generate-qrcode', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    data: 'https://example.com',
    size: 512
  })
});

const result = await response.json();
console.log('QR Code URL:', result.fileUrl);

Python Example

import requests

response = requests.post(
    'https://zebridge.vercel.app/v1/tools/image-upscale',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    json={
        'imageUrl': 'https://example.com/image.jpg',
        'scaleFactor': '2x'
    }
)

result = response.json()
print('Upscaled image:', result['fileUrl'])

Need Help?

Can't find what you're looking for? We're here to help!

Contact SupportGo to Dashboard