Quick Agent Start

A Model Context Protocol (MCP) server that enables Claude Desktop, VSCode, Cursor and other AI agents to upload files and query Synvo AI's powerful document analysis capabilities directly from your development environment.

What Can This MCP Server Do?

This server adds two powerful capabilities to your AI agent:

🚀 Upload & Analyze Files

Upload any document (PDF, DOCX, TXT, images, etc.) to Synvo AI for content extraction and analysis

💬 Query File Contents

Ask questions about uploaded documents and get AI-powered insights with multi-turn conversations

Quick Setup (5 Minutes)

Step 1: Installation

# Install from npm (recommended)
npm install -g @synvo_ai/mcp-server

# Or clone and build locally
git clone https://github.com/synvoai/mcp-server.git
cd mcp-server
npm install
npm run build

Step 2: Get Your API Key

Get your free API key from Synvo Dashboard.

1. Log into your Synvo dashboard
2. Navigate to API Keys section
3. Click "Create New Key"
4. Copy and save the key immediately - you won't see it again!

Step 3: Configure Your AI Client

{
  "mcpServers": {
    "synvo": {
      "command": "npx",
      "args": ["-y", "@synvo_ai/mcp-server"],
      "env": {
        "SYNVO_API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "mcp.servers": {
    "synvo": {
      "command": "npx",
      "args": ["-y", "@synvo_ai/mcp-server"],
      "env": {
        "SYNVO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Usage Examples

Once configured, you can interact with your AI agent using natural language:

Example 1: Analyze a Document

Example 2: Query File Contents

Example 3: Multi-Turn Conversation

Available Tools

1. synvo_upload_file

Upload and analyze documents to make them available for AI queries.

Parameters:

{
  "file_path": "/Users/lucy/Documents/contract.pdf",
  "build_memory": true
}

2. synvo_query_ai

Ask questions about uploaded files or have AI conversations.

Parameters:

{
  "message": "Summarize the key points from the contract",
  "conversation_id": "conv_abc123"
}

Common Use Cases

📄 Document Analysis

🔄 Multi-Document Comparison

🔍 Information Extraction

🌐 Translation & Transformation

Supported File Types

Troubleshooting

Server Not Starting

• Check if Node.js 18+ is installed: node --version
• Verify the build completed: npm run build
• Check logs in Claude Desktop: Menu → Settings → Developer

Upload Failures

• Ensure file path is absolute (not relative)
• Verify file exists and is readable
• Check file size (max 50MB recommended)
• Confirm API key is valid

Query Not Working

• Upload a file first before querying
• Check if conversation_id is valid
• Verify network connectivity to api.synvo.ai

Getting Help

• Check full documentation at https://synvo.ai/docs
• API reference at https://docs.synvo.ai
• Report issues at https://github.com/synvoai/mcp-server/issues

Advanced Configuration

Using a Local Build Instead of NPM

If you prefer to use a local build:

{
  "mcpServers": {
    "synvo": {
      "command": "node",
      "args": ["C:\\path\\to\\synvo-mcp\\dist\\index.js"],
      "env": {
        "SYNVO_API_KEY": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "synvo": {
      "command": "node",
      "args": ["/path/to/synvo-mcp/dist/index.js"],
      "env": {
        "SYNVO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Environment Variables

You can also set the API key globally:

setx SYNVO_API_KEY "your-api-key-here"

{
  "mcpServers": {
    "synvo": {
      "command": "npx",
      "args": ["-y", "@synvo_ai/mcp-server"]
    }
  }
}

export SYNVO_API_KEY="your-api-key-here"

{
  "mcpServers": {
    "synvo": {
      "command": "npx",
      "args": ["-y", "@synvo_ai/mcp-server"]
    }
  }
}

What's Next?

• Explore the full API documentation at docs.synvo.ai
• Join the community on Discord: https://discord.gg/synvoai
• Follow updates on Twitter: @SynvoAI

Need Help? Contact support@synvo.ai or visit https://synvo.ai/support