encarapi-mcp 1.6.3 → 1.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +3 -2
- package/package.json +2 -2
- package/src/server.js +22 -2
package/README.md
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
[Model Context Protocol](https://modelcontextprotocol.io) server for
|
|
4
4
|
[EnCarAPI](https://encarapi.com/?utm_source=readme&utm_medium=encarapi-mcp). Lets Claude, Cursor, ChatGPT and other MCP clients search
|
|
5
5
|
**live used car listings from South Korea** (Encar, KB Chachacha, K Car) and **China**
|
|
6
|
-
(Dongchedi, Che168), and pull full details, inspection reports and accident records.
|
|
6
|
+
(Dongchedi, Che168), and pull full details, inspection reports, Encar diagnoses and accident records.
|
|
7
7
|
|
|
8
8
|
> **An API key is required.** Get one (5-day trial) at [encarapi.com](https://encarapi.com/?utm_source=readme&utm_medium=encarapi-mcp).
|
|
9
9
|
> Chinese data works with a [ChinaCarAPI](https://chinacarapi.com/?utm_source=readme&utm_medium=encarapi-mcp) key or an EnCarAPI key
|
|
@@ -18,8 +18,9 @@
|
|
|
18
18
|
| `search_korean_trucks` | Search Korean trucks, buses and special vehicles (body type, payload in tons, use, region; Business/Scale key) |
|
|
19
19
|
| `find_korean_car_by_vin` | All Encar / K Car listings of one VIN, incl. removed ones (Business/Scale key) |
|
|
20
20
|
| `get_korean_truck` | Full record for one truck: detail, inspection report, cargo box, VIN and plate (Business/Scale key) |
|
|
21
|
-
| `get_korean_car` | Full detail for one listing (specs, options, photos, price history, seller; `lang`: en, ru or de) |
|
|
21
|
+
| `get_korean_car` | Full detail for one listing (specs, options, photos, price history, seller, `diagnosisReport` on Encar listings; `lang`: en, ru or de) |
|
|
22
22
|
| `get_korean_inspection` | Official Korean inspection report |
|
|
23
|
+
| `get_korean_diagnosis` | Encar diagnosis (엔카진단): which outer panels were replaced, inspector verdict incl. frame result (Encar listings only) |
|
|
23
24
|
| `get_korean_accident_record` | Insurance accident history and ownership changes |
|
|
24
25
|
| `find_korean_models` | Model name autocomplete across brands |
|
|
25
26
|
| `korean_filter_values` | Valid filter values |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "encarapi-mcp",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.7.0",
|
|
4
4
|
"description": "MCP server for EnCarAPI and ChinaCarAPI: live Korean (Encar, KB Chachacha, K Car) and Chinese (Dongchedi, Che168) used car listings for Claude, Cursor and other AI assistants.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "src/server.js",
|
|
@@ -49,7 +49,7 @@
|
|
|
49
49
|
},
|
|
50
50
|
"dependencies": {
|
|
51
51
|
"@modelcontextprotocol/sdk": "^1.32.0",
|
|
52
|
-
"encarapi": "^1.
|
|
52
|
+
"encarapi": "^1.8.0",
|
|
53
53
|
"express": "^5.2.1",
|
|
54
54
|
"zod": "^4.1.0"
|
|
55
55
|
}
|
package/src/server.js
CHANGED
|
@@ -4,7 +4,7 @@ import encarapi from "encarapi";
|
|
|
4
4
|
|
|
5
5
|
const { KoreaClient, ChinaClient } = encarapi;
|
|
6
6
|
|
|
7
|
-
export const VERSION = "1.
|
|
7
|
+
export const VERSION = "1.7.0";
|
|
8
8
|
const MAX_TEXT = 40000;
|
|
9
9
|
|
|
10
10
|
const asText = (data) => {
|
|
@@ -308,7 +308,9 @@ export function createServer({ apiKey, chinaKey, fetchImpl, transport = "stdio",
|
|
|
308
308
|
"get_korean_car",
|
|
309
309
|
{
|
|
310
310
|
title: "Get a Korean car",
|
|
311
|
-
description:
|
|
311
|
+
description:
|
|
312
|
+
"Full details for one Korean listing: specs, options, photos, price history, seller. Id: Encar id, 'kbc:<id>' or 'kcar:<id>'. " +
|
|
313
|
+
"Encar listings also carry diagnosisReport: Encar's own outer-panel diagnosis (see get_korean_diagnosis), null when Encar has no diagnosis for the car.",
|
|
312
314
|
inputSchema: {
|
|
313
315
|
id: z.string().describe("Listing id from search_korean_cars"),
|
|
314
316
|
lang: z.enum(["en", "ru", "de"]).optional().describe("Language of the spec, category and option names: en (default), ru = Russian, de = German"),
|
|
@@ -329,6 +331,24 @@ export function createServer({ apiKey, chinaKey, fetchImpl, transport = "stdio",
|
|
|
329
331
|
run(({ id }) => needKorea().inspection(id))
|
|
330
332
|
);
|
|
331
333
|
|
|
334
|
+
server.registerTool(
|
|
335
|
+
"get_korean_diagnosis",
|
|
336
|
+
{
|
|
337
|
+
title: "Get an Encar diagnosis",
|
|
338
|
+
description:
|
|
339
|
+
"Encar's own body diagnosis (엔카진단) for one Encar listing, done at an Encar center: the 8 outer panels " +
|
|
340
|
+
"(doors, front fenders, hood, trunk lid; resultCode NORMAL or REPLACEMENT) plus the inspector's verdict " +
|
|
341
|
+
"CHECKER_COMMENT (also states the frame result; Encar does not diagnose cars with a damaged frame) and " +
|
|
342
|
+
"OUTER_PANEL_COMMENT, both Korean free text. About three in four active Encar listings have one; it is " +
|
|
343
|
+
"separate from the official inspection report. A 404 with diagnosisAvailable false means Encar has no " +
|
|
344
|
+
"diagnosis for the car, detailPending true means not collected yet. Encar ids only (no kbc:/kcar:). " +
|
|
345
|
+
"get_korean_car carries the same data as diagnosisReport.",
|
|
346
|
+
inputSchema: { id: z.string().describe("Encar listing id from search_korean_cars") },
|
|
347
|
+
annotations: readOnly,
|
|
348
|
+
},
|
|
349
|
+
run(({ id }) => needKorea().diagnosis(id))
|
|
350
|
+
);
|
|
351
|
+
|
|
332
352
|
server.registerTool(
|
|
333
353
|
"get_korean_accident_record",
|
|
334
354
|
{
|