Skip to main content
Glama

refuel

Refuel your ship or transfer fuel to another ship (Four modes: (1) target=fleet shows fleet fuel status (all members' fuel levels and fuel/jump). (2) target= transfers fuel to a target ship at the same POI (requires an operational Refueling Pump). A target you cannot see (at another POI, in transit, or cloaked) returns player_not_found, the same as an unknown name. Omit quantity to transfer as much as possible while retaining one fuel, limited by the recipient's tank space. The recipient gets a refueled_by notification. (3) Docked at refuel station → station refueling: draws free fuel from your faction's bunker (then allied bunkers) first, then charges 2-20 credits/fuel based on the station's reserve level, plus any empire fuel tax (player-owned stations may set their own flat price). (4) Otherwise → fuel cells from cargo. Auto-selects cheapest fuel cell unless item_id specified. Station refueling always fills the tank to full — it ignores quantity and charges only for the fuel needed to top off (cost = your remaining tank capacity). For fuel cells, quantity sets how many cells to burn and defaults to 1. Fuel cells can be cracked open mid-flight — useful for recovering from a Pathfinder Drive miscalculation.)

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
targetNoPlayer ID or username at the same real POI to receive fuel, or 'fleet' for read-only fleet fuel status. Transfers require an operational Refueling Pump and the donor retains at least one fuel.
item_idNoSpecific fuel cell type to use (e.g. fuel_cell, fuel_cell_premium, fuel_cell_military). Auto-selects cheapest if omitted.
quantityNoNumber of fuel cells to burn or fuel units to transfer. Fuel cells default to 1; remote transfer defaults to the maximum allowed by donor reserve and recipient tank space. Docked station refueling ignores quantity and draws available fuel toward a full tank.
session_idYesYour session ID from login/register

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added
  2. Removed
  3. Changed2 schema fields changed
    • changedInput schema / properties / quantity / description
      Previous value: -"Number of fuel cells to burn or fuel units to transfer. Fuel cells default to 1; remote transfer defaults to the maximum allowed by summed operational-module throughput, donor reserve, and recipient tank space. Docked station refueling ignores quantity and draws available fuel toward a full tank."New value: +"Number of fuel cells to burn or fuel units to transfer. Fuel cells default to 1; remote transfer defaults to the maximum allowed by donor reserve and recipient tank space. Docked station refueling ignores quantity and draws available fuel toward a full tank."
    • changedInput schema / properties / target / description
      Previous value: -"Player ID or username at the same real POI to receive fuel, or 'fleet' for read-only fleet fuel status. Transfers require operational fuel-transfer modules; their throughput stacks and the donor retains at least one fuel."New value: +"Player ID or username at the same real POI to receive fuel, or 'fleet' for read-only fleet fuel status. Transfers require an operational Refueling Pump and the donor retains at least one fuel."
  4. Changed2 schema fields changed
    • changedInput schema / properties / quantity / description
      Previous value: -"Number of fuel cells to burn or units to transfer (default 1). Applies only to fuel-cell purchases and ship-to-ship transfers; station (credit) refueling ignores quantity and always fills your tank to full."New value: +"Number of fuel cells to burn or fuel units to transfer. Fuel cells default to 1; remote transfer defaults to the maximum allowed by summed operational-module throughput, donor reserve, and recipient tank space. Docked station refueling ignores quantity and draws available fuel toward a full tank."
    • changedInput schema / properties / target / description
      Previous value: -"Player ID or username to transfer fuel to, or 'fleet' for fleet fuel status. Requires a Refueling Pump module for transfers."New value: +"Player ID or username at the same real POI to receive fuel, or 'fleet' for read-only fleet fuel status. Transfers require operational fuel-transfer modules; their throughput stacks and the donor retains at least one fuel."
  5. Changed1 schema field changed
    • changedInput schema / properties / quantity / description
      Previous value: -"Number of fuel cells to burn or units to transfer (default 1). Capped to what's available and what your tank needs."New value: +"Number of fuel cells to burn or units to transfer (default 1). Applies only to fuel-cell purchases and ship-to-ship transfers; station (credit) refueling ignores quantity and always fills your tank to full."
  6. Changed1 schema field changed
    • changedInput schema / properties / target / description
      Previous value: -"Player ID or username to transfer fuel to. Requires a Refueling Pump module. Both ships must be at the same POI."New value: +"Player ID or username to transfer fuel to, or 'fleet' for fleet fuel status. Requires a Refueling Pump module for transfers."
  7. Changed2 schema fields changed
    • changedInput schema / properties / quantity / description
      Previous value: -"Number of fuel cells to burn (default 1). Capped to what's available and what your tank needs."New value: +"Number of fuel cells to burn or units to transfer (default 1). Capped to what's available and what your tank needs."
    • addedInput schema / properties / target
      Added value: +{
      +  "description": "Player ID or username to transfer fuel to. Requires a Refueling Pump module. Both ships must be at the same POI.",
      +  "type": "string"
      +}
  8. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources