HelpBot Assistant

How can I help you?

SyncfusionPDFViewerSDKAssistant MCP Server

13 Feb 20268 minutes to read

Overview

The SyncfusionPDFViewerSDKAssistant is a specialized Model Context Protocol (MCP) server that provides intelligent, context-aware coding assistance for Syncfusion PDFViewerSDK across all supported platforms are Windows Forms, WPF, JavaScript, Angular, React, Vue, ASP.NET MVC, ASP.NET Core, Blazor, MAUI and Flutter.
It integrates seamlessly with MCP clients to provide intelligent assistance for building applications with Syncfusion® components.

Key Benefits

  • Instant code generation & explanations for Syncfusion® PDFViewerSDK component.
  • Detailed component documentation and usage examples.
  • Troubleshooting assistance for common integration challenges.

Prerequisites

Before using SyncfusionPDFViewerSDKAssistant, ensure you have:

Unlimited Access

Syncfusion® offers unlimited access to this MCP server. There are no restrictions on:

  • Number of requests
  • Components usage
  • Query types
  • Usage duration

This ensures users can fully leverage Syncfusion® components to enhance their development experience without limitations.

Installation and setup

Before you can invoke the SyncfusionPDFViewerSDKAssistant MCP server, you need to configure your MCP client with these core settings. The Generic MCP Server Settings shown below are identical across all clients:

Generic MCP Server Settings

  • npm package name: @syncfusion/pdfviewersdk-assistant
  • Type: stdio (standard input/output transport)
  • Command: npx
  • Arguments: -y
  • Server name: syncfusionPDFViewerSDKAssistant

API Key Configuration

Login to your Syncfusion account and generate an API Key from the API Key page. Replace YOUR_API_KEY_FILE_PATH or YOUR_API_KEY in the configuration files with your generated key.

There are two options:

  • Using an API Key File (Recommended)

    Store your API key in a separate file and reference its path in the Syncfusion_API_Key_Path environment parameter. This approach is more secure as you don’t expose the key directly in configuration files.

    Supported file formats: .txt or .key file

   "env": {
     "Syncfusion_API_Key_Path": "YOUR_API_KEY_FILE_PATH" // "D:\\syncfusion-key.txt" (or) "D:\\syncfusion-key.key"
    }

  • Direct API Key

    Paste your Syncfusion_API_Key directly in the configuration file’s environment parameter.

   "env": {
     "Syncfusion_API_Key": "YOUR_API_KEY"
  }

SyncfusionPDFViewerSDKAssistant can be configured in various MCP clients. Below are setup instructions for popular environment:

Syncfusion® Code Studio

  • In Code Studio, open MCP Marketplace
    Code Studio Marketplace
  • Go to the Custom Servers tab and click Add MCP Servers
    Custom Server Tab
  • In the dialog that appears, select Accept and Continue to launch the runtime window for configuring the PDF Viewer SDK MCP.
    Run Time Window
  • Choose the NPM package installation mode. Enter the command @syncfusion/pdfviewersdk-assistant in the runtime window and press Enter
    NPM package
  • When prompted, click allow in the opened options and select Direct API key. Enter the API key generated from the Syncfusion API key, then press Enter.
    Syncfusion API key
  • Provide server name such as syncfusion-pdfviewersdk-assistant, then press Enter. The PDF Viewer SDK MCP server will get installed.
  • Once installed, the server will appear in the User Installed Server list and will be added to the config.yaml file.
    PDF Viewer MCP server
  • The server is now ready for use in Code Studio. For more details, refer to the Code Studio documentation.

For additional details, see the Code Studio documentation.

