askacharge.com — EV charging network (OCPP/OCPI CSMS)

Servidor MCP remoto para operar uma rede de pontos de recarga de veículos elétricos via OCPP: status em tempo real, sessões, tarifas, preços horários, comandos remotos, integração. Hospedado, sem necessidade de instalação; ferramentas filtradas por escopos de chave de API.

GitHubExperimente este MCPPatrocinado

Documentação

Servidor MCP askacharge.com

Deixe um agente de IA operar uma rede de pontos de carregamento de veículos elétricos.

askacharge.com é um CSMS — um Sistema de Gerenciamento de Estações de Carregamento — para carregamento de veículos elétricos: OCPP 1.6J e 2.0.1 para o hardware, tarifas e faturamento, pagamentos de motoristas via QR e RFID, roaming OCPI 2.2 entre operadores e faturamento fiscal. Este repositório documenta seu servidor MCP remoto, que expõe essa plataforma a qualquer cliente do Model Context Protocol.

Nada para instalar. É um endpoint hospedado:

https://askacharge.com/askacharge/api/mcp

O transporte é JSON-RPC 2.0 via HTTP POST (streamable-http). Versões de protocolo aceitas: 2025-06-18, 2025-03-26, 2024-11-05. GET retorna 405 de propósito — não há stream SSE.

Por que isso existe

Operadores de pontos de carregamento passam o dia com perguntas que um agente pode responder diretamente: quais carregadores estão offline agora, quanto o site X faturou no mês passado, é barato o suficiente para carregar nesta hora, reinicie o que parou de responder. A API REST sempre foi capaz de fazer isso. O MCP é o que torna isso utilizável por um agente sem que ninguém escreva uma integração antes — o valor não está no protocolo, mas na descrição de quando usar cada ferramenta e o que acontece se você errar.

Autenticação

Um cabeçalho, a chave de API da marca, criada no painel em API keys:

Authorization: Bearer ask_live_...

X-Api-Key: ask_live_... também funciona.

Os escopos da chave decidem quais ferramentas você pode ver. Uma chave somente leitura nunca recebe askacharge_parar_carga. Uma chave restrita a uma localização (commands:write@hotel-madrid) vê as ferramentas de comando e recebe um 403 quando as aponta para um carregador em outro lugar. Uma chave pertence a uma marca e alcança apenas os dados dessa marca.

As 21 ferramentas

Leitura

Ferramenta	O que ela responde
`askacharge_listar_cargadores`	Cada ponto de carregamento com status OCPP, localização e último contato
`askacharge_ver_cargador`	Um carregador em detalhes: conectores, potência, modo de acesso, status
`askacharge_estado_en_vivo`	Agora: carregadores conectados, sessões em andamento, potência sendo consumida
`askacharge_resumen`	KPIs do período — energia, receita, margem líquida, sessões, clientes
`askacharge_listar_sesiones`	Histórico de sessões de carregamento com energia, receita e custo
`askacharge_listar_incidencias`	Falhas abertas por carregador
`askacharge_listar_tarifas`	Grupos de tarifas: por kWh, por hora, por sessão, PVPC ou gratuito
`askacharge_precio_pvpc_hoy`	Preço horário de hoje da eletricidade PVPC espanhola
`askacharge_listar_clientes`	Clientes frotistas com sua tarifa e consumo mensal
`askacharge_limites_de_potencia`	Teto de kW por localização e estratégia de balanceamento de carga
`askacharge_traza_de_actividad`	O que as chaves de API da marca fizeram: gravações e tentativas rejeitadas

Comandos OCPP — estes agem no hardware físico

Ferramenta	O que ela faz
`askacharge_arrancar_carga`	Início remoto (OCPP `RemoteStartTransaction`)
`askacharge_parar_carga`	Parada remota (OCPP `RemoteStopTransaction`) — interrompe uma sessão ativa
`askacharge_reiniciar_cargador`	Reinicialização, suave ou forçada (OCPP `Reset`)
`askacharge_cambiar_disponibilidad`	Colocar um carregador em ou fora de serviço (OCPP `ChangeAvailability`)
`askacharge_diagnosticos`	Pedir ao carregador para enviar seu arquivo de diagnóstico (OCPP `GetDiagnostics`)

Gravação

