Skip to content
عربي

Connector for AI assistants

Use Renewable Vision’s data inside Claude, ChatGPT and Microsoft Copilot.

Add one address to the AI assistant you already use, then ask it about energy and data-centre projects in Saudi Arabia, the Gulf and the wider region. It answers from our trackers, and every figure comes back with its source and the date it is true as of.

The endpoint

One address for every assistant.

It speaks Streamable HTTP, the transport every client below supports. A client that runs only local servers can bridge to it.

Endpoint

https://renewablevision.com.sa/api/mcp

No account is needed for most tools. Add your free key as a header to use the members-only tools under your own daily allowance.

What it is

Our trackers, read by your assistant.

A Model Context Protocol (MCP) server. MCP is the open standard that Claude, ChatGPT, Microsoft Copilot Studio, Cursor and many other AI tools use to read outside data. This one is read-only: your assistant looks things up, and nothing it does changes any data.

13 trackers and registers
Saudi, captive, GCC and regional renewables; Saudi battery storage; Saudi, GCC and regional data centres; carbon capture; the IEA hydrogen map; and the Saudi water, AI and dedicated-systems registers.
Beyond projects
Official registers mirrored weekly, statistical series from their publishers, the change ledger, the weekly brief, the report library, company profiles, and the power balance and oil models.
The same numbers as our assistant
Counts and totals come from the same engine as the assistant on this site, so a figure in Claude or Copilot matches the one the site’s assistant gives for the same question.
Cited by design
Every result names its publisher, the date its figures are true as of, and the page to cite. A modelled figure says it is modelled.

28 tools in all, each described for the assistant that has to choose one.

Examples

Three questions, and what comes back.

Ask in your own words in any of the assistants on this page. The answers here are read live from the data each time the page is built; your assistant writes its reply from the same fields.

You ask

“How much renewable capacity is under construction in each GCC country?”

The assistant calls

aggregate_projects({"place":"gcc","sector":"renewables","stage":"construction","groupBy":"country","measure":"capacity"})

What comes back

Capacity by country in MW as each source states it, the projects counted and those left out and why, the method in words, the trackers it rests on and the date the newest row was read.

CountryCapacity (MW)
Saudi Arabia33,550
United Arab Emirates10,000
Oman848
Bahrain100

44,498 MW counted over 34 projects. 0 matching projects not counted (no figure in the unit).

As of: 29 September 2026 · Sources: GCC Renewables Tracker, Saudi Renewables Tracker

You ask

“What do you know about Stargate UAE, and where does it come from?”

The assistant calls

get_project({"id":"stargate-uae"})

What comes back

The project’s capacity and what the figure covers, its stage in the source’s own words, its place, the companies behind it, and every release it was compiled from with its date.

Stargate UAE (1 GW AI compute cluster)

Capacity
1,000 MWFull cluster plan (1 GW compute cluster); the first 200 MW phase is expected to go live in 2026
Stage
Construction
Place
Abu Dhabi, United Arab Emirates
Companies
G42 (Khazna Data Centers), OpenAI, Oracle, NVIDIA, Cisco, SoftBank Group
Compiled from
5 publications, each with its dateG42G42 via PR Newswire

As of: November 2026 · Sources: Renewable Vision — GCC Data Centre Tracker

You ask

“Which countries in the Regional Renewables Tracker have the most capacity in operation?”

The assistant calls

aggregate_projects({"tracker":"regional-renewables","stage":"operational","groupBy":"country","measure":"capacity"})

What comes back

Operating capacity by country from the tracker of the Middle East beyond the Gulf, Africa, the Caucasus, Central Asia and South and Southeast Asia, with the same counting rules and sources.

CountryCapacity (MW)
India9,285
Egypt5,534.5
Uzbekistan3,747
Morocco3,039.7
Pakistan2,418

33,539.5 MW counted over 159 projects. 0 matching projects not counted (no figure in the unit).

As of: 12 November 2026 · Sources: Regional Renewables Tracker

Setup

Set it up in your assistant.

The steps as each vendor documents them in November 2026. Menus move, so each client links to the vendor’s own page.

Claude, on the web and in Claude Desktop

  1. Open Customize, then Connectors.
  2. Select + Add, then Add custom connector.
  3. Name it Renewable Vision, paste the endpoint and select Continue.
  4. Under Authentication, choose No sign in.
  5. To use your key, add a request header named Authorization with the value Bearer followed by your key.
  6. Select Add. The connector then works in Claude on the web and in Claude Desktop.

The Free plan allows one custom connector. On Team and Enterprise plans an owner adds it under Organization settings, Connectors, and each member then connects it.

Vendor documentation: Anthropic: custom connectors using remote MCP

ChatGPT

  1. In ChatGPT on the web, open Plugins.
  2. Select +, then Add custom MCP server.
  3. Give it a name and a short description. Under Connection, choose a public endpoint and paste the address.
  4. Under Authentication, choose No authentication.
  5. Read the risk warning, confirm it, and select Create as a plugin. Review the tools it lists, then install it.

ChatGPT’s form offers OAuth or no authentication, not an API key header, so in ChatGPT the keyless tools answer and the members-only ones reply with how to join. Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace’s settings; in a company workspace an admin may need to add it. ChatGPT asks you to confirm tools that write; every tool here is marked read-only.

Custom GPTs reach outside data through Actions, which read an OpenAPI document rather than MCP. Ours is published with the developer reference. /api/openapi.json

Vendor documentation: OpenAI: add a custom MCP server

Microsoft Copilot Studio

  1. Turn on generative orchestration for your agent; Copilot Studio needs it for MCP.
  2. On the agent’s Tools page, select Add a tool, then New tool, then Model Context Protocol.
  3. Enter a server name, a description (the agent reads it to decide when to call the server) and the endpoint.
  4. For authentication choose None. To use keys, choose API key, type Header, header name X-API-Key; each person using the agent enters their own key.
  5. Select Create. On Add tool, create a new connection and select Add to agent.

Copilot Studio supports the Streamable HTTP transport, which this endpoint uses.

Vendor documentation: Microsoft Learn: connect an agent to an existing MCP server

Microsoft 365 Copilot

Developers can add the endpoint to a declarative agent with Microsoft 365 Agents Toolkit 6.12 or later: Create a New Agent/App, Declarative Agent, Add an Action, Start with an MCP Server, paste the address and choose None for authentication. The agent finds the tools when it runs; you can instead pin the few it needs, such as aggregate_projects, get_project and tracker_summary.

Vendor documentation: Microsoft Learn: a declarative agent plugin from an MCP server

Claude Code

One command, with your key or without the header:

claude mcp add --transport http renewable-vision \
  https://renewablevision.com.sa/api/mcp \
  --header "Authorization: Bearer rv_live_…"

Vendor documentation: Claude Code: connect to tools via MCP

Cursor

Add it to ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one:

{
  "mcpServers": {
    "renewable-vision": {
      "url": "https://renewablevision.com.sa/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:RV_API_KEY}"
      }
    }
  }
}

Vendor documentation: Cursor: Model Context Protocol

Other MCP clients

Any client that takes a remote MCP server over Streamable HTTP needs only the address, plus a header for your key. A client that runs only local servers can bridge with mcp-remote:

npx -y mcp-remote https://renewablevision.com.sa/api/mcp

Keys

How keys work.

A key is free with membership. It opens the members-only tools and counts your assistant’s calls against your own allowance instead of your address.

Without a key
Every tool except the members-only ones, counted per address: 300 requests in 10 minutes.
With a free member key
Every tool, counted against your key: 5,000 requests a day. One conversation is several requests: connecting, listing the tools, then one call per question.
Getting one
Join free, then issue a key on your account’s API keys page. Keys start rv_live_, you can hold up to 5 at once, and you can revoke any of them.
Sending it
As Authorization: Bearer followed by the key, or as an X-API-Key header. A bearer token that does not start rv_ is ignored, so another credential in your client is never refused because of it.
Authorization: Bearer rv_live_…
X-API-Key: rv_live_…

Free and paid

What is free, and what is for members.

The same rules as the rest of the site’s data: the Energy Atlas and the project rows are free with membership, and commercial use is licensed.

CallerWhat the assistant can readAllowance
Anyone, no keyThe catalogue, the official registers, the statistical series, the change ledger, the weekly brief, the report library, company profiles, the power balance and the oil and fleet models; counts and totals over every tracker; tracker summaries; one project’s facts and sources; the carbon-capture and hydrogen rows.300 requests in 10 minutes per address
Free member keyAll of that, plus the project rows of the Energy Atlas and the project index (find_projects, and search_projects over the Saudi, captive, GCC, regional and data-centre trackers), the GCC country series, and the modelled output of every project.5,000 requests a day
Licensed key (paid)The same tools under a data licence that covers commercial use or redistribution, each with its own scope and attribution.50,000 requests a day

Renewable Vision’s own compilations are CC BY-NC 4.0 unless a licence says otherwise, and third-party series keep their publishers’ licences. A licence cannot override an upstream licence.

Join free · Request a data licence

Sources

The source and as-of rule.

An assistant restates a figure where we cannot annotate it, so the provenance travels inside every result.

  1. source: who published the figures, and the page they publish them on.
  2. asOf: the date the figures are true as of, at the precision the source gives it: a day, a month or a year, never narrower.
  3. citation: the public page to cite. A reply in Arabic can swap /en for /ar.
  4. note: present when a figure is modelled or indicative rather than observed.
  5. Capacity is added only within one family of units: MWh is never added to MW, and heat is never added to electricity. Every total says how many projects it left out and why.

The server also offers a prompt, saudi-energy-briefing, that tells the assistant to state figures only from tool results and to close with a line of sources and their dates.