encarapi-mcp
This server lets AI assistants perform read-only searches and lookups of live Korean and Chinese used-car listings and related reports.
Search Korean used cars across Encar, KB Chachacha, K Car, or all sources using filters like brand, model, year, price in 10,000 KRW, mileage, fuel, transmission, category, region, inspection availability, and accident-free frame/damage status.
Retrieve full details for a Korean listing, including specs, options, photos, price history, seller, inspection report, and accident/ownership history.
Autocomplete Korean model names and get valid Korean filter values.
Search Chinese used cars on Dongchedi and Che168 by make, model, year, registration year, price in CNY, mileage, fuel, city, source, inspection report availability, and export readiness.
Retrieve full Chinese listing details and inspection reports covering accident, flood, fire, and EV battery checks.
Look up valid Chinese makes, fuels, cities, sources, sorts, and models with listing counts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@encarapi-mcp Find accident-free 2022+ Genesis GV80 under 50 million KRW"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
EnCarAPI MCP server: Korean and Chinese used car data for AI assistants
Model Context Protocol server for EnCarAPI. Lets Claude, Cursor, ChatGPT and other MCP clients search live used car listings from South Korea (Encar, KB Chachacha, K Car) and China (Dongchedi, Che168), and pull full details, inspection reports, Encar diagnoses and accident records.
An API key is required. Get one (5-day trial) at encarapi.com. Chinese data works with a ChinaCarAPI key or an EnCarAPI key with the China add-on. ChinaCarAPI customers: see For ChinaCarAPI customers.
Tools
Tool | What it does |
| Search Korean listings (brand, model, year, price in 10,000 KRW, mileage, fuel, accident-free, seller region and city, source: encar / kbc / kcar / all; |
| Search Korean used excavators (maker, model, operating hours, weight class, region; Business/Scale key) |
| Search Korean trucks, buses and special vehicles (body type, payload in tons, use, region; Business/Scale key) |
| All Encar / K Car listings of one VIN, incl. removed ones (Business/Scale key) |
| Full record for one truck: detail, inspection report, cargo box, VIN and plate (Business/Scale key) |
| Full detail for one listing (specs, options, photos, price history, seller, |
| Official Korean inspection report; Encar ids and |
| Encar diagnosis (엔카진단): which outer panels were replaced, inspector verdict incl. frame result (Encar listings only) |
| Encar vehicle history (차량이력): inspections, repairs, owner changes, insurance claims, recalls, odometer over time (Encar listings only) |
| Insurance accident history and ownership changes |
| Model name autocomplete across brands |
| Valid filter values |
| Search Chinese listings (brand, model, model year, registration year, price in CNY, mileage, power, city, fuel, source, export-ready; |
| Full record for one Chinese listing ( |
| Full record by Che168/Dongchedi listing link (desktop, mobile or app; |
| Chinese inspection report (accident, flood, fire, EV battery) |
| Autohome specification sheet of a Che168 trim (cc, kW, hp, torque, emission standard, weights, EV battery) |
| Valid makes, fuels, cities and sources with listing counts |
| Models of a brand with listing counts |
Chinese lang: zh returns the original Chinese values, ru Russian values for the fixed fields (fuel,
transmission, drivetrain, colours, seller type, condition, vehicle class), city names and equipment names;
make, model and trim names stay Latin.
All tools are read-only.
Related MCP server: used-parts-mcp
Option 1: hosted (no install)
Add this URL as a remote MCP server:
https://mcp.encarapi.com/mcpIn clients with OAuth support the URL is all you need. On first use a browser window opens, you paste your EnCarAPI key once, and the client is connected:
Claude (claude.ai, desktop, mobile): Settings - Connectors - Add custom connector, paste the URL
ChatGPT (developer mode): Settings - Connectors - create a connector with the URL
Cursor:
{"mcpServers": {"encarapi": {"url": "https://mcp.encarapi.com/mcp"}}}in.cursor/mcp.jsonVS Code: "MCP: Add Server" - HTTP - paste the URL
Claude Code:
claude mcp add --transport http encarapi https://mcp.encarapi.com/mcpThe key is checked once and is not stored on the server: it is encrypted into the token your client receives. To disconnect, remove the server in your client; to cut off access everywhere, rotate your key at encarapi.com.
Alternative: send the key yourself
Clients without OAuth support, scripts and gateways can send the key directly:
https://mcp.encarapi.com/mcp
Authorization: Bearer YOUR_ENCARAPI_KEYClaude Code:
claude mcp add --transport http encarapi https://mcp.encarapi.com/mcp \
--header "Authorization: Bearer YOUR_ENCARAPI_KEY"The x-api-key: YOUR_ENCARAPI_KEY header works as well. Clients that only accept a URL and
have no OAuth support can use https://mcp.encarapi.com/mcp?key=YOUR_ENCARAPI_KEY (a header
is preferred, since URLs can end up in logs). A separate ChinaCarAPI key goes into the
x-china-key header, or into the second field of the browser form.
For ChinaCarAPI customers
ChinaCarAPI has its own address:
https://mcp.chinacarapi.com/mcpAdd it as a remote MCP server exactly as above. On first use a browser window opens and you paste your ChinaCarAPI key once. The form detects which key it is, so an EnCarAPI key works there as well; customers with both keys put the EnCarAPI key into the optional second field.
Claude (claude.ai, desktop, mobile): Settings - Connectors - Add custom connector, paste the URL
Cursor:
{"mcpServers": {"chinacarapi": {"url": "https://mcp.chinacarapi.com/mcp"}}}in.cursor/mcp.jsonClaude Code:
claude mcp add --transport http chinacarapi https://mcp.chinacarapi.com/mcpOn this address the Chinese tools are listed first. Start with chinese_filter_values to
get valid makes, fuels and cities (the city filter needs the exact value from that list).
Without the browser login, send the key as a header. On mcp.chinacarapi.com a key in
Authorization: Bearer or x-api-key counts as a ChinaCarAPI key:
claude mcp add --transport http chinacarapi https://mcp.chinacarapi.com/mcp \
--header "Authorization: Bearer YOUR_CHINACARAPI_KEY"x-china-key: YOUR_CHINACARAPI_KEY works on both addresses; then Authorization can carry
an EnCarAPI key for the Korean tools.
Locally (npx), set CHINACARAPI_KEY instead of ENCARAPI_KEY:
claude mcp add chinacarapi -e CHINACARAPI_KEY=YOUR_CHINACARAPI_KEY -- npx -y encarapi-mcpOption 2: local (npx)
Claude Desktop (claude_desktop_config.json), Cursor (.cursor/mcp.json) and most other
clients:
{
"mcpServers": {
"encarapi": {
"command": "npx",
"args": ["-y", "encarapi-mcp"],
"env": {
"ENCARAPI_KEY": "YOUR_ENCARAPI_KEY"
}
}
}
}Claude Code:
claude mcp add encarapi -e ENCARAPI_KEY=YOUR_ENCARAPI_KEY -- npx -y encarapi-mcpOptional: CHINACARAPI_KEY for a separate ChinaCarAPI key.
Example prompts
"Find accident-free Genesis GV80 from 2022 or newer under 50 million KRW and compare the mileage."
"Show the inspection report and accident record for Encar listing 41000001."
"What are the cheapest export-ready BYD Seal listings in China right now?"
Self-hosting the HTTP endpoint
docker build -t encarapi-mcp .
docker run -p 3000:3000 encarapi-mcp # POST /mcp, GET /healthStateless: every request carries its own key, nothing is stored.
To enable the OAuth flow ("connect by URL only"), set two environment variables:
Variable | Meaning |
| At least 32 random characters, e.g. |
| Public origin of the server, e.g. |
| Optional, several public origins separated by commas, e.g. |
docker run -p 3000:3000 -e MCP_OAUTH_SECRET="$(openssl rand -base64 48)" \
-e MCP_PUBLIC_URL=https://mcp.example.com encarapi-mcpThis adds /.well-known/oauth-protected-resource, /.well-known/oauth-authorization-server,
/register, /authorize and /token (OAuth 2.1 with PKCE, dynamic client registration).
There is still no database: client ids, authorization codes and tokens are encrypted,
self-contained values (AES-256-GCM) that carry the key. Consequences:
Changing
MCP_OAUTH_SECRETsigns out all OAuth clients (they reconnect through the browser).Access tokens last 1 hour, refresh tokens 90 days and are replaced on every use.
Single use of authorization codes and of replaced refresh tokens is tracked in memory, so it is best-effort: it does not survive a restart and is not shared between instances.
A single token cannot be revoked on the server. Rotating the EnCarAPI key cuts off all access.
Links
EnCarAPI: encarapi.com
ChinaCarAPI: chinacarapi.com
EnCarAPI is an independent service and not affiliated with Encar, KB Chachacha, K Car, Dongchedi or Che168.
License
MIT
Available Tools
11 toolschinese_filter_valuesChinese filter valuesARead-onlyInspect
Valid values for the Chinese search filters, with listing counts: makes, fuels, cities, sources, sorts. City filters need the exact 'value' of a city entry. Pass list to get one list only.
Inputs: list.
chinese_modelsChinese models of a brandBRead-onlyInspect
Models of one brand in the Chinese catalog, with listing counts.
Inputs: make (required).
find_korean_modelsFind Korean model namesARead-onlyInspect
Autocomplete model names across brands (e.g. 'sorento', 'gv70'). Use the result to filter search_korean_cars.
Inputs: search (required), limit.
get_chinese_carGet a Chinese carARead-onlyInspect
Full record for one Chinese listing: price history, photos, seller, export status, same car on the other marketplace.
Inputs: id (required), source.
get_chinese_inspectionGet a Chinese inspection reportBRead-onlyInspect
Inspection report for one Chinese car: accident, flood and fire checks, battery data for EVs.
Inputs: id (required), source.
get_korean_accident_recordGet a Korean accident & ownership recordBRead-onlyInspect
Insurance accident history and ownership changes for one Korean car (own vs. other-party damage in KRW).
Inputs: id (required).
get_korean_carGet a Korean carARead-onlyInspect
Full details for one Korean listing: specs, options, photos, price history, seller. Id: Encar id, 'kbc:' or 'kcar:'.
Inputs: id (required).
get_korean_inspectionGet a Korean inspection reportBRead-onlyInspect
Official Korean inspection report (performance check) for one car: panels, frame, mechanical condition.
Inputs: id (required).
korean_filter_valuesKorean filter valuesCRead-onlyInspect
Valid values for the Korean search filters (fuels, colors, categories, ...).
Inputs: source.
search_chinese_carsSearch Chinese used carsARead-onlyInspect
Search live used car listings in China (Dongchedi and Che168, duplicates merged), in English. Prices are in CNY; results include USD and EUR conversions. Use chinese_filter_values and chinese_models for exact make, model, fuel and city values.
Inputs: city, fuel, lang, make, +15 more.
search_korean_carsSearch Korean used carsARead-onlyInspect
Search live used car listings in South Korea. Default source is Encar; 'kbc' = KB Chachacha, 'kcar' = K Car, 'all' = all three deduplicated (plan-dependent). Prices are filtered in 10,000 KRW units (e.g. max_price 3000 = 30,000,000 KRW). Returns the total count and compact listings.
Inputs: fuel, page, sort, limit, +15 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Korean and Chinese tools are cleanly separated by language prefix, and search/get/inspection purposes are distinct. Minor overlap between get_korean_inspection and get_korean_accident_record (both single-car history) and between the two *_filter_values tools could cause occasional misselection, but overall boundaries are clear.
Strong verb_noun pattern throughout (search_*, get_*, find_korean_models, *_filter_values). The one deviation is chinese_models lacking a verb while its Korean counterpart is find_korean_models, and get_korean_accident_record is a longer compound, but the scheme is largely predictable.
11 tools is well-scoped for a dual-market used-car search server, with each tool earning its place across two parallel Korean/Chinese surfaces. No bloat or redundancy.
Covers search, detail, inspection, accident/insurance, model autocomplete, and filter values for both markets. Chinese lacks a dedicated accident_record (folded into get_chinese_inspection), which is a minor gap but core workflows are covered.
Related MCP Connectors
Read-only MCP for Copart and IAA/IAAI search, history, filters, locations, shipping, and usage.
Search live US dealership inventory, get market prices, and send buyer inquiries. Free, no API key.
Read-only MCP access to a used-car dealer's inventory, profit, expenses, sales, debts and cash.
Live franchised-dealer inventory, quotes, and consented salesperson handoffs.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables access to comprehensive vehicle information including VIN decoding, license plate OCR, vehicle history checks (theft, title, salvage records), market valuations, specifications, and warranty data for vehicles across North America and Europe.611MIT
- AlicenseNot gradedqualityCmaintenanceEnables searching current used car, truck, and motorcycle parts in the US, resolving vehicles via VIN, and retrieving part listings with source attribution, through read-only MCP tools.Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables consultation of vehicle documents from an official source via a single read-only tool, with prepaid per-query pricing and compatibility across MCP clients.MIT
- AlicenseNot gradedqualityDmaintenanceEnables querying the official Brazilian vehicle registration (CRLV-e) system with a single read-only tool. Works with any MCP client, featuring prepaid pay-per-use pricing.MIT