Three ways to
integrate Bulugo

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

🧠
MCP Server
30 seconds
🐾
OpenClaw Skill
One command
⚡
REST API
Full control
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. That's it. No SDK, no code, no deployment. Your AI can now check prices, find suppliers, and request quotes through natural conversation.

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

Available tools:

  • →get_bunker_prices — Live and historical pricing across all ports
  • →search_ports — Find ports by region, fuel type, supplier count
  • →request_quote — Submit quote requests and track responses
  • →get_suppliers — Supplier directory with coverage and ratings
  • →market_overview — Aggregated trends, alerts, and intelligence
claude_desktop_config.json
{
  "mcpServers": {
    "bulugo": {
      "url": "https://api.bulugo.com/mcp",
      "headers": {
        "Authorization": "Bearer bul_live_sk_..."
      }
    }
  }
}
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 bul_live_sk_...

# 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 ClewHub 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 12 key ports. VLSFO, HSFO, MGO, LSMGO — all fuel grades covered.

🌍

Port Data

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

⚡

Quote Engine

Programmatic quote requests and responses via REST or WebSocket. 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://api.bulugo.com/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://api.bulugo.com/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://api.bulugo.com/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"
}
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. Generate keys from your dashboard, rotate anytime, and set granular scopes per key.

  • 1Sign up and request API access
  • 2Generate an API key from your dashboard
  • 3Include the key in your Authorization header
  • 4Set scopes: read-only, quotes, or full access
authentication
# All requests use Bearer auth
curl "https://api.bulugo.com/v1/prices" \
  -H "Authorization: Bearer bul_live_sk_..."

# API keys have scopes
# bul_live_sk_... → production key
# bul_test_sk_... → sandbox key

# OpenAPI spec available at:
# https://api.bulugo.com/v1/openapi.json

# Interactive docs (Swagger UI):
# https://api.bulugo.com/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 →