MarketCheck

https://docs.marketcheck.com/docs
Admin
MarketCheck provides comprehensive automotive data APIs and feeds offering vehicle specifications,...
Tokens:347,188
Snippets:2,632
Trust Score:8.3
Update:1 month ago
Show doc for...
Tokens:
Raw
### Pagination Request Examples

Source: https://docs.marketcheck.com/docs/api/cars/incentives/incentive-search-api

Examples of how to increment the 'start' parameter to navigate through pages of incentive search results.

```http
# First page (1-10)
GET https://api.marketcheck.com/v2/search/car/incentive/oem?start=0&rows=10&api_key=YOUR_API_KEY

# Second page (11-20)
GET https://api.marketcheck.com/v2/search/car/incentive/oem?start=10&rows=10&api_key=YOUR_API_KEY

# Third page (21-30)
GET https://api.marketcheck.com/v2/search/car/incentive/oem?start=20&rows=10&api_key=YOUR_API_KEY
```

--------------------------------

### Clone and Install Dependencies

Source: https://docs.marketcheck.com/docs/get-started/api/mcp/getting-started

Commands to clone the repository and install dependencies using either UV or pip.

```bash
git clone https://github.com/MarketcheckHub/marketcheck-api-mcp.git
cd marketcheck-api-mcp

# Using UV (recommended)
uv sync

# Or using pip
pip install -e .
```

--------------------------------

### Install UV Package Manager

Source: https://docs.marketcheck.com/docs/get-started/api/mcp/getting-started

Command to install the recommended UV package manager.

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

--------------------------------

### Wholesale Market Analysis Example

Source: https://docs.marketcheck.com/docs/api/cars/vehicle-listing/auction-listing

Example request for retrieving auction listing details to support wholesale market analysis and pricing research.

```bash
curl --request GET \
  --url https://api.marketcheck.com/v2/listing/car/auction/5TFRM5F10FX089674-18e6d270-7a2c
```

--------------------------------

### Install mcp-remote globally

Source: https://docs.marketcheck.com/docs/get-started/api/mcp/getting-started

Install the mcp-remote package globally using npm to enable config-file-based setup.

```text
npm install -g mcp-remote
```

--------------------------------

### Install dependencies

Source: https://docs.marketcheck.com/docs/get-started/api/mcp/troubleshooting

Commands to resolve ModuleNotFoundError or environment issues.

```bash
uv sync
```

```bash
pip install -e .
```

--------------------------------

### Installed Options Details

Source: https://docs.marketcheck.com/docs/guides/neovin/data-dictionary

A list of installed vehicle options, each containing pricing, type, and verification status.

```json
[
  {
    "code": "AHQ",
    "name": "Max Tow Package",
    "msrp": "495",
    "type": "P",
    "confidence": "High",
    "verified": null,
    "rule": "Unspecified",
    "sale_price": "495"
  },
  {
    "code": "DGJ",
    "name": "5-Speed Automatic Transmission",
    "msrp": "1400",
    "type": "O",
    "confidence": "High",
    "verified": null,
    "rule": "Unspecified",
    "sale_price": "1400"
  },
  {
    "code": "MX3",
    "name": "Black 3-Piece Hard Top",
    "msrp": "995",
    "type": "O",
    "confidence": "High",
    "verified": null,
    "rule": "Unspecified",
    "sale_price": "995"
  },
  {
    "code": "RC9",
    "name": "Alpine 9-Speaker w/All Weather Subwoofer",
    "msrp": "945",
    "type": "O",
    "confidence": "High",
    "verified": null,
    "rule": "Unspecified",
    "sale_price": "945"
  }
]
```

--------------------------------

### Basic Request to Dealers Search API with Axios

Source: https://docs.marketcheck.com/docs/api/cars/dealerships

An example of how to perform a GET request to the Dealers Search API using the Axios library in JavaScript.

```javascript
import axios from 'axios';  
  
const options = {  
  method: 'GET',  
  url: 'https://api.marketcheck.com/v2/dealers/car',  
  params: {api_key: 'YOUR_API_KEY', rows: '2'},  
  headers: {Accept: 'application/json'}  
};  
  
try {  
  const { data } = await axios.request(options);  
  console.log(data);  
} catch (error) {  
  console.error(error);  
}
```

--------------------------------

### City Distribution Response Example

Source: https://docs.marketcheck.com/docs/api/cars/dealership-syndication

Example JSON response showing city-based inventory counts.

```json
{
  "facets": {
    "city": [
      { "item": "Houston", "count": 1867 },
      { "item": "Raleigh", "count": 983 },
      { "item": "Austin", "count": 960 },
      { "item": "Norcross", "count": 956 },
      ...
    ]
  }
}
```

--------------------------------

### Installed Equipment Structure

Source: https://docs.marketcheck.com/docs/guides/neovin/data-dictionary

