Вход

Декодирование VIN, канадские объявления, рыночные котировки, отзывы TC+NHTSA. Полный API доступен по ссылке в описании.

нужен ключ Удалённый · Streamable HTTP Без авторизации Разработка Веб и поиск Официальный реестр · 11 просмотров

Что умеет

Декодирование VIN, канадские объявления, рыночные котировки, отзывы TC+NHTSA. Полный API доступен по ссылке в описании.

Перевод каталога (LLM) · показать оригинал автора

VIN decode, Canadian listings, market quotes, TC+NHTSA recalls. Full API: https://cardog.app/docs.md

Подключение

Удалённый сервер: клиент обращается по адресу, код на вашей машине не запускается.

Claude Desktop

claude_desktop_config.json

Cursor

~/.cursor/mcp.json

Windsurf

~/.codeium/windsurf/mcp_config.json

Вставьте блок mcpServers в файл конфигурации своего клиента. Ключи не входят в файл: вместо SET_LOCALLY подставьте свои значения.

{
    "mcpServers": {
        "app-cardog-mcp": {
            "url": "https://mcp.cardog.io/mcp?api_key={api_key}"
        }
    }
}

Вызов без установки — через шлюз

Агент вызывает инструменты этого сервера через https://www.n2j.ru/mcphub/mcp: hub_call_tool {"server":"app-cardog-mcp","tool":"…","arguments":{…}} Ключ не нужен, но сервер N2J ограничивает частоту анонимных вызовов.

https://mcp.cardog.io/mcp?api_key={api_key}

Инструменты

6 схем · ≈ 3 123 условных токенов

resolve_entity

Turn free text into canonical Cardog entity refs — THE text entry point for every other tool. A ref is `{domain}:{key}`, lowercase, with `/` separating composite key segments: "make:tesla", "model:mini/hardtop", "model-year:honda/cr-v/2026", "fuel-type:electric". (Exception: nano/squish keys are uppercase VIN charset — machine-derived, never typed from text.) Every other tool takes refs, never names. Call this FIRST whenever you hold text — "Civic", "2024 Model Y", a misspelling like "teslla" — then reuse the refs for the rest of the session. Returns candidates with confidence, best-first. `

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "query",
        "context"
    ],
    "properties": {
        "limit": {
            "type": "integer",
            "maximum": 10,
            "minimum": 1,
            "description": "Max candidates (default 5)"
        },
        "query": {
            "type": "string",
            "minLength": 1,
            "description": "Free text to resolve, e.g. \"2021 Civic\", \"teslla\", \"plug-in hybrid\""
        },
        "domain": {
            "type": "string",
            "description": "Constrain candidates to one domain: \"make\", \"model\", \"model-year\", \"body-style\", \"fuel-type\", \"drive-type\", \"transmission\", \"electrification-level\", \"vehicle-type\". Omit to search across domains."
        },
        "context": {
            "type": "string",
            "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
        }
    }
}

identify_vehicle

Decode a 17-character VIN into its full Cardog identity: canonical entity refs, the market grains (nano/squish), spec highlights, and links to adjacent resources. VIN ONLY — this tool never fuzzy-matches. If you hold free text ("2021 Civic", a make or model name), do NOT call this: call resolve_entity — free text enters the platform in exactly one tool. A non-VIN input returns a redirect hint, not a decode. A ref is `{domain}:{key}`, lowercase, with `/` separating composite key segments: "make:tesla", "model:mini/hardtop", "model-year:honda/cr-v/2026", "fuel-type:electric". (Exception: nano/

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "vin",
        "context"
    ],
    "properties": {
        "vin": {
            "type": "string",
            "minLength": 1,
            "description": "The 17-character VIN. Free text is NOT accepted here — use resolve_entity for text."
        },
        "context": {
            "type": "string",
            "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
        }
    }
}

search_inventory

Search live vehicle listings — ref-native. One call returns listings + facets + the total count. The market defaults to Canada, which is the only inventory market today: prices are in each listing's own currency (CAD for Canadian listings) and odometers in km. Filters take entity REFS from resolve_entity / identify_vehicle, never free-text names: makes: ["make:mini"], models: ["model:mini/hardtop"], fuelTypes: ["fuel-type:electric"] — plus year/price/odometer ranges and canonical spec filters, e.g. spec: {"fuelEconomyCombined": {"min": 35}, "heatedSeatsFront": ["standard"]} (numeric attrs tak

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "context"
    ],
    "properties": {
        "page": {
            "type": "integer",
            "minimum": 1,
            "description": "Page number (default 1)"
        },
        "sort": {
            "type": "object",
            "properties": {
                "field": {
                    "enum": [
                        "price",
                        "year",
                        "odometer",
                        "createdAt",
                        "score"
                    ],
                    "type": "string"
                },
                "direction": {
                    "enum": [
                        "asc",
                        "desc"
                    ],
                    "type": "string"
                }
            },
            "additionalProperties": false
        },
        "spec": {
            "type": "object",
            "description": "Canonical spec filters keyed by SpecAttributeId: numeric → {\"min\",\"max\"}, equipment → [\"standard\"|\"optional\"|\"unavailable\"]. Example: {\"fuelEconomyCombined\": {\"min\": 35}, \"heatedSeatsFront\": [\"standard\"]}. Bare scalars are invalid — \"standard\" must be [\"standard\"]; a wrong-shaped value errors with code \"invalid_spec_filter\". Unknown keys 400 with code \"unknown_spec_attributes\".",
            "additionalProperties": []
        },
        "year": {
            "type": "object",
            "properties": {
                "max": {
                    "type": "number"
                },
                "min": {
                    "type": "number"
                }
            },
            "description": "Model year range",
            "additionalProperties": false
        },
        "limit": {
            "type": "integer",
            "maximum": 50,
            "minimum": 1,
            "description": "Rows per page (default 10, max 50)"
        },
        "makes": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Entity refs in the \"make\" domain, e.g. [\"make:mini\"]"
        },
        "nanos": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Entity refs in the \"nano\" domain, e.g. [\"nano:5TDGSKFCRS\"]"
        },
        "price": {
            "type": "object",
            "properties": {
                "max": {
                    "type": "number"
                },
                "min": {
                    "type": "number"
                }
            },
            "description": "Price, in the listing currency (CAD in the default Canadian market) range",
            "additionalProperties": false
        },
        "models": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Entity refs in the \"model\" domain, e.g. [\"model:mini/hardtop\"]"
        },
        "context": {
            "type": "string",
            "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
        },
        "odometer": {
            "type": "object",
            "properties": {
                "max": {
                    "type": "number"
                },
                "min": {
                    "type": "number"
                }
            },
            "description": "Odometer, in km range",
            "additionalProperties": false
        },
        "fuelTypes": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Entity refs in the \"fuel-type\" domain, e.g. [\"fuel-type:electric\"]"
        },
        "bodyStyles": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Entity refs in the \"body-style\" domain, e.g. [\"body-style:sport-utility-vehicle-suv\"]"
        },
        "driveTypes": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Entity refs in the \"drive-type\" domain, e.g. [\"drive-type:awd-all-wheel-drive\"]"
        },
        "vehicleTypes": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Entity refs in the \"vehicle-type\" domain, e.g. [\"vehicle-type:passenger-car\"]"
        },
        "transmissions": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Entity refs in the \"transmission\" domain, e.g. [\"transmission:automatic\"]"
        },
        "electrificationLevels": {
            "type": "array",
            "items": {
                "type": "string"
            },
            "description": "Entity refs in the \"electrification-level\" domain, e.g. [\"electrification-level:bev-battery-electric-vehicle\"]"
        }
    }
}

market_quote

The live market card for one instrument: quote (live listing count, best/p25/median/p75 price, average days-on-market, 30-day price cuts), a daily-bar history summary, and a bounded sample of the live listings behind the numbers. `ref` must be an INSTRUMENT ref — one of two grains: - "model-year:{make}/{model}/{year}" (e.g. "model-year:honda/cr-v/2026") — lowercase, /-separated; get it from resolve_entity (domain "model-year") or identify_vehicle's refs.modelYear. - "squish:{9 uppercase VIN chars}" (e.g. "squish:5TDGSKFCS") — the exact-config grain; get it from identify_vehicle. (squish/nano

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "ref",
        "context"
    ],
    "properties": {
        "ref": {
            "type": "string",
            "minLength": 1,
            "description": "Instrument ref: \"model-year:honda/cr-v/2026\" or \"squish:5TDGSKFCS\". Free text never quotes — resolve_entity first."
        },
        "window": {
            "enum": [
                "1w",
                "1m",
                "3m",
                "6m",
                "ytd",
                "1y",
                "3y",
                "5y",
                "10y",
                "all"
            ],
            "type": "string",
            "description": "History window (server default when omitted)"
        },
        "context": {
            "type": "string",
            "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
        }
    }
}

check_recalls

Recall campaigns LISTED for a vehicle's model year — Transport Canada and NHTSA records, ref-keyed. This is a possible-recall list, not a VIN-level determination: campaigns match by model year, not by the campaign's VIN range, and Cardog does not see remedy status. Every result carries `applicability: "listed_for_model_year"`. When you tell a user about these, say they MAY apply and that the manufacturer's own VIN recall lookup (in Canada) or a dealer confirms; never say "open", "outstanding" or "critical", and never say "no recalls" as a clearance. For a vehicle sold in Canada, lead with `aut

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "context"
    ],
    "properties": {
        "ref": {
            "type": "string",
            "description": "Entity ref scope: \"make:honda\", \"model:honda/cr-v\", or \"model-year:honda/cr-v/2026\". Exclusive with `vin`."
        },
        "vin": {
            "type": "string",
            "description": "17-character VIN — resolved to its model year; campaigns listed for that model year are returned. Exclusive with `ref`."
        },
        "limit": {
            "type": "integer",
            "maximum": 100,
            "minimum": 1,
            "description": "Max campaigns for a ref-scoped query (default 25, max 100)"
        },
        "context": {
            "type": "string",
            "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
        }
    }
}

window_sticker

The factory window sticker (Monroney label) we hold for a VIN, or why there is none. Guide: https://cardog.app/docs/window-sticker. Pass `vin` (17 characters). The result has exactly one of: - `label` — we hold the manufacturer's label: `issuer`, `retrievedAt`, `vinVerified` (true only when the VIN was read inside the file; false means the manufacturer's service returned it for this VIN and nothing stronger), and `document` (a stable identifier + SHA-256, and `downloadUrl`: a signed link to the PDF, good for 24 hours, free, no API key needed. You may give it to a person as a clickable link. D

Показать схему аргументов
{
    "type": "object",
    "$schema": "http://json-schema.org/draft-07/schema#",
    "required": [
        "vin",
        "context"
    ],
    "properties": {
        "vin": {
            "type": "string",
            "description": "17-character VIN"
        },
        "context": {
            "type": "string",
            "description": "Explain why you are calling this tool and how it fits into the user's overall goal. This parameter is used for analytics and user intent tracking. YOU MUST provide 15-25 words (count carefully). NEVER use first person ('I', 'we', 'you') - maintain third-person perspective. NEVER include sensitive information such as credentials, passwords, or personal data. Example (20 words): \"Searching across the organization's repositories to find all open issues related to performance complaints and latency issues for team prioritization.\""
        }
    }
}