# Tesla — how to use (mcp.ai)

Your Tesla in the assistant through Tesla's official Fleet API: send a destination to the car's navigation (address, coordinates or Supercharger), check battery, range, charging, climate, locks and location, and send commands: lock and unlock, turn on climate, start or stop charging, set the charge limit and honk or flash the lights. You authorize with your Tesla account and pair the app's virtual key with the car. Pay per use with prepaid credits.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_tesla?ms=1791686100000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `tesla_acordar`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/tesla`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/tesla/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/tesla/acordar` — Acorda o carro (sai do modo dormindo) e espera até ~30 s ficar online. Use antes de ler o estado de um carro dormindo. Tem custo maior que uma leitura e gasta um pouco de bateria.
  - body: { veiculos?: string[], account?: string }
- `POST https://api.mcp.ai/api/tesla/buzinar/piscar` — Buzina ou pisca os faróis do carro, para achá-lo num estacionamento. Faz barulho/luz de verdade no local do carro.
  - body: { veiculos?: string[], acao: string, account?: string }
- `POST https://api.mcp.ai/api/tesla/carga` — Controla a carga: `iniciar` ou `parar` a carga (o cabo precisa estar conectado) e/ou ajustar o limite de carga em % (50 a 100).
  - body: { veiculos?: string[], acao?: string, limite_percent?: integer, account?: string }
- `POST https://api.mcp.ai/api/tesla/clima` — Liga ou desliga o ar-condicionado do carro e, opcionalmente, define a temperatura (°C, motorista e passageiro). Ex.: ligar a 21 °C antes de sair.
  - body: { veiculos?: string[], ligar: boolean, temperatura_c?: number, account?: string }
- `POST https://api.mcp.ai/api/tesla/definir/destino` — Envia um destino para a navegação do carro, que começa a rota na tela. Passe `endereco` (texto livre, como no app da Tesla) OU `latitude` + `longitude`. Acorda o carro se precisar.
  - body: { veiculos?: string[], endereco?: string, latitude?: number, longitude?: number, account?: string }
- `POST https://api.mcp.ai/api/tesla/destravar` — DESTRAVA as portas do carro, com efeito físico imediato: qualquer pessoa ao lado do carro consegue abri-lo. Só use quando o dono pedir explicitamente. Acorda o carro se precisar.
  - body: { veiculos?: string[], account?: string }
- `POST https://api.mcp.ai/api/tesla/estado` — Estado do carro: bateria (%), autonomia (km), carga (conectado, carregando, limite, tempo restante), clima (temperaturas, ar ligado), travas, portas e janelas, odômetro e software. Se o carro estiver 
  - body: { veiculos?: string[], acordar?: boolean, account?: string }
- `POST https://api.mcp.ai/api/tesla/ir/supercharger` — Inicia a navegação do carro até o Supercharger mais próximo. Acorda o carro se precisar.
  - body: { veiculos?: string[], account?: string }
- `POST https://api.mcp.ai/api/tesla/localizacao` — Localização atual do carro: latitude, longitude, direção e velocidade, e o destino ativo na navegação quando houver. Não acorda o carro salvo `acordar: true`.
  - body: { veiculos?: string[], acordar?: boolean, account?: string }
- `POST https://api.mcp.ai/api/tesla/travar` — Trava as portas do carro. Acorda o carro se precisar.
  - body: { veiculos?: string[], account?: string }
- `POST https://api.mcp.ai/api/tesla/veiculos` — Lista os carros da conta Tesla conectada: VIN, nome, modelo, se está online ou dormindo, e se a chave virtual do app já está pareada (sem ela os comandos não chegam ao carro). Não acorda o carro.
  - body: { account?: string }

## Example prompts
- "Send 1 Infinite Loop, Cupertino to my Tesla's navigation"
- "How much battery and range does my car have right now?"
- "Turn on the car's climate at 70°F"

## More
- Page: https://mcp.ai/tesla
- Agent spec (llms.txt): https://mcp.ai/tesla/llms.txt
- Postman collection: https://mcp.ai/tesla/postman.json