A detailed breakdown of installed equipment, mapping codes to specific attributes, categories, and values.

```json
{
  "AHQ": [
    {
      "category": "Exterior",
      "item": "Trailer towing preparation",
      "attribute": "trailer hitch",
      "location": "",
      "value": "yes"
    }
  ],
  "DGJ": [
    {
      "category": "Transmission",
      "item": "Transmission",
      "attribute": "number of speeds",
      "location": "",
      "value": "5"
    }
  ],
  "MX3": [
    {
      "category": "Exterior",
      "item": "Convertible roof",
      "attribute": "color",
      "location": "hard",
      "value": "Black"
    }
  ],
  "RC9": [
    {
      "category": "Infotainment",
      "item": "Speakers",
      "attribute": "brand name",
      "location": "",
      "value": "Alpine"
    }
  ],
  "STANDARD": [
    {
      "category": "General",
      "item": "Model year",
      "attribute": "Model year",
      "location": "",
      "value": "2017"
    }
  ]
}
```

--------------------------------

### Interior Color Object

Source: https://docs.marketcheck.com/docs/guides/neovin/data-dictionary

Example of the JSON structure for an interior color, including code, name, and confidence score.

```json
{
  "code": "A7X9",
  "name": "Black Cloth",
  "confidence": "1.0"
}
```

--------------------------------

### Exterior Color Object

Source: https://docs.marketcheck.com/docs/guides/neovin/data-dictionary

Example of the JSON structure for an exterior color, including code, name, MSRP, and confidence score.

```json
{
  "code": "PAU",
  "name": "Granite Crystal Metallic Clear Coat",
  "msrp": "0",
  "confidence": "1.0"
}
```

--------------------------------

### Get Job Status Request

Source: https://docs.marketcheck.com/docs/api/cars/market-insights/marketmatch

Use these examples to retrieve the status of a batch job via HTTP GET or cURL.

```http
GET https://api.marketcheck.com/v2/batch/marketmatch/rank/jobs/{job_id}
```

```bash
curl --request GET \
  --url https://api.marketcheck.com/v2/batch/marketmatch/rank/jobs/770a9622-a4bd-63f6-c938-668877662222
```

--------------------------------

### NeoVIN Decoder cURL Request

Source: https://docs.marketcheck.com/docs/api/cars/vehicle-specs/neovin

A basic example of a GET request to the NeoVIN Decoder API using a specific VIN.

```bash
curl --request GET \
  --url https://api.marketcheck.com/v2/decode/car/neovin/1FTEW1C59LKE56394/specs
```

--------------------------------

### Request Motorcycle Suggestions via cURL

Source: https://docs.marketcheck.com/docs/api/motorcycles/inventory/auto-complete

Example of a GET request to retrieve motorcycle make and model suggestions using cURL.

```bash
curl --request GET \
  --url https://api.marketcheck.com/v2/search/motorcycle/auto-complete
```

--------------------------------

### Additional Server Options

Source: https://docs.marketcheck.com/docs/get-started/api/mcp/getting-started

Commands for viewing help, enabling debug logging, and configuring host interfaces.

```bash
python server.py --help          # Show all available options
python server.py --debug         # Enable debug logging
python server.py --mode streamable-http --host 0.0.0.0  # Listen on all interfaces (HTTP mode)
```

--------------------------------

### Axios Request for Range Facets

Source: https://docs.marketcheck.com/docs/api/cars/dealership-syndication

Example of an Axios GET request to the inventory endpoint, including range_facets parameters for price and miles.

```javascript
import axios from 'axios';  
  
const options = {  
  method: 'GET',  
  url: 'https://api.marketcheck.com/v2/dealerships/inventory',  
  params: {  
    api_key: 'YOUR_API_KEY',  
    source: 'stgautogroup.com',  
    start: '0',  
    rows: '0',  
    range_facets: 'price|500|100000|10000,miles|5000|50000|5000'  
  },  
  headers: {Accept: 'application/json'}  
};  
  
try {  
  const { data } = await axios.request(options);  
  console.log(data);  
} catch (error) {  
  console.error(error);  
}
```

--------------------------------

### OEM Incentive Search cURL Request

Source: https://docs.marketcheck.com/docs/api/cars/incentives/incentive-search-api

An example of how to perform a GET request to the OEM Incentive Search API using cURL.

```bash
curl --request GET \
  --url https://api.marketcheck.com/v2/search/car/incentive/oem
```

--------------------------------

### Docker Deployment

Source: https://docs.marketcheck.com/docs/get-started/api/mcp/getting-started

Commands to build and run the server using Docker.

```bash
# Build the image
docker build -t marketcheck-api-mcp .

# Run with HTTP transport (default mode in the container)
docker run -p 8000:8000 \
  -e MARKETCHECK_API_KEY=your_api_key \
  marketcheck-api-mcp
```

--------------------------------

### Success Response Example

