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 read the MCP resources first, ask the human for missing details, then prepare the right buyer or supplier setup path.

Buyer setup prompt

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

copy into your AI
You are helping me set up Bulugo as a marine fuel buyer.

Start by reading these MCP resources if Bulugo MCP is connected:
- bulugo://guide/buyer-onboarding.md
- bulugo://guide/channel-verification.md
- bulugo://schema/quote-request.json

If MCP is not connected yet, guide me to https://preview.bulugo.com/platform#mcp and explain how to connect Claude, ChatGPT, OpenClaw or my internal agent.

Ask me for:
1. company name and my role
2. usual ports, routes and delivery windows
3. fuel grades and typical volumes
4. preferred channel: WhatsApp, Telegram, email, API or AI assistant
5. whether I want price alerts, route planning or immediate quotes

Then help me:
1. create or verify my buyer profile
2. bind my preferred chat channel for human confirmation
3. prepare a quote request only when I approve the details
4. request a scoped API key only if automation is needed

Do not submit commercially sensitive details to Bulugo until I explicitly confirm them.

Supplier setup prompt

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

copy into your AI
You are helping me set up Bulugo as a bunker fuel supplier.

Start by reading these MCP resources if Bulugo MCP is connected:
- bulugo://guide/supplier-onboarding.md
- bulugo://guide/pricing-data-contribution.md
- bulugo://schema/supplier-coverage.json

If MCP is not connected yet, guide me to https://preview.bulugo.com/platform#mcp and explain how to connect Claude, ChatGPT, OpenClaw or my internal agent.

Ask me for:
1. company name and supplier contact
2. ports served, products supplied and delivery methods
3. preferred lead channel: WhatsApp, Telegram, email, API or AI assistant
4. whether pricing can be shared by spreadsheet, email, API or agent
5. available compliance or verification documents

Then help me:
1. register or update the supplier profile
2. define port and product coverage
3. connect the lead delivery channel
4. choose a pricing data contribution method
5. request a scoped API key for automated sync if needed

Explain that fresher pricing and availability data improves buyer confidence and lead quality.

MCP resources your agent should read

Once Bulugo MCP is connected, ask the agent to call resources/list, then resources/read for the guide that matches your role before it calls any tools.

bulugo://guide/buyer-onboarding.mdbulugo://guide/supplier-onboarding.mdbulugo://guide/channel-verification.mdbulugo://guide/pricing-data-contribution.mdbulugo://schema/quote-request.jsonbulugo://schema/supplier-coverage.json

Claude

Copy the MCP endpoint, add the bearer token from Developer Settings, then ask Claude to read the buyer or supplier guide.

ChatGPT

Use the MCP endpoint as a connector or custom action source, with the API key from the web portal.

OpenClaw

Install the Bulugo skill, add the scoped API key, then let the agent bind WhatsApp or Telegram.

API keys

Sign in to the Bulugo web portal, open Developer Settings, generate a key, then paste it into your MCP or API client.

Ask the human first

Confirm role, company, ports, fuel grades, channels and permission before submitting anything.

Use scoped keys

Start read-only for prices and ports. Add quote or supplier scopes only when the workflow needs them.

Bind chat channels

WhatsApp and Telegram stay first-class channels for confirmation, quote updates and verification.

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

  1. Sign in or create a Bulugo account.
  2. Open Developer Settings in the web portal.
  3. Generate an API key for the workflow you want to connect.
  4. Add the key as a bearer token in your MCP client.
  5. Ask your agent to run resources/list, read the buyer or supplier guide, 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://leads.bulugo.com/mcp",
      "headers": {
        "Authorization": "Bearer blg_..."
      }
    }
  }
}
Get API key in portalCreate 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://leads.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://leads.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://leads.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://leads.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://leads.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://leads.bulugo.com/api-docs/openapi.json

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