MCP server
The same data as the API, for AI assistants. Connect Claude, ChatGPT, Cursor or any Model Context Protocol client and ask in plain language.
What it is
A Model Context Protocol (MCP) server at https://api.holgura.dev/mcp. Your assistant discovers the tools, calls them when you ask about access capacity and gets the official data with its source and date.
It is read-only: it cannot change anything in your account. Every answer carries the attribution (REE, CNMC), the date of the mirrored publication and the legal notice, so the assistant can cite where each figure comes from.
Try asking
- Which transmission nodes in Sevilla still have demand capacity, and how much?
- Where was capacity freed in Red Eléctrica's latest publication?
- How has ABADES 400 changed over the last months? Has it been saturated?
- Find transmission nodes where generation is saturated but storage injection still has capacity (the BESS screen), sorted by available MW.
- Which 400 kV nodes released more than 50 MW in the last three months, counting only changes from a published value?
- Which nodes in Andalucía went from saturated to available since September, and what was the largest release?
Connect
Server address: https://api.holgura.dev/mcp
Without a key it works with the anonymous limit and the last 3 months of history. With a free key (console → API keys) the assistant uses your plan's limits: send it in the Authorization: Bearer header.
With your account, in one click: when you add the connector in Claude or ChatGPT choose “Sign in”, log in to Holgura and authorise. The assistant then uses your plan's limits with no key to paste.
Claude (web and desktop): Settings → Connectors → Add custom connector, paste the server address and choose “No sign-in” or “Sign in”.
ChatGPT, Cursor, VS Code and other clients: add a remote (HTTP) MCP server with the same address.
# sin clave / without a key (anonymous limits)
claude mcp add --transport http holgura https://api.holgura.dev/mcp
# con tu clave / with your key (the limits of your plan)
claude mcp add --transport http holgura https://api.holgura.dev/mcp \
--header "Authorization: Bearer hg_live_…"Tools
Nine read-only tools. The descriptions the assistant sees explain when to use each one.
| search_nodes | Find nodes by name, province, region, network, operator, voltage, status or minimum MW; sort by available capacity. |
| get_node | Everything about one node: current capacity per metric with its source and date, official columns, notes, saturation, history and latest changes. |
| get_node_history | Month-by-month series of a node's available capacity, one point per official publication. |
| list_changes | Changes between publications: liberations, saturations, increases and decreases, filtered by kind, metric, province, network and period. |
| list_access_requests | Demand access requests received by REE at transmission nodes: who is asking for capacity, how much, until when others may compete and whether the node goes to a tender. |
| list_notices | BOE notices about electricity infrastructure and grid access: authorisations, public information, environmental impact, public utility, tenders and regulation, by node, province or topic. |
| get_overview | The national picture: nodes by status and network, and what moved in the latest publication. |
| list_sources | The official sources with their latest publication and the dictionary of metrics, statuses and change kinds. |
One call
The protocol is JSON-RPC over HTTPS (revision 2026-07-28, no sessions; clients of earlier revisions are served too). Every result carries the structured data and its text copy.
curl -s https://api.holgura.dev/mcp \
-H "Content-Type: application/json" \
-H "MCP-Protocol-Version: 2026-07-28" \
-H "Mcp-Method: tools/call" -H "Mcp-Name: search_nodes" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28",
"io.modelcontextprotocol/clientCapabilities":{}},
"name":"search_nodes",
"arguments":{"province":"Sevilla","status":"AVAILABLE","sort":"mw_desc","limit":5}}}'{
"jsonrpc": "2.0",
"id": 1,
"result": {
"resultType": "complete",
"isError": false,
"content": [{ "type": "text", "text": "{ …the same JSON as structuredContent… }" }],
"structuredContent": {
"meta": {
"timestamp_consult": "2026-11-12T09:00:00Z",
"source_data_mirror_date": "2026-11-03",
"disclaimer": "…",
"attribution": ["Red Eléctrica de España (REE) — …", "CNMC — …"],
"plan": "anonymous",
"history_months": 3
},
"data": [
{ "code": "ES-REE-DOSHERMANAS400", "name": "DOS HERMANAS 400", "network": "transmission",
"province": "Sevilla", "capacity": { "demand_available_mw": 212, "generation_available_mw": null } }
],
"page": { "limit": 5, "total": 14, "next_cursor": "5" }
}
}
}How to read the data
- null means the publisher gave no value; it is not zero. A 0 is a published zero (the node is saturated for that metric).
- The capacities are informative and not summable: the server never adds different metrics, nor REE and CNMC figures for the same node, and asks the assistant not to either.
- Holgura certifies that the mirror matches the official file, not that capacity will be granted. This is not investment advice.
Limits
One quota, two doors: each tool call counts as one request of your plan's monthly quota, shared with the REST API. Discovering the server and listing its tools is free.
- Without a key: 10 calls per minute per address and the last 3 months of history.
- With a key: your plan's limits. Create a free key
| Free | Pro | Team | Enterprise | |
|---|---|---|---|---|
| Requests/month | 500 | 50,000 | 500,000 | Unlimited |
| Requests/min | 10 | 60 | 300 | 1,200 |
| MCP server (AI assistants) | Yes | Yes | Yes | Yes |
| History | 3 months | Full | Full | Full |
| Watchlists | 3 | Unlimited | Unlimited | Unlimited |
| Alert rules | 1 | 25 | 100 | Unlimited |
| Webhooks | No | 3 | 10 | Unlimited |
| Team | 1 | 3 | 10 | Unlimited |
| CSV export | No | Yes | Yes | Yes |