YangoTech

You can install and run a Python-based MCP server that integrates with Yango Tech to access orders, products, stock levels, and other platform data. The server can be driven from your MCP clients or IDEs, and configurations are automatically generated to simplify setup and testing.

How to use

After you have installed and started the MCP server, you can connect your MCP clients to the local or remote endpoint to access Yango Tech data. Use the 6 built-in tools to retrieve enriched information such as order details with product names, order status, and stock lists with readable product names. These tools provide human-friendly results and can be invoked from Claude Desktop or Cursor IDE, or via your own MCP client that speaks the standard protocol.

Practical usage patterns include: querying a specific order to see the enriched items, checking stock levels across stores, listing all products with readable names, and paginating large product or stock lists. You can combine natural language queries with direct MCP calls to get fast, human-readable results without needing to craft low-level API requests.

How to install

# 1) Ensure you have Python 3.8+ installed
python3 --version

# 2) Run the universal installer to set up the MCP server and IDE configs
python3 install.py

# 3) If you need to reset everything and start over later
python3 cleanup.py
python3 install.py

# 4) Start the MCP server manually (if you want to run it directly)
python3 server.py

Configuration and usage notes

Generated configuration files are created in the project root to simplify manual setup and migration to other machines. The following files are produced automatically:

• claude_desktop_config.json — Claude Desktop configuration ready to import
• cursor_settings.json — Cursor IDE configuration ready to import

The server exposes two environments for API access: a test environment and a production environment. Use the respective endpoints when configuring clients or testing features.

Security and environment variables

To access the Yango Tech API securely, you will provide an API key. The installer supports setting this key in your environment for test and production usage. A common variable used is YANGO_TECH_API_KEY, which you can export in your shell before starting the server.

Generated MCP configurations

{
  "mcpServers": {
    "yangotech": {
      "type": "stdio",
      "name": "yangotech",
      "command": "python",
      "args": ["server.py"],
      "env": [{"name": "YANGO_TECH_API_KEY", "value": "YOUR_API_KEY"}]
    }
  }
}

Test and usage examples

After starting the MCP server, you can run test commands or query through your IDE integrations. Here are representative actions you can perform with enabled tools once the server and IDEs are configured.

Troubleshooting and next steps

If you encounter issues during installation or startup, perform a complete reset and reinstall to ensure all dependencies and configurations are correctly applied. Verify Python version, and confirm that environment variables such as YANGO_TECH_API_KEY are set when starting the server. If manual configuration is required, use the generated config files in the project root to connect your IDEs or MCP clients.

Notes

This MCP server integrates with Yango Tech to expose orders, products, stock levels, and catalog information through a set of dedicated tools. The approach emphasizes ease of use, allowing you to operate with natural language queries or standard MCP client calls while preserving readable product names and clear data relationships.

Technical overview (optional)

The server is built with a modern MCP framework and Python 3.8+ as the core language. It uses an HTTP client for external API calls, Pydantic for data validation, and a dotenv-based approach for environment management. The project ships with test and production API endpoints for Yango Tech, enabling secure, paginated access to data.

What you get after installation

You will have the automatic IDE integrations configured if Claude Desktop or Cursor IDE is installed, plus ready-to-use configuration files to enable manual setup on any machine. The installer also test-runs API calls to verify connectivity and data access.

Available tools

get_order_details

Retrieve detailed information for a specific order, including product names enriched for readability.

get_order_status

Fetch the current status of a given order.

get_all_products

List all products with user-friendly display names.

get_products_batch

Retrieve products in pages, including display names.

get_all_stocks

Get all stock levels with product name enrichment.

get_stocks_batch

Fetch stock data in pages with readable product names.