Ferramenta	O que ela faz
`askacharge_crear_cargador`	Registrar um ponto de carregamento
`askacharge_crear_tarifa`	Criar um grupo de tarifas (`per_kwh`, `per_hour`, `per_session`, `pvpc_margin`, `free`…)
`askacharge_crear_cliente`	Registrar um cliente frotista
`askacharge_crear_tag_rfid`	Autorizar uma tag RFID na marca

Saída de emergência

Ferramenta	O que ela faz
`askacharge_llamar_api`	Chamar qualquer uma das 438 operações de API da plataforma, sob as mesmas verificações de permissão

Ela não reimplementa o produto

Cada ferramenta é executada contra a própria API REST do askacharge.com com a mesma chave, portanto passa pelos mesmos escopos, o mesmo trilho de auditoria, o mesmo limite de taxa e o mesmo tratamento de idempotência. Se uma ferramenta pudesse fazer algo que a API proíbe, isso é um bug no servidor, não um recurso. O envelope em si não é o que é registrado — a operação concreta que ele acionou é.

Como usar

Claude Code

claude mcp add --transport http askacharge https://askacharge.com/askacharge/api/mcp \
  --header "Authorization: Bearer ask_live_..."

Clientes que aceitam uma configuração JSON

{
  "mcpServers": {
    "askacharge": {
      "type": "http",
      "url": "https://askacharge.com/askacharge/api/mcp",
      "headers": { "Authorization": "Bearer ask_live_..." }
    }
  }
}

Bruto, para verificar se está ativo

curl -s -X POST https://askacharge.com/askacharge/api/mcp \
  -H "Authorization: Bearer ask_live_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Sem uma chave, você recebe um erro JSON-RPC informando isso, o que também é uma boa maneira de confirmar que o endpoint está acessível.

Obtendo uma chave

Crie uma conta em askacharge.com — teste de 30 dias, sem cartão — e depois API keys no painel. O preço é fixo de €20/mês com carregadores ilimitados e sem comissão de software por sessão; a lista completa, incluindo o que tem porcentagem, está em askacharge.com/askacharge/en/pricing.html.

Limitações honestas

Nomes e descrições das ferramentas estão em espanhol. O primeiro mercado da plataforma é a Espanha e o País Basco. Os modelos lidam com isso sem problemas, mas você deve saber antes de integrar.
Escopar uma chave por localização restringe o que ela pode agir, não o que ela pode ler. Uma listagem ainda retorna a marca inteira. Isso é comportamento documentado, não uma falha.
Não há sandbox separado. Para testar sem consequências, crie uma marca em modo de teste.
Sem stream SSE. Apenas requisição/resposta.

Uma declaração mais completa do que a plataforma é e não é — incluindo limites arquiteturais atuais — está em askacharge.com/llms.txt.

Relacionados

En español

Servidor MCP remoto de askacharge.com, la plataforma de gestión de cargadores de vehículo eléctrico (CSMS) con OCPP 1.6J/2.0.1, roaming OCPI 2.2, pago por QR y facturación fiscal (Verifactu y TicketBAI/Batuz).

Endpoint: https://askacharge.com/askacharge/api/mcp. No hay nada que instalar. Se autentica con la API key de la marca en Authorization: Bearer, y los scopes de esa key deciden qué herramientas se ven: una key de solo lectura nunca ve las de parar una carga, y una acotada por ubicación (commands:write@hotel-madrid) recibe un 403 si apunta a un cargador de otra sede.

Son 21 herramientas —cargadores, estado en vivo, sesiones, tarifas, PVPC, clientes, límites de potencia, comandos OCPP y altas— más askacharge_llamar_api, que abre las 438 operaciones de la API con el mismo control de permisos. Ninguna reimplementa lógica de negocio: todas se ejecutan contra la propia API REST, con los mismos scopes, la misma traza y el mismo límite de uso.

Cuenta y key: askacharge.com, 30 días de prueba sin tarjeta. Precios en askacharge.com/askacharge/precios.html.

Licença

MIT — veja LICENSE.

Registro

Publicado no MCP Registry oficial como com.askacharge/askacharge, autenticado contra o domínio askacharge.com.

curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=askacharge"

Veja também

awesome-ocpp — lista selecionada de servidores OCPP, bibliotecas, simuladores e recursos de roaming.
askacharge-python — SDK Python para a mesma API.
Comparação de CSMS 2026 — onde o askacharge.com se encaixa entre onze plataformas, com preços públicos.