Three ways to
integrate Bulugo

From zero-code AI integration to full programmatic control. Pick the path that fits your workflow.

Use your AI

Copy a prompt

MCP Server

30 seconds

REST API

Full control

Use Your AI

Let your assistant set up Bulugo

Give Claude, ChatGPT, Codex, OpenClaw or your internal agent a role-specific prompt. It should ask how you want to set up, use the safer agent signup flow when you choose it, read MCP resources first, then prepare the right buyer or supplier path.

Agent-assisted setup

Ask your AI to read Bulugo setup instructions, create a pending signup only after you consent, verify by email code/link/status, then configure MCP for you.

Manual setup

Sign in, open Developer Settings, create a key, and add https://my.bulugo.com/v1/mcp to your MCP client with a bearer token.

Already have a key

Have the agent store your existing key in local MCP config, connect, run resources/list, read the onboarding guide, and call whoami before doing commercial work.

Buyer setup prompt

For vessel operators, traders and procurement teams who want fuel quotes, route planning or price alerts.

Prompt collapsed. Expand to review the full text, or copy it directly.

Supplier setup prompt

For bunker suppliers who want better matched leads, connected channels and a clean way to share pricing signals.

Prompt collapsed. Expand to review the full text, or copy it directly.

MCP resources your agent should read

Once Bulugo MCP is connected, ask the agent to call resources/list, read bulugo://guide/agent-onboarding.md, then read the buyer or supplier workflow before it calls any commercial tools.

bulugo://guide/agent-onboarding.mdbulugo://guide/buyer-workflow.mdbulugo://guide/supplier-workflow.mdbulugo://guide/listing-rubric.mdbulugo://schema/quote-request.jsonbulugo://schema/supplier-coverage.json

Claude

Use the agent-assisted prompt or add the MCP endpoint with the bearer token from Developer Settings.

ChatGPT

Use the MCP endpoint as a connector/custom action source, then ask it to read Bulugo resources before using tools.

OpenClaw

Install the Bulugo skill or let the agent follow the existing agent signup flow, then store the returned credential locally.

API keys

Ask consent first

Create a pending signup or submit commercial data only after the human explicitly agrees.

Keep credentials local

Store returned API keys or existing bearer tokens in the MCP/client config. Treat them as secrets.

Use live resources

After connection, run resources/list and read Bulugo guides before calling quote, buyer or supplier tools.

Fastest Integration

MCP Server - talk to Bulugo through your AI

Connect any MCP-compatible AI client. Zero code, just config. Your assistant becomes a bunker fuel expert.

Up and running in 30 seconds

Add Bulugo to your AI assistant's MCP configuration. Your AI can now check prices, find suppliers, and request quotes through natural conversation.

Works with Claude Desktop, ChatGPT, Cursor, Windsurf, OpenClaw, and any MCP-compatible client.

Setup steps

Sign in or create a Bulugo account.
Open Developer Settings in the web portal.
Generate an API key for the workflow you want to connect. If you already have one, reuse it or rotate it from here.
Add the key as a bearer token in your MCP client.
Ask your agent to run resources/list, read bulugo://guide/agent-onboarding.md and the buyer or supplier workflow, then call whoami to confirm the connection.

Available tools:

→get_bunker_prices - Live and historical pricing across 308 ports
→search_ports - Find ports by region, fuel type, supplier count
→plan_route - Calculate cheapest bunkering stops on a voyage
→search_lubricants - Browse 1,718 marine lubricant products
→request_quote - Submit quote requests and track responses
→get_suppliers - Supplier directory with coverage and ratings
→market_overview - Aggregated trends, alerts, and intelligence

mcp config

{
  "mcpServers": {
    "bulugo": {
      "url": "https://my.bulugo.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer blg_..."
      }
    }
  }
}

Get API key in portal Create account

conversation

You: What's VLSFO in Singapore right now?

Claude: Let me check.

  → get_bunker_prices(port: "SGSIN", fuel: "VLSFO")

VLSFO in Singapore is $628.50/MT - down $3.60
from the 30-day average. Prices have been
trending down all week.

Want me to get quotes from suppliers there?

Claude

Native MCP support in Claude Desktop and API

ChatGPT

Via custom GPT or plugin configuration

Cursor & IDEs

MCP tools in your development workflow

AI-Native Integration

OpenClaw Skill - your AI becomes a fuel trader

Install in one command. Your AI assistant monitors prices, manages quotes, and alerts you to opportunities - automatically.

terminal

# Install the Bulugo skill
openclaw skill install bulugo

# Configure your API key
openclaw config set bulugo.api_key blg_...

# Set your watched ports and fuels
openclaw config set bulugo.ports "SGSIN,NLRTM,AEJEA"
openclaw config set bulugo.fuels "VLSFO,MGO"

# That's it. Your AI now:
# - Monitors prices on your ports
# - Alerts you to significant moves
# - Manages quote requests via chat
# - Sends weekly market summaries

your AI, proactively

Bulugo Price Alert

VLSFO in Rotterdam dropped 4.2% overnight
($645 → $618/MT). This is the lowest price
in 3 weeks.

You have a delivery window March 25-31 for
500MT VLSFO at Rotterdam. Current market
conditions look favourable.

Shall I get quotes from suppliers now?

More than an API wrapper

The OpenClaw skill isn't just tools - it's context. It knows your ports, your fuel types, your delivery schedules. It monitors the market and reaches out when something matters.

Price Monitoring

Watches your ports and fuels. Alerts you when prices move beyond your thresholds.

Quote Management

Request quotes, compare responses, and manage supplier conversations - all through chat.

Proactive Alerts

"VLSFO dropped 4% in Singapore overnight - want me to get quotes?" Your AI thinks ahead.

Market Intelligence

Weekly summaries, trend analysis, and procurement recommendations based on your history.

Browse ClawHub Skills →

Full Programmatic Access

REST API - build it your way

Simple JSON endpoints for bunker prices, port data, and the quote engine. Build your own procurement tools.

Bunker Prices

Historical and live bunker fuel prices across 308 ports. VLSFO, HSFO, MGO, LSMGO - all fuel grades covered.

Port Data

14,904 ports with supplier availability, fuel types, delivery methods, and operational details.

Route Planning

Calculate optimal bunkering stops on any voyage route. Returns ports with live pricing, sorted by cost.

Lubricant Search

1,718 marine lubricant products searchable by brand, category, viscosity grade, and application.

Quote Engine

Programmatic quote requests and responses via REST. Build your own procurement interface.

GET /v1/prices

Fetch bunker prices

Get current and historical bunker fuel prices for any supported port. Filter by fuel type, date range, and delivery method.

Returns spot prices, 30-day averages, and price trends - updated every 15 minutes for live ports.

terminal

# Get VLSFO prices in Singapore
curl "https://my.bulugo.com/api/v1/prices?port=SGSIN&fuel=VLSFO" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response
{
  "port": "SGSIN",
  "fuel": "VLSFO",
  "price": 628.50,
  "currency": "USD",
  "unit": "MT",
  "avg_30d": 632.10,
  "trend": "down",
  "updated_at": "2026-02-17T10:45:00Z"
}

terminal

# Search ports with VLSFO availability
curl "https://my.bulugo.com/api/v1/ports?fuel=VLSFO&region=asia" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response
{
  "total": 847,
  "ports": [
    {
      "code": "SGSIN",
      "name": "Singapore",
      "suppliers": 34,
      "fuels": ["VLSFO", "HSFO", "MGO"],
      "live_pricing": true
    }
  ]
}

GET /v1/ports

Search port data

Query our database of 14,904 ports. Filter by region, fuel availability, supplier count, and delivery capabilities.

Each port includes supplier count, available fuel types, and whether live pricing is available.

POST /v1/quotes

Request a quote

Submit a programmatic quote request. Our matching engine returns competitive quotes - typically in under 60 seconds.

Subscribe to WebSocket events for real-time updates as suppliers respond.

terminal

# Request a quote
curl -X POST "https://my.bulugo.com/api/v1/quotes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "port": "SGSIN",
    "fuel": "VLSFO",
    "quantity_mt": 500,
    "delivery_start": "2026-03-25",
    "delivery_end": "2026-03-31"
  }'

# Response
{
  "quote_id": "qt_8f3k2m9x",
  "status": "matching",
  "suppliers_contacted": 8,
  "ws_channel": "quotes.qt_8f3k2m9x"
}

terminal

# Plan a route with bunkering stops
curl -X POST "https://my.bulugo.com/api/v1/route/plan" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "waypoints": ["SGSIN", "AEJEA", "NLRTM"],
    "fuel": "VLSFO",
    "quantity_mt": 500
  }'

# Response
{
  "route": "SGSIN → AEJEA → NLRTM",
  "stops": [
    { "port": "SGSIN", "price": 625.00 },
    { "port": "AEJEA", "price": 618.50 },
    { "port": "NLRTM", "price": 641.20 }
  ],
  "cheapest": "AEJEA",
  "savings_vs_destination": "$22.70/MT"
}

POST /v1/route/plan

Plan a bunkering route

Submit waypoints and get back every bunkering port on the route with live pricing. Identify the cheapest stop before your vessel departs.

Supports multi-fuel queries and alternative route suggestions.

Rate Limits

Built for scale

Generous limits on every tier. Need more? We'll work with you.

Free

100

requests / day

Prices & ports only

Pro

10K

requests / day

All endpoints + WebSocket

Enterprise

∞

custom limits

Dedicated infrastructure

Authentication

Simple bearer token auth

All API and MCP requests use bearer tokens. The key is created inside the Bulugo web portal, not on this marketing page.

Sign in or create an account, then open Developer Settings. From there you can generate keys, revoke old keys and copy the quick-start MCP or REST examples.

1Sign in or create an account
2Open Dashboard then Developer Settings
3Generate an API key for the workflow you want to connect
4Paste the key into your MCP config or Authorization header
5Use the Usage page to monitor calls and rotate keys if needed

authentication

# All requests use Bearer auth
curl "https://my.bulugo.com/api/v1/prices" \
  -H "Authorization: Bearer blg_..."

# API keys have scopes
# blg_... production key
# generate keys from Developer Settings

# OpenAPI spec available at:
# https://my.bulugo.com/api-docs/openapi.json

# Interactive docs (Swagger UI):
# https://my.bulugo.com/api-docs

Get Started

Start integrating today

Free tier includes MCP access, 100 API calls per day, and the OpenClaw skill. No credit card required.

Browse Skills →

Three ways tointegrate Bulugo

Let your assistant set up Bulugo

Agent-assisted setup

Manual setup

Already have a key

Buyer setup prompt

Supplier setup prompt

MCP resources your agent should read

Claude

ChatGPT

OpenClaw

API keys

Ask consent first

Keep credentials local

Use live resources

MCP Server - talk to Bulugo through your AI

Up and running in 30 seconds

Setup steps

Available tools:

Claude

ChatGPT

Cursor & IDEs

OpenClaw Skill - your AI becomes a fuel trader

More than an API wrapper

Price Monitoring

Quote Management

Proactive Alerts

Market Intelligence

REST API - build it your way

Bunker Prices

Port Data

Route Planning

Lubricant Search

Quote Engine

Fetch bunker prices

Search port data

Request a quote

Plan a bunkering route

Built for scale

Free

Pro

Enterprise

Simple bearer token auth

Start integrating today

Three ways to
integrate Bulugo