{
  "markdown": "# Vincario MCP Server\n\nAn [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that exposes the\n[Vincario API](https://vincario.com/) to AI agents and LLM clients. Enables AI assistants to\ndecode VINs, check stolen vehicle databases, and retrieve market valuations through natural language.\n\n## Tools\n\n| Tool | Description |\n|---|---|\n| `vin_decode` | Decode a VIN and return detailed vehicle information |\n| `vin_decode_info` | List available fields for a given VIN (free endpoint) |\n| `stolen_check` | Check if a VIN appears in stolen vehicle databases |\n| `vehicle_market_value` | Get market valuation for a vehicle (supports odometer input) |\n\n## Requirements\n\n- [Vincario API key](https://vincario.com/vin-decoder/) — passed via `X-API-Key` HTTP header\n- Docker (recommended), or Python 3.11+ with [uv](https://github.com/astral-sh/uv)\n\n## Running with Docker\n\n```bash\ndocker build -t vincario-mcp .\ndocker run -p 8080:8080 vincario-mcp\n```\n\nThe server starts on `http://localhost:8080`.\n\n## Running locally\n\n```bash\npip install uv\nuv sync\nuv run main.py\n```\n\n## Connecting to an MCP client\n\nPass your Vincario API key as an HTTP header with each request:\n\n```\nX-API-Key: your_api_key_here\n```\n\n### Claude Code\n\nAdd to your MCP config (`.mcp.json` or `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"vincario\": {\n      \"type\": \"http\",\n      \"url\": \"http://localhost:8080\",\n      \"headers\": {\n        \"X-API-Key\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n```\n\n### Hosted endpoint\n\nIf connecting to the hosted server at `https://mcp.vincario.com/mcp`, replace the URL accordingly.\n\n## Example usage\n\nOnce connected, you can ask your AI assistant:\n\n- *\"Decode VIN WBAFR9C54BC780006\"*\n- *\"Is this vehicle stolen? VIN: WBAFR9C54BC780006\"*\n- *\"What is the market value of VIN WBAFR9C54BC780006 with 85000 km?\"*\n\n## Transport\n\nThe server uses **streamable HTTP** transport (`stateless_http=True`), which means no persistent session is required. Each request is independent, making it straightforward to deploy behind a reverse proxy or load balancer.\n\nFor HTTPS deployment, place a reverse proxy (nginx, Caddy, Cloudflare) in front of the server — the application itself runs on plain HTTP port 8080.\n\n## License\n\nSee [Vincario API Terms of Service](https://vincario.com/terms-and-conditions/) for usage terms.\n",
  "bytes": 2342,
  "sha": "303e9347cce82344fdcb843668ec968db842528c66d49f4104cc7209d65f9cb4",
  "repo_slug": "vincario/mcp-vincario",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_vincario_vehicle_data_9583c07b/readme"
}