Three ways to
integrate Bulugo

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

Comparing bunker procurement platforms first? Start with the marine fuel procurement platform guide, then use this page when you are ready for AI, MCP or API integration.

Use your AI

Copy a prompt

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 - Latest available local market prices for covered ports
→search_ports - Find ports by region and catalogue data
→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, route planning, and the quote engine. Build your own procurement tools.

Bunker fuel pricing data access

Get your API key

Create a bearer token in Developer Settings

1. Sign in or create an account in the Bulugo portal.
2. Open Dashboard, then Developer Settings.
3. Generate and name an API key for the workflow you want to connect.
4. Copy it once, store it securely, and never paste the full key into WhatsApp or support chat.
5. Send it on API requests as Authorization: Bearer <API_KEY>.
6. Revoke old keys in Developer Settings, create a replacement key before retiring one, and monitor calls on the Usage page.

Developer Settings Interactive docs OpenAPI JSON

first-call example

# First call: list active ports in Singapore
curl "https://my.bulugo.com/api/v1/ports?country=SG" \
  -H "Authorization: Bearer <API_KEY>"

# Example shape
{
  "count": 1,
  "ports": [
    {
      "name": "Singapore",
      "latitude": 1.2594,
      "longitude": 103.7544,
      "region": "Asia",
      "country": "Singapore",
      "country_code": "SG"
    }
  ]
}

Bunker Prices

Latest available local market rows for covered ports. Filter by port, fuel type, and result limit.

Port Data

Canonical port records with name, region, country, and coordinates for active ports.

Route Planning

Calculate route alternatives between an origin and destination, including priced bunkering options where available.

Lubricant Search

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

Quote Engine

Submit structured fuel quote requests via REST for live-port enquiries.

GET /api/v1/prices

Fetch bunker prices

Get latest available bunker fuel price rows for covered ports. Filter by port, fuel type, and result limit.

Each row includes its own last_updated timestamp so your client can decide how fresh the data is.

terminal

# Get VLSFO prices in Singapore
curl "https://my.bulugo.com/api/v1/prices?port=Singapore&fuel_type=VLSFO&limit=1" \
  -H "Authorization: Bearer <API_KEY>"

# Response
{
  "data": [
    {
      "port": { "id": "port_uuid", "name": "Singapore", "country": "Singapore" },
      "fuel_type": "VLSFO",
      "price": {
        "value": 628.50,
        "currency": "USD",
        "unit": "MT",
        "last_updated": "2026-07-30T10:45:00.000Z"
      },
      "market_data": { "supplier_count": 0, "min_price": 624.00, "max_price": 633.00 }
    }
  ],
  "meta": { "total_results": 1, "max_results": 1 }
}

terminal

# Search ports with VLSFO availability
curl "https://my.bulugo.com/api/v1/ports?region=Asia&country=SG" \
  -H "Authorization: Bearer <API_KEY>"

# Response
{
  "count": 1,
  "ports": [
    {
      "name": "Singapore",
      "latitude": 1.2594,
      "longitude": 103.7544,
      "region": "Asia",
      "country": "Singapore",
      "country_code": "SG"
    }
  ]
}

GET /api/v1/ports

Search port data

Query active canonical port records by region or country.

Each port includes display name, coordinates, region, country, and country code.

POST /api/v1/quote/request

Request a quote

Submit a programmatic quote request for a live port with fuel grade, quantity, contact email, and delivery details.

The API returns a submitted quote identifier. Supplier follow-up happens through the platform workflow.

terminal

# Request a quote
curl -X POST "https://my.bulugo.com/api/v1/quote/request" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "port": "Singapore",
    "fuel_grade": "VLSFO",
    "quantity_mt": 500,
    "delivery_date": "2026-08-15",
    "contact_email": "ops@example.com",
    "vessel_name": "Example Vessel"
  }'

# Response
{
  "quote_id": 12345,
  "status": "submitted",
  "message": "Your quote request has been submitted. Our suppliers will respond within 2-4 hours.",
  "port": "Singapore",
  "fuel_grade": "VLSFO",
  "quantity_mt": 500
}

terminal

# Plan a route with bunkering stops
curl -X POST "https://my.bulugo.com/api/v1/route/plan" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "Singapore",
    "destination": "Rotterdam",
    "fuelGrade": "VLSFO",
    "quantity": 500
  }'

# Response
{
  "route": {
    "origin": { "name": "Singapore" },
    "destination": { "name": "Rotterdam" },
    "distance_nm": 8400,
    "estimated_days": 29.2
  },
  "fuel_grade": "VLSFO",
  "ports": [],
  "alternatives": [],
  "recommendation": null
}

POST /api/v1/route/plan

Plan a bunkering route

Submit an origin, destination, fuel grade, and optional quantity to compare priced bunkering alternatives.

The response includes route distance, estimated days, nearby priced ports, alternatives, and any recommendation available for the route.

Rate Limits

Built for scale

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

Current users

100

API calls / month

Data API access included for buyer and supplier accounts

Route planning

5-50

route plans / month

Allowance depends on the account plan

Pro

2,000

API calls / month

Higher API-call allowance for heavier workflows

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; create a replacement key before revoking an old one

authentication

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

# Generate and revoke keys from Developer Settings.
# Use the Usage page to monitor calls.

# 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

Current buyer and supplier accounts can generate a key for MCP or REST API access. 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

Create a bearer token in Developer Settings

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

Current users

Route planning

Pro

Simple bearer token auth

Start integrating today

Three ways to
integrate Bulugo