com.askachargePublished by askacharge.comOfficial publisherv1.0.0Updated Oct 25, 2026
Operate a network of EV charge points over OCPP: status, sessions, tariffs, prices, remote commands
Remote MCP server for the askacharge.com EV charging platform, letting an assistant inspect chargers, sessions, tariffs and prices and send OCPP commands to the
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/com.askacharge%2Faskacharge/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"askacharge-com-ev-charging-network": {
"type": "http",
"url": "https://askacharge.com/askacharge/api/mcp",
"headers": {
"Authorization": "Bearer <YOUR_TOKEN>"
}
}
}
}[Listed on mcpservers.org] [Glama score]
Let an AI agent operate a network of EV charge points.
askacharge.com is a CSMS — a Charging Station Management System — for electric vehicle charging: OCPP 1.6J and 2.0.1 to the hardware, tariffs and billing, QR and RFID driver payments, OCPI 2.2 roaming between operators, and fiscal invoicing. This repository documents its remote MCP server, which exposes that platform to any Model Context Protocol client.
Nothing to install. It is a hosted endpoint:
Transport is JSON-RPC 2.0 over HTTP POST (streamable-http). Protocol versions accepted:
2025-06-18, 2025-03-26, 2024-11-05. GET returns 405 on purpose — there is no SSE stream.
Charge point operators spend their day on questions an agent can answer directly: which chargers are offline right now, what did site X earn last month, is it cheap enough to charge at this hour, reboot the one that stopped responding. The REST API has always been able to do that. MCP is what makes it usable by an agent without anyone writing an integration first — the value is not the protocol, it is the description of when to use each tool and what happens if you get it wrong.
One header, the brand's API key, created from the panel under API keys:
X-Api-Key: ask_live_... works too.
Once a key is present, its scopes decide which tools you can see. A read-only key never gets shown
askacharge_parar_carga. Commands can be granted one by one: a key with commands:remote-start and
commands:remote-stop sees start and stop but not reboot (commands:reset) or firmware; commands:write
still means all of them. A key restricted to one location (commands:reset@hotel-madrid) sees the
command tools and receives a 403 when it aims them at a charger somewhere else. A key belongs to one
brand and reaches only that brand's data.
Read
OCPP commands — these act on physical hardware. Each one returns the charger's acknowledgement
inline plus a job_id; the real effect arrives later over OCPP and closes the job, so ask
askacharge_estado_comando instead of repeating the command (repeating it starts two sessions or
reboots twice).
Write
Escape hatch
Every tool runs against askacharge.com's own REST API with the same key, so it passes through the same scopes, the same audit trail, the same rate limit and the same idempotency handling. If a tool could ever do something the API forbids, that is a bug in the server, not a feature. The envelope itself is not what gets logged — the concrete operation it triggered is.
No key needed for that: initialize, ping and tools/list answer anonymously, and the
anonymous tools/list returns the whole catalogue of 25 tools (it is public anyway — it is the
table above). Everything else — tools/call — needs the key, and without one you get a JSON-RPC
error (-32001) saying so. A key that is present but invalid is an error too, not a fallback to
anonymous.
Create an account at askacharge.com — 30-day trial, no card — then API keys in the panel. Pricing is a flat €20/month with unlimited chargers and no software commission per session; the whole list, including what does carry a percentage, is at askacharge.com/askacharge/en/pricing.html.
A fuller statement of what the platform is and is not — including current architectural limits — lives at askacharge.com/llms.txt.
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, los comandos se pueden conceder
uno a uno (commands:remote-start sin commands:reset), y una acotada por ubicación
(commands:reset@hotel-madrid) recibe un 403 si apunta a un cargador de otra sede. Cada comando
devuelve un job_id y askacharge_estado_comando dice si el efecto real llegó.
Son 25 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 463 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.
MIT — see LICENSE.
Published in the official MCP Registry as
com.askacharge/askacharge, authenticated against the askacharge.com domain.
Source: README.md at commit 20bf771
Listar cargadores
Lista los cargadores de la marca con su estado OCPP, ubicación y último heartbeat. Empieza por aquí para saber qué hay y qué está caído. En una red grande filtra (estado, q) o pagina (limit, offset) en vez de traerla entera; para solo contar, el recuento está en GET /api/brand/charge-points/resumen.
qlimitestadooffsetVer un cargador
Detalle de un cargador concreto: conectores, potencia, modo de acceso y estado.
charge_point_idrequiredEstado en vivo de la red
Foto del momento: cargadores conectados, sesiones activas y potencia que se está entregando ahora mismo. Para diagnosticar, mejor esto que el histórico.
Takes no parameters.
Resumen de KPIs del periodo
Devuelve los KPIs agregados de un periodo —energía, facturado, margen neto, sesiones y clientes— y la variación respecto al periodo anterior. Solo lee, no cambia nada. Para el detalle sesión a sesión usa askacharge_listar_sesiones; para lo que está pasando ahora mismo, askacharge_estado_en_vivo.
periodListar sesiones de carga
Historial de sesiones de carga con energía, ingresos y coste. Úsalo para analizar consumo, facturación o detectar cargas anómalas.
limitListar incidencias
Incidencias abiertas por cargador (averías reportadas).
Takes no parameters.
Listar grupos de tarifa
Lista los grupos de tarifa de la marca —por kWh, por hora, por sesión, combinado, margen sobre PVPC o mercado, por franjas horarias (con sus periods), coste de la luz + margen o gratis— con su precio, y la tarifa por defecto en primer lugar. Solo lee, no cambia nada. Para crear una nueva usa askacharge_crear_tarifa; para el precio horario del mercado, askacharge_precio_pvpc_hoy.
Takes no parameters.
Precio PVPC de hoy
Precio PVPC hora a hora de hoy (mercado regulado español). Úsalo para decidir cuándo conviene cargar o para fijar un margen sobre el precio real.
Takes no parameters.
Listar clientes
Lista los clientes activos de la marca con su tarifa asignada y su consumo del mes. Solo lee, no cambia nada; devuelve todos de una vez (sin filtros ni paginación) y deja fuera a los dados de baja. Para dar de alta uno nuevo usa askacharge_crear_cliente; para sus cargas, askacharge_listar_sesiones.
Takes no parameters.
Ver límites de potencia
Límite de kW por ubicación y estrategia de reparto. Consúltalo antes de arrancar cargas en sitio con potencia contratada justa.
Takes no parameters.
Ver la traza de las API keys
Lista lo que han hecho las API keys de la marca, de lo más reciente a lo más antiguo: escrituras e intentos rechazados, con método, ruta, código de respuesta, IP y duración. Las lecturas correctas NO se registran, y la traza se borra a los 90 días. Solo lee, no cambia nada. Es la herramienta de auditoría de credenciales: para la actividad de carga usa askacharge_listar_sesiones.
limitkey_idsolo_erroresVer cómo va un comando lanzado
Estado de un comando OCPP por su job_id (lo devuelve cada herramienta que manda un comando). Un comando tiene dos tiempos: la respuesta inmediata es solo el acuse del cargador; el efecto real llega después. Estados: 'acked' = aceptado y esperando el efecto (expected_event dice cuál: session.started tras arrancar, charger.online tras reiniciar, connector.status tras cambiar disponibilidad); 'confirmed' = el efecto llegó (en event); 'timeout' = no llegó en 5-10 minutos, algo falló en el cargador; 'rejected' = el cargador dijo que no; 'failed' = ni se pudo enviar. Sin job_id lista los últimos comandos de la marca. Úsala en vez de repetir el comando: repetirlo es arrancar dos cargas o reiniciar dos veces.
job_idcharge_point_idArrancar una carga
Arranca una carga en remoto (OCPP RemoteStartTransaction). El cargador debe estar conectado y el id_tag autorizado en la marca. CUIDADO: entrega energía real y genera un cobro.
id_tagconnector_idcharge_point_idrequiredParar una carga
Para una carga en curso (OCPP RemoteStopTransaction). CUIDADO: corta la carga de un conductor que puede estar esperándola.
transaction_idcharge_point_idrequiredReiniciar un cargador
Reinicia el cargador (OCPP Reset). 'Soft' reinicia el software y 'Hard' es un corte completo. Deja el punto fuera de servicio unos minutos y aborta las sesiones en curso: comprueba antes que no haya ninguna activa.
reset_typecharge_point_idrequiredPoner un cargador dentro o fuera de servicio
Pone un cargador operativo o fuera de servicio (OCPP ChangeAvailability). Úsalo para retirar de servicio un punto averiado sin desconectarlo.
charge_point_idrequiredoperational_statusrequiredDesbloquear un conector
Libera el bloqueo del cable en un conector (OCPP UnlockConnector). Es lo que hay que mandar cuando un conductor no puede sacar el cable al terminar. Si hay sesión en curso, el cargador la para antes. Devuelve Unlocked, UnlockFailed o NotSupported; para un conector que sigue en Faulted, usa askacharge_reiniciar_cargador.
connector_idcharge_point_idrequiredPedir al cargador su estado ahora
Pide al cargador que envíe ya un mensaje concreto (OCPP TriggerMessage): StatusNotification para refrescar el estado del conector, Heartbeat para comprobar que responde, MeterValues para una lectura del contador. Úsalo tras un comando para verificar el resultado sin esperar al siguiente latido. No cambia nada en el cargador; el estado nuevo llega por webhook connector.status y se ve en askacharge_ver_cargador.
connector_idcharge_point_idrequiredrequested_messagePedir diagnóstico al cargador
Pide al cargador que suba su fichero de diagnóstico (OCPP GetDiagnostics). Es el primer paso razonable ante un cargador que falla y no dice por qué.
charge_point_idrequiredDar de alta un cargador
Da de alta un cargador. El charge_point_id es el identificador de fábrica y solo tiene que ser único dentro de esta marca. Tras crearlo, el cargador debe apuntar su OCPP a wss://askacharge.com/askacharge/ocpp/{slug}/{charge_point_id}.
latitudelongitudelocation_namenum_connectorscharge_point_idrequiredAñadir cargadores simulados (sandbox)
Da de alta cargadores simulados en la marca para probar sin hardware: conectan por OCPP en menos de un minuto, laten, cargan solos unas veces al día y responden a todos los comandos (un Reset los desconecta de verdad 20 s y vuelven). Cada uno trae una tarjeta RFID <PREFIJO>-TARJETA-nn. Máximo 10 por marca; si ya están todos devuelve 409. Se quitan con DELETE /api/brand/sandbox (askacharge_llamar_api). Úsalo para ensayar comandos y webhooks antes de tocar un cargador real.
countlocation_nameCrear un grupo de tarifa
Crea un grupo de tarifa y devuelve el grupo creado con su id. Rellena solo el precio del modo elegido: per_kwh usa price_per_kwh, per_hour usa price_per_hour, per_session usa price_per_session, combined suma los de kWh y hora, pvpc_margin suma pvpc_margin al PVPC (solo España), market_margin suma pvpc_margin al mercado diario de la zona de la marca (solo zonas con precio y marcas que cobran en EUR; si no, 400), tou cobra por franjas horarias que defines en periods (hora local de la marca; price_per_kwh es el precio de las horas sin franja), cost_plus suma pvpc_margin a lo que le cuesta la luz a la marca en cada momento (exige haberlo configurado) y free no cobra nada. Los modos que cambian con la hora cobran cada kWh a su precio. CUIDADO: con is_default en true, la que fuera tarifa por defecto deja de serlo. Para ver las que ya existen, askacharge_listar_tarifas.
namerequiredperiodsis_defaultpvpc_marginbilling_moderequiredprice_per_kwhprice_per_hourprice_per_sessionDar de alta un cliente
Da de alta un cliente y devuelve el creado con su id. NO comprueba duplicados: dos llamadas con el mismo email crean dos clientes, así que mira antes askacharge_listar_clientes. Si no le pasas tariff_group_id, el cliente hereda la tarifa por defecto de la marca. Para autorizarle una tarjeta física, después: askacharge_crear_tag_rfid.
namerequiredemailphonecompanyclient_typetariff_group_idAutorizar un tag RFID
Autoriza un tag RFID en la marca. Sin esto, la tarjeta no puede arrancar cargas. El id_tag es único dentro de la marca.
id_tagrequiredclient_iduser_nameLlamar a cualquier operación de la API
Llama a cualquier endpoint de la API de la marca, para lo que no cubran las herramientas anteriores. El contrato completo (456 operaciones) está en https://askacharge.com/askacharge/openapi.json. Los permisos se comprueban igual que en el resto: la clave necesita el scope de ese recurso. Solo valen rutas bajo /api/brand y /api/ext.
rutarequiredcuerpometodorequired100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
https://askacharge.com/askacharge/api/mcpAuthorization: Bearer ask_live_...claude mcp add --transport http askacharge https://askacharge.com/askacharge/api/mcp \ --header "Authorization: Bearer ask_live_..."{ "mcpServers": { "askacharge": { "type": "http", "url": "https://askacharge.com/askacharge/api/mcp", "headers": { "Authorization": "Bearer ask_live_..." } } }}curl -s -X POST https://askacharge.com/askacharge/api/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=askacharge"