StockSpark

Provides vehicle dealership management via MCP with 36 tools for inventory, publishing, analytics, and leads.

javascript

0

GitHub Stars

javascript

Language

6 months ago

First Indexed

3 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": {
    "loukach-stockspark-mcp-poc": {
      "command": "node",
      "args": [
        "/absolute/path/to/stockspark-mcp-poc/src/index.js"
      ],
      "env": {
        "STOCKSPARK_PASSWORD": "your-password",
        "STOCKSPARK_USERNAME": "your-email@dealership.com"
      }
    }
  }
}

StockSpark MCP Server is a production-ready backend that gives AI agents access to 36 specialized tools for end-to-end vehicle dealership management via the StockSpark/Carspark API platform. It enables you to automate inventory, publishing, analytics, lead tracking, and more, all through a cohesive MCP interface.

How to use

You use StockSpark MCP Server by running the local MCP process and connecting your MCP client (such as Claude Desktop) to the running server. Start the server locally, then configure your client to point at the local process so your AI agent can perform actions like managing vehicles, publishing to portals, analyzing inventory, and handling leads.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

Clone the project, install dependencies, and prepare to run the server.

Configuration and usage

Configure your MCP client to start the StockSpark MCP Server as a local process. Use the command and environment shown in the example configuration snippet.

Testing the server

Run the test suite to verify connectivity and basic functionality.

Security and credentials

Your StockSpark credentials are required to access the API. Keep them secure and supply them through environment variables in the run configuration.

Common workflows

Create a vehicle by fetching a data template, then add the vehicle with pricing information.

Advanced usage

Leverage the 36 tools to manage organization, reference data, vehicles, images, analytics, publishing, lead analysis, and performance. Use the provided workflows to search, price, publish, and analyze inventory.

Environment variables

The server requires STOCKSPARK_USERNAME and STOCKSPARK_PASSWORD. You can override the market with STOCKSPARK_COUNTRY and adjust logging with LOG_LEVEL.

API endpoints and defaults

Core API endpoints and authentication are built-in. The system uses OAuth2 authentication with auto-refresh and has hardcoded API defaults for stable operation.

Available tools

get_user_context

View current company/dealer selection within the MCP server environment

list_user_companies

List accessible companies for multi-tenant usage

select_company

Choose the working company context for subsequent actions

list_company_dealers

List dealers under the selected company context

select_dealer

Choose the working dealer context for subsequent actions

search_vehicle_versions

Progressive search for vehicle specifications across makes, models, and trims

compare_vehicle_versions

Compare similar vehicle versions to aid selection

get_vehicle_version_template

Retrieve a complete template for a vehicle version to seed new entries

get_vehicle_makes

List available manufacturers for selection and filtering

get_vehicle_models

Fetch models for a selected make

get_vehicle_trims

Obtain trim levels with full specifications

get_vehicle_transmissions

List available transmission types and configurations

get_vehicle_bodies

List body style options such as sedan, SUV, hatchback, etc.

get_vehicle_fuels

List available fuel type options (gasoline, diesel, hybrid, electric, etc.)

get_vehicle_colors

List available color options for vehicles

add_vehicle

Create a new vehicle entry using a template or manual data input

get_vehicle

Retrieve detailed information for a specific vehicle by ID

list_vehicles

Search and filter inventory with sorting and pagination

update_vehicle

Modify vehicle data such as pricing, attributes, or availability

update_vehicle_price

Quickly adjust pricing for a vehicle or group of vehicles

delete_vehicle

Remove a vehicle entry with proper confirmation and safeguards

upload_vehicle_images

Bulk upload images from files or URLs to a vehicle record

get_vehicle_images

List images associated with a vehicle

set_vehicle_main_image

Set the primary display image for a vehicle

delete_vehicle_image

Remove a specific image from a vehicle

get_underperforming_vehicles

Identify slow-moving inventory based on predefined metrics

analyze_inventory_health

Provide overall stock health metrics and insights

apply_bulk_discount

Apply pricing discounts at scale across multiple vehicles

get_pricing_recommendations

AI-powered pricing suggestions based on market conditions

publish_vehicle

Publish a vehicle to configured portals such as MyPortal or Automobile.it

unpublish_vehicle

Remove a vehicle from configured portals

get_publication_status

Check publishing status across portals for a vehicle

list_available_portals

Show configured publishing channels available for use

get_vehicle_leads

Track customer inquiries related to vehicles

analyze_lead_trends

Provide insights on lead performance over time

get_mcp_performance

Show system performance metrics for MCP server