Source: https://docs.marketcheck.com/docs/api/cars/vehicle-specs/taxonomy-auto-complete

A sample 200 OK JSON response containing an array of matching taxonomy terms.

```json
{
  "terms": ["Ford", "Ford F-150", "Ford Explorer"]
}
```

--------------------------------

### Search car listings with Axios

Source: https://docs.marketcheck.com/docs/get-started/api

A JavaScript example using Axios to perform a GET request to the active car search endpoint. Replace 'YOUR_API_KEY' with your actual API key to authenticate.

```javascript
import axios from 'axios';  
  
const options = {  
  method: 'GET',  
  url: 'https://api.marketcheck.com/v2/search/car/active',  
  params: {api_key: 'YOUR_API_KEY', car_type: 'used', make: 'Toyota', model: 'Camry'},  
  headers: {Accept: 'application/json'}  
};  
  
try {  
  const { data } = await axios.request(options);  
  console.log(data);  
} catch (error) {  
  console.error(error);  
}
```

--------------------------------

### Run Server in STDIO Mode

Source: https://docs.marketcheck.com/docs/get-started/api/mcp/getting-started

Command to start the server in STDIO mode for desktop MCP clients.

```bash
python server.py
```

--------------------------------

### Financial Product Development with Axios

Source: https://docs.marketcheck.com/docs/api/cars/incentives

Example of using financial range parameters and sorting to analyze market rates and terms.

```javascript
import axios from 'axios';  
  
const options = {  
  method: 'GET',  
  url: 'https://api.marketcheck.com/v2/search/car/incentive/oem',  
  params: {  
    api_key: 'YOUR_API_KEY',  
    rows: '2',  
    monthly_range: '200-300',  
    term_range: '24-48',  
    sort_by: 'cashback_amount',  
    sort_order: 'desc'  
  },  
  headers: {Accept: 'application/json'}  
};  
  
try {  
  const { data } = await axios.request(options);  
  console.log(data);  
} catch (error) {  
  console.error(error);  
}
```

--------------------------------

### Retrieve Car Listing Details with Axios

Source: https://docs.marketcheck.com/docs/api/cars/vehicle-listing

Example demonstrating how to fetch specific car listing data using the Axios library in JavaScript.

```javascript
import axios from 'axios';  
  
const options = {  
  method: 'GET',  
  url: 'https://api.marketcheck.com/v2/listing/car/5TFUW5F16KX782196-44367fcc-c2fb',  
  params: {api_key: 'YOUR_API_KEY'},  
  headers: {Accept: 'application/json'}  
};  
  
try {  
  const { data } = await axios.request(options);  
  console.log(data);  
} catch (error) {  
  console.error(error);  
}
```

--------------------------------

### Claude Desktop Configuration with UV

Source: https://docs.marketcheck.com/docs/get-started/api/mcp/getting-started

JSON configuration for Claude Desktop when using UV for dependency management.

```json
{
  "mcpServers": {
    "marketcheck": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/marketcheck-api-mcp", "python", "server.py"],
      "env": {
        "MARKETCHECK_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

--------------------------------

### Retrieve RV Listing Details with Axios

Source: https://docs.marketcheck.com/docs/api/recreational-vehicles/vehicle-listing

Example demonstrating how to fetch specific RV listing data using the Axios library in JavaScript.

```javascript
import axios from 'axios';  
  
const options = {  
  method: 'GET',  
  url: 'https://api.marketcheck.com/v2/listing/rv/6616c05355bb62eed6446c59df548892-c26d9b49-f636',  
  params: {api_key: 'YOUR_API_KEY'},  
  headers: {Accept: 'application/json'}  
};  
  
try {  
  const { data } = await axios.request(options);  
  console.log(data);  
} catch (error) {  
  console.error(error);  
}
```

--------------------------------

### Stats Error Response Example

Source: https://docs.marketcheck.com/docs/api/cars/dealership-syndication/dealership-inventory

Example of the JSON response structure when a requested field is not supported for statistics calculations.

```json
{
  "stats": {
    "xyz": {
      "result": "Error",
      "message": "Field xyz is not allowed in stats"
    }
  }
}
```

--------------------------------

### Retrieve Listing Details with Axios

Source: https://docs.marketcheck.com/docs/api/heavy-equipments/vehicle-listing

Example using Axios in JavaScript to fetch details for a specific heavy equipment listing by providing the listing ID and API key.

```javascript
import axios from 'axios';  
  
const options = {  
  method: 'GET',  
  url: 'https://api.marketcheck.com/v2/listing/heavy-equipment/7b05e534430982c838e0c6e5f201da03-ca6f51ff-a092',  
  params: {api_key: 'YOUR_API_KEY'},  
  headers: {Accept: 'application/json'}  
};  
  
try {  
  const { data } = await axios.request(options);  
  console.log(data);  
} catch (error) {  
  console.error(error);  
}
```
Tokens:
Raw