home / mcp / turbify store mcp server

Turbify Store MCP Server

Turbify Store MCP

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "benpeke-turbify_store_mcp": {
      "command": "python",
      "args": [
        "path/to/turbify-store-mcp/src/turbify_store_mcp/server.py"
      ],
      "env": {
        "TURBIFY_STORE_ID": "your_store_id",
        "TURBIFY_CONTRACT_TOKEN": "your_contract_token"
      }
    }
  }
}

You run a dedicated MCP server that lets you manage Turbify Store catalogs, including creating, updating, deleting, and searching catalog items, while exposing built-in API documentation for easy integration with MCP clients.

How to use

You connect with an MCP client to perform catalog operations. Use the provided tools to create new catalog items, update existing ones, delete items, or search your catalog by keyword. You can also retrieve current store configuration and manage settings. When you run the server, you expose endpoints and MCP resources that your client can consume for seamless store catalog management.

How to install

Prerequisites: ensure you have Python 3.8 or newer and a compatible MCP tooling setup installed on your system.

Step 1: Install the MCP server dependencies.

pip install -e .

Step 2: Install development or runtime tooling (optional, but recommended for local development and testing). Use the package manager that fits your workflow.

uv init .
uv add fastmcp pydantic requests urllib3

Step 3: Configure authentication and store details via environment variables or a .env file.

export TURBIFY_STORE_ID="your_store_id"
export TURBIFY_CONTRACT_TOKEN="your_contract_token"

# or in a .env file
TURBIFY_STORE_ID=your_store_id
TURBIFY_CONTRACT_TOKEN=your_contract_token

Running the server and basic usage

Start the MCP server using your preferred method. You can run it directly from source for development or install a CLI entry to run it as a command.

python src/turbify_mcp/server.py

If you installed an executable CLI, you can start the server with the CLI command provided by the installation process.

turbify-mcp

Using MCP Inspector

To inspect the MCP server behavior and available resources, use the MCP Inspector tool to run and analyze the server process.

mcp-inspector "python run_server.py"

Store catalog operations overview

The server exposes dedicated tools to manage catalog items and store configuration. You can create, update, delete catalog items, or perform keyword-based searches to locate items. You can also fetch the current store configuration to review settings.

Common operations include creating a catalog item with a unique item identifier, updating its properties such as name or price, deleting items by id, and performing search queries with a keyword and optional range indices.

API response expectations

All successful operations return a standardized response with a status of success and a descriptive message. Errors return a status of error with an error code and message to help you diagnose and fix issues quickly.

Available tools

create_catalog_item

Create a new catalog item with fields such as item_id, name, table_id, price, sale_price, orderable, and taxable to add products to your Turbify Store catalog.

update_catalog_item

Update properties of an existing catalog item, such as name or price, by item_id.

delete_catalog_item

Remove a catalog item from the catalog using its item_id.

search_catalog_items

Search catalog items by keyword with optional start and end indices to control pagination.

get_store_config

Retrieve the current store configuration settings for the Turbify Store MCP server.