JSON to Excel MCP by WTSolutions

中文

Introduction

The JSON to Excel MCP (Model Context Protocol) provides a standardized interface for converting JSON data into CSV format string using the Model Context Protocol. This MCP implementation offers two specific tools for data conversion:

• json_to_excel_mcp_from_data: Converts JSON data string into CSV format.
• json_to_excel_mcp_from_url: Converts JSON file from a provided URL (.json format) into CSV format string.

JSON to Excel MCP is part of JSON to Excel toolkit by WTSolutions:

• JSON to Excel Web App: Convert JSON to Excel directly in Web Browser.
• JSON to Excel Excel Add-in: Convert JSON to Excel in Excel, works with Excel environment seamlessly.
• JSON to Excel WPS Add-in: Convert JSON to Excel in WPS, works with WPS environment seamlessly.
• JSON to Excel API: Convert JSON to Excel by HTTPS POST request.
• JSON to Excel MCP Service: Convert JSON to Excel by AI Model MCP SSE/StreamableHTTP request. (<-- You are here.)

Server Config

Available MCP Servers (SSE and Streamable HTTP):

Using Stdio (NPX)

Server Config JSON:

Case 1 : Free Version (Up to processing 6 Rows of data)

If you are using the free version:

{
  "mcpServers": {
    "json-to-excel-mcp": {
      "args": [
        "json-to-excel-mcp"        
      ],
      "command": "npx"
    }
  }
}

Case 2 : Pro Version

If you are using the pro version (with a valid proCode):

{
  "mcpServers": {
    "json-to-excel-mcp": {
      "args": [
        "json-to-excel-mcp"        
      ],
      "command": "npx",
      "env": {
        "proCode": "type in your proCode here"
      }
    }
  }
}

Using SSE

Not supported starting from v0.3.0

Using Streamable HTTP

Not supported starting from v0.3.0

MCP Tools

json_to_excel_mcp_from_data

Converts JSON data string into CSV format string.

Parameters

Parameter	Type	Required	Description
data	string	Yes	JSON data string to be converted to CSV. Must be a valid JSON array or object.
options	object	No	Optional configuration object for customizing the conversion process.

Note:

• Input data must be a valid JSON string. JSON schema available at JSON Schema and validator available at JSON to Excel Web App.
• If the JSON is an array of objects, each object will be treated as a row in the CSV.
• If the JSON is a single object, it will be converted into a CSV with key-value pairs.
• The CSV will include headers based on the keys in the JSON objects.
• This tool returns CSV-formatted data that can be easily converted/imported to Excel.

Options Object

The options object can contain the following properties:

Property	Type	Default	Description
proCode	string	""	Pro Code JSON to Excel service.
jsonMode	string	"flat"	Format mode for JSON output: "nested", or "flat"
delimiter	string	"."	Delimiter character for nested JSON keys when using jsonMode: "nested", acceptable delimiters are ".", "_", "__", "/".
maxDepth	string	"unlimited"	Maximum depth for nested JSON objects when using jsonMode: "nested". For maxDepth, "unlimited", "1" ~ "20" acceptable.

Note:

• If you do not have a valid Pro Code, max 6 rows will be processed.
• Detailed conversion rules can be found in Features.

Example Prompt 1:

Convert the following JSON data into CSV format:

[
  {"Name": "John Doe", "Age": 25, "IsStudent": false},
  {"Name": "Jane Smith", "Age": 30, "IsStudent": true}
]

Example Prompt 2:

Convert the following JSON object into CSV format:

{
  "Name": "John Doe",
  "Age": 25,
  "IsStudent": false,
  "Courses": ["Math", "Science"]
}

json_to_excel_mcp_from_url

Converts JSON data from a provided URL into Excel data.

Parameters

Parameter	Type	Required	Description
url	string	Yes	URL pointing to a JSON file (.json)
options	object	No	Optional configuration object for customizing the conversion process.

Note:

• The url should be publicly accessible.
• The JSON file should be in .json format.
• The JSON file should contain a valid JSON array or object. JSON schema available at JSON Schema and validator available at JSON to Excel Web App.
• If the JSON is an array of objects, each object will be treated as a row in the CSV.
• If the JSON is a single object, it will be converted into a CSV with key-value pairs.
• This tool returns CSV-formatted data that can be easily converted/imported to Excel.

Options Object

The options object can contain the following properties:

Property	Type	Default	Description
proCode	string	""	Pro Code for JSON to Excel service.
jsonMode	string	"flat"	Format mode for JSON output: "nested", or "flat"
delimiter	string	"."	Delimiter character for nested JSON keys when using jsonMode: "nested", acceptable delimiters are ".", "_", "__", "/".
maxDepth	string	"unlimited"	Maximum depth for nested JSON objects when using jsonMode: "nested". For maxDepth, "unlimited", "1" ~ "20" acceptable.

Note:

• If you do not have a valid Pro Code, max 6 rows will be processed.
• Detailed conversion rules can be found in Pro Features.

Example Prompt 1

Convert JSON file to Excel, file URL: https://mcp.wtsolutions.cn/example.json

Example Prompt 2

(applicable only when you do not have a URL and working with online AI LLM)

I've just uploaded one .json file to you, please extract its URL and send it to MCP tool 'json_to_excel_mcp_from_url', for JSON to Excel conversion.

Response Format

The MCP tools return a JSON object with the following structure:

Field	Type	Description
isError	boolean	Indicates if there was an error processing the request
msg	string	'success' or error description
data	string	Converted CSV data string, '' if there was an error. This CSV data can be easily imported into Excel.

Example Success Response

{
  "content": [{
    "type": "text",
    "text": "{\"isError\":false,\"msg\":\"success\",\"data\":\"Name,Age,IsStudent\nJohn Doe,25,false\nJane Smith,30,true\"}"
  }]
}

Above is the response from MCP tool, and in most cases your LLM should interpret the response and present you with a JSON object, for example as below.

Note, different LLM models may have different ways to interpret the JSON object, so please check if the JSON object is correctly interpreted by your LLM model.

{
  "isError": false,
  "msg": "success",
  "data": "Name,Age,IsStudent\nJohn Doe,25,false\nJane Smith,30,true"
}

Example Failed Response

{
  "content": [{
    "type": "text",
    "text": "{\"isError\": true, \"msg\": \"Invalid JSON format\", \"data\": \"\"}"
  }]
}

Above is the response from MCP tool, and in most cases your LLM should interpret the response and present you with a JSON object, for example as below.

Note, different LLM models may have different ways to interpret the JSON object, so please check if the response is correctly interpreted by your LLM model.

{
  "isError": true,
  "msg": "Invalid JSON format",
  "data": ""
}

or it is also possible that your LLM would say "Invalid JSON format, please provide a valid JSON string" to you.

Data Type Handling

The API automatically handles different data types in JSON:

• Numbers: Converted to numeric values in CSV
• Booleans: Converted to 'true'/'false' strings
• Strings: Escaped and quoted if necessary
• Arrays: Converted to JSON.stringify array string
• Objects: Converted to JSON.stringify object string

Error Handling

The MCP returns descriptive error messages for common issues:

• Invalid JSON format: When input data is not a valid JSON string
• Empty JSON data: When input data is an empty JSON string
• Network Error when fetching file: When there's an error downloading the file from the provided URL
• File not found: When the file at the provided URL cannot be found
• Server Internal Error: When an unexpected error occurs
• Pro Code Invalid: When the provided Pro Code is invalid or not subscribed
• Max 6 rows processed: When no valid Pro Code is provided, only the first 6 rows of data will be processed

Service Agreement and Privacy Policy

By using JSON to Excel MCP, you agree to the service agreement, and privacy policy.

Pricing

Free version, max 6 rows processed. Pro version, unlimited data processing.

Please refer to the pricing page for more details.