VS Code (GitHub Copilot MCP)

  • To configure an MCP server for a specific workspace, you can create a .vscode/mcp.json file in your workspace folder.

    {
  "servers": {
    "syncfusion-pdfviewersdk-assistant": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@syncfusion/pdfviewersdk-assistant@latest"
      ],
      "env": {
      "Syncfusion_API_Key_Path": "YOUR_API_KEY_FILE_PATH",
        // or
      "Syncfusion_API_Key": "YOUR_API_KEY"
      }
    }
  }
}
  • After updating the configuration in mcp.json, you’ll notice a “Start” option at the top of the config. This allows you to easily start the SyncfusionPDFViewerSDKAssistant server directly from the settings interface without additional commands.
    Start PDF Viewer AI Assistant
  • Confirm that SyncfusionPDFViewerSDKAssistant is being used (this does not happen automatically). Look for a statement in the output, which is similar to:
    • SyncfusionPDFViewerSDKAssistant is running... (in VS Code)
  • For more details, refer to the official Visual Studio documentation.

Cursor

To configure an MCP server for a specific workspace, you can create a .cursor/mcp.json file in your workspace folder.

{
  "mcpServers": {
    "syncfusion-pdfviewersdk-assistant": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@syncfusion/pdfviewersdk-assistant@latest"
      ],
      "env": {
      "Syncfusion_API_Key_Path": "YOUR_API_KEY_FILE_PATH",
      // or
      "Syncfusion_API_Key": "YOUR_API_KEY"
      }
    }
  }
}

For more details, refer to the Cursor documentation.

JetBrains IDEs

  • Go to Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP).
  • Click + Add to add a new MCP server configuration.
  • In the New MCP Server dialog, switch the dropdown as As JSON and add the following config:
{
  "mcpServers": {
    "syncfusion-pdfviewersdk-assistant": {
      "command": "npx",
      "args": [
        "-y",
        "@syncfusion/pdfviewersdk-assistant@latest"
      ],
      "env": {
      "Syncfusion_API_Key_Path": "YOUR_API_KEY_FILE_PATH",
      // or
      "Syncfusion_API_Key": "YOUR_API_KEY"
      }
    }
  }
}
  • Click OK and Apply.

For further assistance, see the JetBrains documentation.

For more detailed information about configuring MCP servers in various clients, refer to the official documentations, e.g., Windsurf

Usage

To activate the SyncfusionPDFViewerSDKAssistant MCP server:

  1. Start your prompt with one of the following:
    • ‘SyncfusionPDFViewerSDKAssistant’
    • ‘/syncfusion-pdfviewersdk-assistant’
    • ‘/syncfusion-pdfviewersdk’
    • ‘@syncfusion-pdfviewersdk’
    • ‘@ask_syncfusion_pdfviewersdk’

    In VS Code, you can also use #SyncfusionPDFViewerSDKAssistant to explicitly invoke the MCP server.

  2. Grant the SyncfusionPDFViewerSDKAssistant MCP server a permission to run for this session, workspace, or always.
  3. For best results, start a new chat for each new topic to maintain clean context.

Mode availability

Syncfusion® MCP Servers provide full access to all AI interaction modes — Ask/Chat, Edit, and Agent — across supported MCP clients.

Best Practices for Effective Usage

  1. Be specific: Mention both platform and component (e.g., “How do I apply conditional formatting to highlight duplicate values in a React Syncfusion Spreadsheet?”).
  2. Provide context: Include details about your use case for more targeted solutions.
  3. Use descriptive queries: Avoid vague questions that lack necessary context.
  4. Start fresh for new topics: Begin a new chat session when switching components or topics.

Example Queries

Here are some effective ways to use SyncfusionPDFViewerSDKAssistant:

  • “Provide code for viewing PDF files using the PDF Viewer in a Blazor Web App.”
  • “Show me a code snippet to load a PDF from Google Drive into Syncfusion PDF Viewer using React”
  • “How do I toggle the annotation toolbar using Angular PDF Viewer”
  • “Explain how to open the thumbnail panel programmatically in Syncfusion PDF Viewer using Vue.”
  • “Provide code to restrict zoom levels between 150% and 300% in JavaScript PDF Viewer.”

Troubleshooting

If you encounter issues:

  • Verify your API key is correctly configured.
  • Ensure the MCP server is enabled in your client’s tools selection.
  • Check that you’re using a compatible MCP client version.
  • Try restarting your development environment.

Support

Product support is available through the following mediums.

See also