Kpler agent skills for Claude Code, Cursor and RevampKey

5 ready-made playbooks that teach an AI agent how to do real Kpler work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Kpler

Connect Kpler once and all 5 skills install themselves and stay up to date. Mac, Windows and Linux.

All 5 Kpler skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereRead-only20 Kpler tools

Use Kpler data well and safely with AI

A guide for using the Kpler connector: confirming your account and access scope, picking the right tool family, and keeping large energy and commodity datasets manageable. Every tool here reads data only; the assistant asks before changing any account or workspace setting.

Use it when

You have just connected Kpler and want to check the right scope first
An answer comes back empty or blocked and you need to know why
You are not sure whether to use a vessel, flow, trade or fleet tool

Tools it uses

kpler_get_ais_latest
kpler_get_ais_historical
kpler_get_port_calls_v1
kpler_get_flows
kpler_get_trades
kpler_get_lng_diversions
kpler_get_compliance_screening
kpler_get_vessel_risks
kpler_get_arbitrage_products
kpler_get_arbitrage_regions
kpler_get_arbitrage_benchmarks
kpler_get_arbitrage_timeseries
kpler_get_arbitrage_timeseries_rolling
kpler_get_arbitrage_combinations
kpler_get_fleet_utilization_series
kpler_get_fleet_development_series
kpler_get_freight_fixtures
kpler_get_freight_metrics_series_alt
kpler_get_congestion_series
kpler_get_congestion_vessels

Example

Which Kpler tool should I use to see LNG cargo volumes to Asia last quarter, and keep it to a summary?

Use the flows tool for aggregated LNG volume to Asia over last quarter, which gives totals rather than thousands of trade records. I'll confirm your account and subscription covers LNG first, state volumes in one consistent unit, and report the period and any gap in the data. I'll only pull individual trades for the top destinations if you ask.

Use in RevampKeyRead the full skill →

Read-only8 Kpler tools

Analyse commodity arbitrage spreads with Kpler

Judges whether a commodity arbitrage between regions is open and how stable it has been, comparing benchmarks, regional spreads and rolling timeseries. It reads data only and changes nothing.

Use it when

You want to know if an LNG or crude arbitrage to a region is open.
You need to tell a persistent spread from a one-day spike.
You are comparing which route or region pays more on a net basis.

Tools it uses

kpler_get_arbitrage_products
kpler_get_arbitrage_regions
kpler_get_arbitrage_benchmarks
kpler_get_arbitrage_combinations
kpler_get_arbitrage_timeseries
kpler_get_arbitrage_timeseries_rolling
kpler_get_flows
kpler_get_trades

Example

Is the US Gulf to Asia LNG arbitrage open this month, and has it been stable?

The net spread from the Gulf to North-East Asia is 0.42 against a break-even of 0.35, a margin of 0.07, so it is open but thin. The rolling 14-day average is 0.38, which points to a steady rather than spiking spread. Two other routes are close behind, so the choice is not clear-cut.

Use in RevampKeyRead the full skill →

Read-only6 Kpler tools

Freight market and fleet utilisation brief

Summarises fixture rates, fleet utilisation and newbuild deliveries into a market brief that says whether capacity is tight or loosening. It works read-only and never changes data.

Use it when

You need a tanker or LNG freight market update for the last quarter.
You want to know whether idle capacity is building ahead of newbuild deliveries.
You are preparing a board note on whether freight rates are supported by utilisation.

Tools it uses

kpler_get_freight_fixtures
kpler_get_freight_metrics_series_alt
kpler_get_fleet_utilization_series
kpler_get_fleet_utilization_vessels
kpler_get_fleet_development_series
kpler_get_fleet_development_vessels

Example

Give me a freight market brief for crude tankers over the last 3 months: rates, fleet utilisation and newbuild pressure.

Crude tankers, last 3 months. Median fixture rate is up over the period, with 48 fixtures in the sample. Utilisation is high and rising, which agrees with the rate move. Deliveries are light in this window but 12 more land in the following quarter, so pressure is building. Read: tight for now, with loosening risk next quarter.

Use in RevampKeyRead the full skill →

Read-only7 Kpler tools

LNG flow and diversion review

Works out where LNG volumes moved between two periods, which cargoes were diverted, and whether congestion, fleet availability or price explains the shift. Read-only, so it changes nothing in your account.

Use it when

A destination's LNG imports fell sharply and you need to know where the cargoes went
You want to confirm which cargoes were diverted mid-voyage and why
A quarter's flow pattern changed and you need a cause you can defend

Tools it uses

kpler_get_flows
kpler_get_trades
kpler_get_lng_diversions
kpler_get_congestion_series
kpler_get_congestion_vessels
kpler_get_fleet_utilization_series
kpler_get_arbitrage_timeseries

Example

Why did LNG imports into Japan fall in Q2 compared with Q2 last year, and where did those cargoes go?

Japan's volume was down about 1.2 million tonnes against the baseline quarter. Most of the drop came from cargoes diverted to Europe during a congestion spike at two Japanese terminals. I checked 14 of the 18 diverted cargoes at cargo level and 11 of them show the change. Price spreads moved in the same direction, so price is a plausible second cause, but I have not confirmed it for the remaining cargoes.

Use in RevampKeyRead the full skill →

Read-only3 Kpler tools

Check a vessel's position and port activity with Kpler

