Custom MCP Server

Version: 20250825

Online Version

1. Custom MCP Services
2. Create custom MCP server
3. Configure custom MCP server
4. Access MCP server via SDK
5. Run and debug MCP Server
1. 5.1. Run and debug
2. 5.2. Add server to agent

1. Custom MCP Services

This topic describes how to create and configure a custom MCP server and debug it in an agent.

2. Create custom MCP server

Log in to the Tuya Developer Platform.
Go to MCP Management > Custom MCP Service, and click Add custom MCP.
In the Sign up MCP Server dialog, enter the service name and description in Chinese and English, upload an image as the icon, and then click Confirm to save.

Screenshot of the Tuya Developer Platform interface showing the navigation menu with 'MCP Management' and 'Custom MCP Service' highlighted. A button labeled '+ Add custom MCP' is prominently displayed.

Screenshot of the 'Sign up MCP Server' dialog box. It includes input fields for 'Service Name (Chinese)', 'Service Description (Chinese)', 'Service Name (English)', and 'Service Description (English)'. An 'Icon' upload field is also present, showing a placeholder 'M' icon and specifying allowed formats (JPG, JPEG, PNG) and size limit (3 MB or less).

3. Configure custom MCP server

If your custom MCP service is deployed across multiple data centers, ensure consistent service versions and tool configurations in all data centers to prevent compatibility issues that may disrupt agent orchestration or cause functional failures.

After creating the MCP server, you will automatically be redirected to its Service Details page.
In the section of Service Access Configuration Management > Data Center, click Add Data Center on the right, select a data center as needed, and then click OK.
Click the selected data center, and you can see the Endpoint, Access ID, and Access Secret. Copy and paste the information to your local device. Please note that these parameters will be used when running the MCP SDK later. For more information, see the README in the GitHub source code.

Screenshot of the Service Details page for a custom MCP server. The 'Service Access Configuration Management' section is visible, showing the 'Data Center' area with a message 'No data center configured yet' and an 'Add Data Center' button. A second screenshot shows a configured 'China Data Center' with its 'Endpoint' (e.g., https://mcp.tuyacn.com), 'Access ID', and 'Access Secret'.

4. Access MCP server via SDK

Download the MCP SDK from GitHub and read the relevant documents.

Screenshot of the GitHub repository page for 'tuya / tuya-mcp-sdk'. It displays the project's file structure, including directories like 'docs' and language-specific SDK folders, commit history, and a brief description of the SDK's purpose in enabling integration with Tuya Cloud via the Model Context Protocol (MCP).

5. Run and debug MCP Server

To ensure your custom MCP server operates properly, follow these steps to run and debug it within the agent environment:

5.1. Run and debug

In the selected data center, check the service status of the MCP server.
On the Tool tab, view the available tools for your MCP server.
Click Test Run to test your desired tool.
In the Test Run window, click Run. When Commissioning passed appear in the lower left corner, the MCP tool has been debugged successfully.

Screenshot of the MCP server's service details, showing 'China Data Center' with 'Service Status: online'. Another screenshot displays the 'Tool' tab, listing available tools such as 'play_music', 'stop_music', 'take_photo', and 'view_photo'. A third screenshot shows the 'Test Run' interface for the 'play_music' tool, with an input parameter 'music_name' and a 'Request Response JSON' indicating a successful test.

5.2. Add server to agent

Go to the My Agent page, click Develop in the Operation column.
In the section 01 Model Configuration > Skills Configuration, find MCP Service and click + on the right.
On the Add MCP service page, click Custom MCP Service and add the desired MCP server to your agent.

Screenshot of the 'My Agent' page, highlighting the '01 Model Configuration > Skills Configuration' section where 'MCP Service' can be added via a '+' button. A second screenshot illustrates the 'Add MCP service' page, where a custom MCP server can be selected and added.

So far, you have completed the development and debugging process of a custom MCP server.

	Tuya Custom MCP Server Development Guide - Version 20250820 A developer's guide to creating, configuring, and debugging custom MCP Servers on the Tuya IoT Platform, including SDK integration and agent deployment.
	Tuya Custom Development Quick Start Guide A comprehensive guide for developers to get started with custom development on the Tuya IoT platform, covering project setup, device integration, API usage, and message service configuration.
	Tuya 自定义 MCP 服务器开发指南本指南详细介绍如何在 Tuya 平台上创建、配置、调试和集成自定义 MCP 服务器，包括使用 SDK 和智能体。
	Tuya Developer Platform Updates - Comprehensive Guide Stay informed about the latest updates and enhancements to the Tuya Developer Platform. This document details version changes, new features, and improvements across various product categories and development frameworks.
	Tuya Smart Agent Open API - Integration and Usage Guide Comprehensive guide to Tuya's Smart Agent Open API, detailing integration capabilities, usage methods on the Tuya Developer Platform, and cost information. Access smart agent data via OpenAPI.
	Tuya GDPR Compliance Validation Findings Summary by TRUSTe TRUSTe LLC's summary of GDPR privacy practices validation findings for Tuya's IoT products and services, confirming compliance measures as of April 22, 2025.
	Tuya AI Development Demo Guide: Build Smart Products Learn Tuya's AI development core functions and processes with this demo guide. Quickly start building your own smart products with Tuya's platform.
	Tuya Smart: Global AI Cloud Platform Service Provider - Q2 2025 Overview This document provides an overview of Tuya Smart's performance and strategy as the global leading AI cloud platform service provider. It covers financial results for the second quarter of 2025, business models, market position, technological advancements, and commitment to ESG sustainability.