Skip to content

Repository files navigation

Car Image API — plugin for Claude Code, Codex and Cursor

Studio-quality, transparent-background renders of any vehicle, wherever your agent works. One repository, native packaging for each client, plus the vendor-neutral Open Plugins manifest.

Any make, model and year from 1990 to 2027 — 1,607 makes and 46,120 models from the open @meterapp/vehicle-db catalog. Eight camera views, any paint color (15 named presets or any hex), PNG/WebP/JPG up to 1024 px, delivered at any width × height (fit contain, cover or inside), transparent or on a solid background, optionally trimmed to the car. Plus free VIN decoding, stable vehicle ids, and textured 3D models (GLB, USDZ, FBX) of any vehicle in any paint.

1 credit per image · 100 credits per 3D model, once per vehicle and color, hosted for free · VIN decoding free · Free 100 credits at signup · Pro $29/mo 25,000 credits a month · Business $99/mo 150,000 · $1 per 100 credits beyond the allowance, purchased credits never expire.

Install

Claude Code

/plugin marketplace add MeterApp/car-image-plugins
/plugin install car-image@meterapp

Codex

codex plugin marketplace add MeterApp/car-image-plugins
codex plugin add car-image@meterapp

Skills only, any agent

npx skills add MeterApp/car-image-plugins

Then sign in

Start a new session and sign in to the Car Image MCP server when your host prompts you. In Claude Code, open /mcp, select the Car Image server, and authenticate in your browser. The plugin uses OAuth: no API key or environment variable is required. Codex and Cursor use their MCP connection controls to sign in.

Updating from an older release? Update the plugin and restart the host before signing in. In Claude Code, run /plugin marketplace update meterapp, then /plugin update car-image@meterapp. For an Anthropic Directory install, use the marketplace shown for that install in /plugin.

Skills-only installs do not configure an MCP connection; follow the car-image-mcp setup skill. For SDK, CLI or a host without OAuth, get a key with npx @meterapp/car-image login or at the dashboard and follow the explicit API-key setup in that skill.

Then try:

"Add a red 2024 Porsche 911 side view to the hero section."

What you get

Seven skills and the hosted MCP server.

Skill Job
car-image Fetch a render; costs, auth, which call to make, error handling
car-image-urls Signed delivery URLs for pages, emails and documents — no key in the browser
vehicle-catalog Free text or a VIN → exact make, model and year and its stable id; search, disambiguation, offline lookups
car-3d 3D models (GLB, USDZ, FBX) of any vehicle in any paint: cost, owning it once, waiting, webhooks, publishing and the <car-3d> embed
car-image-sdk The TypeScript SDK, the CLI, and plain REST
car-image-support Source-linked product answers, pricing, missing-context reporting and hosted billing links
car-image-mcp Connecting over MCP and fixing it when tools do not appear

The hosted MCP server at https://carimage.dev/api/mcp exposes seventeen core tools: get_make_logo, get_car_image, create_car_image_urls, search_vehicles, resolve_vehicle, decode_vin, create_3d_model, get_3d_model, publish_3d_model, list_image_options, get_account, rate_image, describe_api, get_pricing, search_help, create_checkout_link and get_billing_link. get_make_logo, get_car_image and create_car_image_urls cost 1 credit; create_3d_model costs 100 (free once the account owns the vehicle and color); the rest are free. This plugin connects to https://carimage.dev/api/mcp?toolset=all, which adds the free request-board tools list_requests, request_vehicle, request_feature, get_request, upvote_request and comment_on_request, and share_building / share_referral for telling the team about yourself (private) — twenty-five tools in all, because the skills teach them. Missing a vehicle? The agent can file it, and you get an email when it is live.

Authentication

Surface Credential
Plugin / hosted MCP Browser OAuth sign-in; the host stores and refreshes the token
Manually configured MCP without OAuth Explicit Authorization: Bearer $CAR_IMAGE_API_KEY header
SDK and CLI CAR_IMAGE_API_KEY, or the key stored by car-image login
Browsers Never a key — signed delivery URLs only

The plugin config intentionally has no Authorization header: adding one disables OAuth fallback in Claude Code. For manual API-key connections, send the key as a header, never in a URL, and keep it out of committed config files.

Safety model

  • A 402 (out of credits, or plan_vehicle_limit when the plan's monthly cap on distinct vehicles is reached) is a question for a human. Agents never buy credits or subscribe to, change or cancel a plan on their own.
  • Renders are generated product visuals, not OEM photography. Never claim a specific trim or an individual listed vehicle is depicted exactly.
  • A signed delivery URL is unguessable, not access-controlled. Treat it as public for its lifetime.
  • Confirm the count and the cost before a batch the user did not size, and before any 3D model (100 credits each, unless the account already owns that vehicle in that color).

Development

python3 scripts/validate_repo.py
claude plugin validate . --strict
codex plugin marketplace add . --json

This repository is published from the Car Image API source. Please open an issue here, or write to support@carimage.dev, rather than sending a pull request — changes are overwritten on the next release.

Links

Docs · Install guide · agents.md · openapi.json · Error reference · support@carimage.dev

License

MIT

The MCP configuration sends X-CarImage-Integration: plugin for usage attribution. This declares the integration; it contains no user identity, prompt, or conversation text. The calling host may separately identify itself through MCP client information.

Product help and billing links

Use search_help for source-linked product, licensing, policy and Enterprise answers; search each question separately without customer emails or secrets. Use report_gap: true when related articles do not answer the question. Queries are recorded privately to improve documentation. get_pricing returns current plans and packs. On the human's request, create_checkout_link prepares a purchase and get_billing_link opens settings; the human confirms in the browser. Connected apps get a sign-in dashboard link. Never send an owner-account Stripe link to another customer.

CLI: car-image pricing, car-image support "question" [--report-gap], car-image billing --credits 500 --no-browser, car-image billing --plan pro --no-browser, car-image billing --portal. SDK: pricing(), searchHelp(question), createCheckoutLink({credits: 500}), getBillingLink(). The plugin includes the car-image-support skill.

Help center.

About

Car Image API plugin for Claude Code, Codex and Cursor: studio-quality, transparent-background vehicle renders for any project.

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages