Turbo.az

Provides MCP access to Turbo.az car listings by querying listings and search results from Azerbaijan-friendly access paths.

python

0

GitHub Stars

python

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "javidglyv-turboaz-mcp": {
      "command": "python",
      "args": [
        "-m",
        "src.server"
      ]
    }
  }
}

This MCP server enables you to access Turbo.az automotive listings from Claude Desktop. It provides targeted search and detailed listing information by querying Turbo.az through an automated, reliable channel, so you can quickly find cars that match your criteria from an Azerbaijani IP environment where access is allowed.

How to use

You will run the MCP server locally and connect your MCP client (such as Claude Desktop) to it to perform searches and retrieve listing details from Turbo.az. Use the following patterns to accomplish common tasks:

How to install

Prerequisites you need before installing the server:

Python 3.10+ or newer
Google Chrome browser
pip

Installation steps you should follow to set up the MCP server locally:

# Clone the repo or copy files
cd turbo-az-mcp

# Create virtual environment
python -m venv venv

# Activate
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

# Install packages
pip install -e .

To test the server manually after installation, run the server with this command:

python -m src.server

To test the MCP endpoints without involving an LLM, start the server and run the MCP tests that exercise the available tools. Use this command:

uv run python scripts/test_mcp.py

Available tools

search_cars

Search for cars on Turbo.az by make, model, price range, year range, fuel type, transmission, and limit.

get_car_details

Retrieve detailed information for a specific listing by listing_id or full URL.

get_makes_models

Get the list of makes and models available on Turbo.az; filter by make to see its models.

get_trending

Fetch new, popular, or vip listings with an optional limit.