Finds where a vessel was last reported, which ports it actually called at, and any gaps in its track over a period. It reports the timestamp of each position and says when data is missing rather than guessing.

Use it when

Verifying where a ship is or was reported
Confirming whether a vessel really called at a given port
Checking a vessel's movements and silent periods over a set timeframe

Tools it uses

kpler_get_ais_latest
kpler_get_port_calls_v1
kpler_get_ais_historical

Example

Did the tanker with IMO 9xxxxxx call at Ras Tanura in March, and where was it last reported?

Confirmed by IMO 9xxxxxx. Last reported position was 14 hours ago, off Ras Tanura, so treat it as last-known, not current. The port call record shows one call at Ras Tanura from 3 to 5 March, with a 6 day gap before the next call. The track has a 2 day dark gap in that gap, so its movements there are unknown.

Use in RevampKeyRead the full skill →

Get all 5 without copying a file

RevampKey adds the skills when you connect Kpler, updates them for you and removes them when you disconnect.

Download RevampKey

How Kpler skills work

Connect Kpler
The Kpler MCP server gives the agent its tools.
Ask in plain words
“Is the US Gulf to Asia LNG arbitrage open this month, and has it been stable?” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Kpler skills

In RevampKey the skills install themselves when you connect Kpler. In other tools each skill is one folder with a SKILL.md file, and you also need the Kpler MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Kpler. All 5 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Is the US Gulf to Asia LNG arbitrage open this month, and has it been stable?”
Download RevampKeyConnect Kpler · 1 click
Get RevampKey to connect Kpler
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Kpler is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials arbitrage-spread-analysis freight-market-and-fleet-utilisation-brief lng-flow-and-diversion-review vessel-position-and-port-activity-check; do curl -fsSL --create-dirs -o .claude/skills/kpler-$s/SKILL.md https://revampkey.com/marketplace/kpler/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Kpler MCP server in Claude Code.

Run this in your project folder to add all 5 skills:

for s in essentials arbitrage-spread-analysis freight-market-and-fleet-utilisation-brief lng-flow-and-diversion-review vessel-position-and-port-activity-check; do
  curl -fsSL --create-dirs -o .claude/skills/kpler-$s/SKILL.md https://revampkey.com/marketplace/kpler/skills/$s/SKILL.md
done

Ask in plain language, for example “Is the US Gulf to Asia LNG arbitrage open this month, and has it been stable?”

Into the shared .agents/skills folder

Connect the Kpler MCP server in Cursor.

Run this in your project folder to add all 5 skills:

for s in essentials arbitrage-spread-analysis freight-market-and-fleet-utilisation-brief lng-flow-and-diversion-review vessel-position-and-port-activity-check; do
  curl -fsSL --create-dirs -o .agents/skills/kpler-$s/SKILL.md https://revampkey.com/marketplace/kpler/skills/$s/SKILL.md
done

Ask in plain language, for example “Is the US Gulf to Asia LNG arbitrage open this month, and has it been stable?”

Into the shared .agents/skills folder

Connect the Kpler MCP server in Codex.

Run this in your project folder to add all 5 skills:

for s in essentials arbitrage-spread-analysis freight-market-and-fleet-utilisation-brief lng-flow-and-diversion-review vessel-position-and-port-activity-check; do
  curl -fsSL --create-dirs -o .agents/skills/kpler-$s/SKILL.md https://revampkey.com/marketplace/kpler/skills/$s/SKILL.md
done

Ask in plain language, for example “Is the US Gulf to Asia LNG arbitrage open this month, and has it been stable?”

Into the shared .agents/skills folder

Connect the Kpler MCP server in VS Code.

Run this in your project folder to add all 5 skills:

for s in essentials arbitrage-spread-analysis freight-market-and-fleet-utilisation-brief lng-flow-and-diversion-review vessel-position-and-port-activity-check; do
  curl -fsSL --create-dirs -o .agents/skills/kpler-$s/SKILL.md https://revampkey.com/marketplace/kpler/skills/$s/SKILL.md
done

Ask in plain language, for example “Is the US Gulf to Asia LNG arbitrage open this month, and has it been stable?”

RevampKey or copy the files?

In RevampKey

One click when you connect Kpler
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Kpler MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Kpler skills FAQ

What is a Kpler agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each Kpler skill describes one job, which Kpler tools to use in which order, what to check first and when to stop and ask you.

Do the Kpler skills change anything on their own?

5 of the 5 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Kpler.

Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect Kpler; elsewhere you copy the folders into your project or skills directory.

Do I need the Kpler MCP server too?

Yes. The skills tell the agent how to do the work; the Kpler MCP server gives it the tools to do it. The Kpler MCP setup guide covers every client.

Kpler MCP server setup · This page as Markdown

Put Kpler’s best workflows in your agent

Download RevampKey, connect Kpler and ask your first question in about a minute.

Download RevampKey Connect Kpler · 1 click

All 5 Kpler skills

Use Kpler data well and safely with AI

Use it when

Tools it uses

Analyse commodity arbitrage spreads with Kpler

Use it when

Tools it uses

Freight market and fleet utilisation brief

Use it when

Tools it uses

LNG flow and diversion review

Use it when

Tools it uses

Check a vessel's position and port activity with Kpler

Use it when

Tools it uses

Get all 5 without copying a file

How Kpler skills work

How to install Kpler skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Kpler skills FAQ

Put Kpler’s best workflows in your agent

Skills for related tools