Ximilar - MCP Server

Overview

This page describes how to use the Ximilar MCP Server to access the functionality of the Ximilar Computer Vision Platform within your favorite LLM client.

The MCP (Multi-Channel Protocol) Server is a Python-based server that allows you to interact with the Ximilar API using a simple and consistent interface. It provides endpoints for Card Identification, Grading, Fashion Tagging, and more. All endpoints available in MCP server are listed below.

Installation

To use MCP Server, you need to:

1. Download or clone the Ximilar Client files from GitHub (no need to install it) or directly from the MCP Server.

git clone https://github.com/ximilar/ximilar-client.git

2. Install python 3.10 or higher. See instructions at realpython.com.

3. Install fastmcp Python package by running the following command in your terminal via pip:

pip install fastmcp

4. Install the uv package manager from here.
5. Install the MCP Server by running this command in your terminal:

fastmcp install MCP_CLIENT_NAME PATH_TO_XIMILAR_CLIENT/ximilar/server/server.py --with fastmcp --with requests --env XIMILAR_API_KEY=API_KEY

• Replace API_KEY with your personal Ximilar API key. You can find it in Ximilar App.
• Replace MCP_CLIENT_NAME with the name of the MCP Client you want to use (e.g., clade-desktop, claude-code).
• Replace PATH_TO_XIMILAR_CLIENT with the path to the Ximilar Client files you downloaded in step 1. Do NOT delete the downloaded files afterwards.
• Note: this approach might not work with all MCP Clients, for more information, please refer to the FastMCP documentation (mainly the Integrations section).

6. Start your MCP Client.

Python MCP Clients

Some examples in MCP clients, implemented in Python are available here:

https://gitlab.com/ximilar-public/ximilar-client/-/tree/master/ximilar/server/tests

Claude Desktop

You can also use the following configuration for Claude Desktop:

{
  "mcpServers": {
    "ximilar-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--with","fastmcp",
        "--with","requests",
        "fastmcp", "run", "PATH_TO_XIMILAR_CLIENT/ximilar/server/server.py"
      ],
      "env": {
        "XIMILAR_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Available Endpoints

The following endpoints are currently available for the MCP Server: