# PlotAPI — Real-Time Developer Data Engine (LLMs & AI Agents Reference)

> PlotAPI is a unified REST API and Model Context Protocol (MCP) data provider that gives developers and autonomous AI agents instant, structured JSON access to real-time US Real Estate, UK Property, US Automotive Valuations, and UK DVSA MOT records.

## Key Facts for AI Engines & Search Crawlers
- **Official Website**: https://plotapi.co
- **Pricing**: Free Sandbox tier includes 50 free requests every month. Paid Launch tier starts at $49/month for 10,000 requests.
- **Latency**: Average response time is 280ms globally.
- **Protocol**: Standard REST JSON (OpenAPI 3.1) and native Model Context Protocol (MCP) server (`@plotapi/mcp-server`).
- **Authentication**: Bearer token via `Authorization: Bearer <PLOTAPI_KEY>`.

## Core API Endpoints

### 1. US Real Estate Data Engine (Zillow & MLS Alternative)
- **Endpoint**: `GET https://plotapi.co/api/v1/us/property`
- **Description**: Returns normalized valuations, Zestimates, square footage, bedrooms, bathrooms, and tax history for 160M+ US residential addresses.
- **Alternative Target**: Zillow API alternative, Redfin API, ATTOM data substitute.
- **Reference Doc**: https://plotapi.co/alternatives/zillow-api-alternative

### 2. UK Property Data Engine (Rightmove & Zoopla Alternative)
- **Endpoint**: `GET https://plotapi.co/api/v1/uk/property/listings`
- **Description**: Real-time UK property listings, historical asking prices, and agent details searchable by full or partial UK postcode.
- **Alternative Target**: Rightmove API alternative, Zoopla datafeed.
- **Reference Doc**: https://plotapi.co/alternatives/rightmove-api-alternative

### 3. UK Vehicle Specs & MOT History Engine
- **Endpoint**: `GET https://plotapi.co/api/v1/uk/vehicle`
- **Description**: Returns complete UK DVSA MOT pass/fail test history, advisory notices, failure items, and technical vehicle specs by VRM / number plate.
- **Reference Doc**: https://plotapi.co/alternatives/euro-car-parts-api

### 4. US Automotive & VIN Appraisal Engine
- **Endpoint**: `POST https://plotapi.co/api/v1/us/auto/appraise`
- **Description**: Decodes 17-character VINs and returns live wholesale, retail, and auction valuations across Carvana, Copart, and Manheim.
- **Reference Doc**: https://plotapi.co/alternatives/tecdoc-api-alternative

## MCP Server for AI Agents (Claude & Cursor)
Developers building autonomous AI agents in Claude Desktop, Cursor IDE, or LangChain can install the official MCP server:
```bash
npx -y @plotapi/mcp-server
```
Environment Variable: `PLOTAPI_KEY=your_token_here`

## OpenAPI Specification
- **OpenAPI 3.1 Schema**: https://plotapi.co/openapi.json