@mixmediahk/motors-quote-mcp

MCP server for motor insurance quoting workflows. Provides 13 tools covering the full quote lifecycle from vehicle lookup to premium retrieval and PDF download.

Requirements

• Node.js >= 22

Quick Install

npm install -g @mixmediahk/motors-quote-mcp

Or use npx directly in MCP config (no global install needed).

AI Agent Configuration

OpenCode

1. Add MCP server to opencode.json (project root or ~/.config/opencode/):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "motors-quote": {
      "type": "local",
      "command": ["npx", "-y", "@mixmediahk/motors-quote-mcp"],
      "enabled": true,
      "environment": {
        "BASE_URL": "<your_api_base_url>",
        "TIMEOUT": "30000"
      }
    }
  }
}

2. Install the Skill:

# Project-local
mkdir -p .opencode/skills/motors-quote
cp node_modules/@mixmediahk/motors-quote-mcp/skills/SKILL.md .opencode/skills/motors-quote/

# Or globally
mkdir -p ~/.config/opencode/skills/motors-quote
cp node_modules/@mixmediahk/motors-quote-mcp/skills/SKILL.md ~/.config/opencode/skills/motors-quote/

Claude Code

1. Add MCP server to .mcp.json (project root):

{
  "mcpServers": {
    "motors-quote": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@mixmediahk/motors-quote-mcp"],
      "env": {
        "BASE_URL": "<your_api_base_url>",
        "TIMEOUT": "30000"
      }
    }
  }
}

2. Install the Skill:

# Project-local (Claude-compatible path)
mkdir -p .claude/skills/motors-quote
cp node_modules/@mixmediahk/motors-quote-mcp/skills/SKILL.md .claude/skills/motors-quote/

# Or globally
mkdir -p ~/.claude/skills/motors-quote
cp node_modules/@mixmediahk/motors-quote-mcp/skills/SKILL.md ~/.claude/skills/motors-quote/

Codex

1. Add MCP server to .codex/mcp.json (project root):

{
  "mcpServers": {
    "motors-quote": {
      "type": "local",
      "command": "npx",
      "args": ["-y", "@mixmediahk/motors-quote-mcp"],
      "env": {
        "BASE_URL": "<your_api_base_url>",
        "TIMEOUT": "30000"
      }
    }
  }
}

2. Install the Skill:

# Project-local (agent-compatible path)
mkdir -p .agents/skills/motors-quote
cp node_modules/@mixmediahk/motors-quote-mcp/skills/SKILL.md .agents/skills/motors-quote/

# Or globally
mkdir -p ~/.agents/skills/motors-quote
cp node_modules/@mixmediahk/motors-quote-mcp/skills/SKILL.md ~/.agents/skills/motors-quote/

Environment Variables

| Variable | Default | Description | |----------|---------|-------------| | BASE_URL | <your_api_base_url> | API base URL | | TIMEOUT | 30000 | HTTP timeout (ms) | | LOG_LEVEL | WARN | DEBUG / INFO / WARN / ERROR | | LOG_PATH | (none) | Log file path (optional, DEBUG mode logs full API request/response) | | DEFAULT_CLASS_ID | (env-specific) | Vehicle class ID (locked at runtime, caller cannot override) | | DEFAULT_COMPANY_ID | (env-specific) | Insurance company ID (locked at runtime, caller cannot override) | | URL_BUILDER_BASE_URL | <your_url_builder_api_url> | URL shortener API base URL | | URL_BUILDER_REFRESH_TOKEN | (none) | URL shortener refresh token. When set, save_quote auto-shortens down_view and sms_view links |

Available Tools

| Tool | Description | Required Params | |------|-------------|-----------------| | get_active_brands | List active car brands | None | | get_car_models | List models under a brand | brand_id | | get_model_years | List manufacturing years | brand_id | | get_models_by_year | Filter models by brand + year | brand_id, year | | get_model_cc | Get engine capacity | model_id, year, brand, model | | get_model_description | Get model details (redBook) | model_id, year, cc, brand, model | | get_car_type_body | Get vehicle body types | brand_id | | get_car_questions | Get special questions for quoting | None | | get_occupations | List driver occupations | None | | get_industries | List company industries | None | | get_ncd_options | List valid NCD rates | None | | get_quote | Get insurance quote (auto-chains internal APIs) | brand_id, model_id, year, cc, isrd_vl, ncd_rate | | save_quote | Save quote and get PDF download link | brand_id, model_id, year, cc, isrd_vl, ncd_rate, quote_type |

Skill

This package includes a skills/SKILL.md that provides the AI agent with a complete workflow guide for the quote process. The skill covers:

• Dynamic question construction from get_car_questions() API
• User interaction via question tool for selection-based UX
• Full quote information review before submission
• Error handling and edge cases

Install it to the appropriate skills directory for your AI agent client (see configuration above).

Development

yarn install
yarn bundle          # Build + add shebang + sync skill
node dist/index.cjs  # Start MCP server (stdio)

License

Private