Skip to main content
Glama

billing_quote

Read-only

The exact price of a metered call for YOU, before you make it — free. path = the API path the tool hits (e.g. /api/v1/relationships, with hops). Fund joules_all_in, the true debit. The quote says when it is a maximum and when an empty answer is free.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "path": "<path>"
    },
    "name": "billing_quote"
  }
}

Input Schema

NameRequiredDescriptionDefault
idNoEntity id (with entity_type) for a site.
latNoLatitude in decimal degrees, -90 to 90 (WGS84).
lngNoLongitude in decimal degrees, -180 to 180 (WGS84).
hopsNoGraph depth for a relationships path (an agent key up to 10).
pathYesThe API path the call would hit, e.g. "/api/v1/relationships", "/api/v1/look.from", "/api/v1/companies/{id}" …
as_ofNosite.reconstruction date, YYYY-MM-DD.
radius_mNosite.reconstruction square half-side in metres.
entity_typeNoEntity kind: deposit | infrastructure | company | project. Alternative to lat/lng for a site.

Output Schema

NameRequiredDescriptionDefault
pegNo
usdNo
hopsNo
pathNo
tierNo
joulesNo
receiptNo
query_typeNo
billed_hopsNo
pricing_tierNo
rate_per_hopNo
joules_all_inNo
pricing_modelNo
receipt_offerNo
rail_fee_joulesNo
refund_on_emptyNo
quote_is_maximumNo
joules_with_receiptNo
partial_refund_noteNo
joules_with_receipt_all_inNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed68 schema fields changed
    • removedInput schema / properties / as_of / default
      Removed value: -null
    • removedInput schema / properties / as_of / title
      Removed value: -"As Of"
    • removedInput schema / properties / entity_type / default
      Removed value: -null
    • removedInput schema / properties / entity_type / title
      Removed value: -"Entity Type"
    • removedInput schema / properties / hops / default
      Removed value: -null
    • removedInput schema / properties / hops / title
      Removed value: -"Hops"
    • removedInput schema / properties / id / default
      Removed value: -null
    • removedInput schema / properties / id / title
      Removed value: -"Id"
    • removedInput schema / properties / lat / default
      Removed value: -null
    • changedInput schema / properties / lat / description
      Previous value: -"Latitude in decimal degrees, -90 to 90 (WGS84). For site.reconstruction: the site, so the quote names its tier."New value: +"Latitude in decimal degrees, -90 to 90 (WGS84)."
    • removedInput schema / properties / lat / title
      Removed value: -"Lat"
    • removedInput schema / properties / lng / default
      Removed value: -null
    • removedInput schema / properties / lng / title
      Removed value: -"Lng"
    • changedInput schema / properties / path / description
      Previous value: -"The API path the call would hit, e.g. \"/api/v1/relationships\", \"/api/v1/look.from\", \"/api/v1/companies/{id}\", \"/api/v1/companies\", \"/api/v1/deposits\", \"/api/v1/site.reconstruction\"."New value: +"The API path the call would hit, e.g. \"/api/v1/relationships\", \"/api/v1/look.from\", \"/api/v1/companies/{id}\" …"
    • removedInput schema / properties / path / title
      Removed value: -"Path"
    • removedInput schema / properties / radius_m / default
      Removed value: -null
    • removedInput schema / properties / radius_m / title
      Removed value: -"Radius M"
    • removedInput schema / title
      Removed value: -"billing_quoteArguments"
    • removedOutput schema / description
      Removed value: -"billing_quote — covers BOTH backend shapes (pricing_model 'per_hop' carries billed_hops /\nrate_per_hop / refund_on_empty / quote_is_maximum; 'flat_query_type' omits them). All optional,\nso neither shape errors."
    • removedOutput schema / properties / billed_hops / default
      Removed value: -null
    • removedOutput schema / properties / billed_hops / title
      Removed value: -"Billed Hops"
    • removedOutput schema / properties / hops / default
      Removed value: -null
    • removedOutput schema / properties / hops / title
      Removed value: -"Hops"
    • removedOutput schema / properties / joules / default
      Removed value: -null
    • removedOutput schema / properties / joules / description
      Removed value: -"BASE price, before the rail surcharge"
    • removedOutput schema / properties / joules / title
      Removed value: -"Joules"
    • removedOutput schema / properties / joules_all_in / default
      Removed value: -null
    • removedOutput schema / properties / joules_all_in / description
      Removed value: -"THE TRUE DEBIT — fund this, not `joules`"
    • removedOutput schema / properties / joules_all_in / title
      Removed value: -"Joules All In"
    • removedOutput schema / properties / joules_with_receipt / default
      Removed value: -null
    • removedOutput schema / properties / joules_with_receipt / description
      Removed value: -"an opted-in key: base + the receipt's price"
    • removedOutput schema / properties / joules_with_receipt / title
      Removed value: -"Joules With Receipt"
    • removedOutput schema / properties / joules_with_receipt_all_in / default
      Removed value: -null
    • removedOutput schema / properties / joules_with_receipt_all_in / description
      Removed value: -"an opted-in key: the true debit with the receipt"
    • removedOutput schema / properties / joules_with_receipt_all_in / title
      Removed value: -"Joules With Receipt All In"
    • removedOutput schema / properties / partial_refund_note / default
      Removed value: -null
    • removedOutput schema / properties / partial_refund_note / title
      Removed value: -"Partial Refund Note"
    • removedOutput schema / properties / path / default
      Removed value: -null
    • removedOutput schema / properties / path / title
      Removed value: -"Path"
    • removedOutput schema / properties / peg / default
      Removed value: -null
    • removedOutput schema / properties / peg / title
      Removed value: -"Peg"
    • removedOutput schema / properties / pricing_model / default
      Removed value: -null
    • removedOutput schema / properties / pricing_model / title
      Removed value: -"Pricing Model"
    • removedOutput schema / properties / pricing_tier / default
      Removed value: -null
    • removedOutput schema / properties / pricing_tier / title
      Removed value: -"Pricing Tier"
    • removedOutput schema / properties / query_type / default
      Removed value: -null
    • removedOutput schema / properties / query_type / title
      Removed value: -"Query Type"
    • removedOutput schema / properties / quote_is_maximum / default
      Removed value: -null
    • removedOutput schema / properties / quote_is_maximum / title
      Removed value: -"Quote Is Maximum"
    • removedOutput schema / properties / rail_fee_joules / default
      Removed value: -null
    • removedOutput schema / properties / rail_fee_joules / description
      Removed value: -"the ~0.5% rail surcharge, rounded up"
    • removedOutput schema / properties / rail_fee_joules / title
      Removed value: -"Rail Fee Joules"
    • removedOutput schema / properties / rate_per_hop / default
      Removed value: -null
    • removedOutput schema / properties / rate_per_hop / title
      Removed value: -"Rate Per Hop"
    • removedOutput schema / properties / receipt / default
      Removed value: -null
    • removedOutput schema / properties / receipt / description
      Removed value: -"an opted-in key only: the receipt line that WILL be charged with the answer"
    • removedOutput schema / properties / receipt / title
      Removed value: -"Receipt"
    • removedOutput schema / properties / receipt_offer / default
      Removed value: -null
    • removedOutput schema / properties / receipt_offer / description
      Removed value: -"graph quotes: the RECEIPT offer — joules_per_receipt (10), this_key_opted_in, how_to_opt_in (the key OWNER turns it on), what_you_get. See receipts_me."
    • removedOutput schema / properties / receipt_offer / title
      Removed value: -"Receipt Offer"
    • removedOutput schema / properties / refund_on_empty / default
      Removed value: -null
    • removedOutput schema / properties / refund_on_empty / title
      Removed value: -"Refund On Empty"
    • removedOutput schema / properties / tier / default
      Removed value: -null
    • removedOutput schema / properties / tier / description
      Removed value: -"site.reconstruction: the model tier this site gets (lidar_2m | dem_30m), decided before any charge"
    • removedOutput schema / properties / tier / title
      Removed value: -"Tier"
    • removedOutput schema / properties / usd / default
      Removed value: -null
    • removedOutput schema / properties / usd / title
      Removed value: -"Usd"
    • removedOutput schema / title
      Removed value: -"QuoteOut"
  2. Changed1 schema field changed
    • changedInput schema / properties / id / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "type": "string"
      +  },
      +  {
      +    "type": "integer"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  3. Changed4 schema fields changed
    • addedOutput schema / properties / joules_with_receipt
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "an opted-in key: base + the receipt's price",
      +  "title": "Joules With Receipt"
      +}
    • addedOutput schema / properties / joules_with_receipt_all_in
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "an opted-in key: the true debit with the receipt",
      +  "title": "Joules With Receipt All In"
      +}
    • addedOutput schema / properties / receipt
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "an opted-in key only: the receipt line that WILL be charged with the answer",
      +  "title": "Receipt"
      +}
    • addedOutput schema / properties / receipt_offer
      Added value: +{
      +  "anyOf": [
      +    {
      +      "additionalProperties": true,
      +      "type": "object"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "graph quotes: the RECEIPT offer — joules_per_receipt (10), this_key_opted_in, how_to_opt_in (the key OWNER turns it on), what_you_get. See receipts_me.",
      +  "title": "Receipt Offer"
      +}
  4. Changed8 schema fields changed
    • addedInput schema / properties / as_of / description
      Added value: +"site.reconstruction date, YYYY-MM-DD."
    • addedInput schema / properties / entity_type / description
      Added value: +"Entity kind: deposit | infrastructure | company | project. Alternative to lat/lng for a site."
    • addedInput schema / properties / hops / description
      Added value: +"Graph depth for a relationships path (an agent key up to 10)."
    • addedInput schema / properties / id / description
      Added value: +"Entity id (with entity_type) for a site."
    • addedInput schema / properties / lat / description
      Added value: +"Latitude in decimal degrees, -90 to 90 (WGS84). For site.reconstruction: the site, so the quote names its tier."
    • addedInput schema / properties / lng / description
      Added value: +"Longitude in decimal degrees, -180 to 180 (WGS84)."
    • addedInput schema / properties / path / description
      Added value: +"The API path the call would hit, e.g. \"/api/v1/relationships\", \"/api/v1/look.from\", \"/api/v1/companies/{id}\", \"/api/v1/companies\", \"/api/v1/deposits\", \"/api/v1/site.reconstruction\"."
    • addedInput schema / properties / radius_m / description
      Added value: +"site.reconstruction square half-side in metres."
  5. Changed7 schema fields changed
    • addedInput schema / properties / as_of
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "As Of"
      +}
    • addedInput schema / properties / entity_type
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Entity Type"
      +}
    • addedInput schema / properties / id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Id"
      +}
    • addedInput schema / properties / lat
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Lat"
      +}
    • addedInput schema / properties / lng
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Lng"
      +}
    • addedInput schema / properties / radius_m
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "number"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Radius M"
      +}
    • addedOutput schema / properties / tier
      Added value: +{
      +  "anyOf": [
      +    {
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "site.reconstruction: the model tier this site gets (lidar_2m | dem_30m), decided before any charge",
      +  "title": "Tier"
      +}
  6. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "description": "billing_quote — covers BOTH backend shapes (pricing_model 'per_hop' carries billed_hops /\nrate_per_hop / refund_on_empty / quote_is_maximum; 'flat_query_type' omits them). All optional,\nso neither shape errors.",
      +  "properties": {
      +    "billed_hops": {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Billed Hops"
      +    },
      +    "hops": {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Hops"
      +    },
      +    "joules": {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "description": "BASE price, before the rail surcharge",
      +      "title": "Joules"
      +    },
      +    "joules_all_in": {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "description": "THE TRUE DEBIT — fund this, not `joules`",
      +      "title": "Joules All In"
      +    },
      +    "partial_refund_note": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Partial Refund Note"
      +    },
      +    "path": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Path"
      +    },
      +    "peg": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Peg"
      +    },
      +    "pricing_model": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Pricing Model"
      +    },
      +    "pricing_tier": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Pricing Tier"
      +    },
      +    "query_type": {
      +      "anyOf": [
      +        {
      +          "type": "string"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Query Type"
      +    },
      +    "quote_is_maximum": {
      +      "anyOf": [
      +        {
      +          "type": "boolean"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Quote Is Maximum"
      +    },
      +    "rail_fee_joules": {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "description": "the ~0.5% rail surcharge, rounded up",
      +      "title": "Rail Fee Joules"
      +    },
      +    "rate_per_hop": {
      +      "anyOf": [
      +        {
      +          "type": "integer"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Rate Per Hop"
      +    },
      +    "refund_on_empty": {
      +      "anyOf": [
      +        {
      +          "type": "boolean"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Refund On Empty"
      +    },
      +    "usd": {
      +      "anyOf": [
      +        {
      +          "type": "number"
      +        },
      +        {
      +          "type": "null"
      +        }
      +      ],
      +      "default": null,
      +      "title": "Usd"
      +    }
      +  },
      +  "title": "QuoteOut",
      +  "type": "object"
      +}
  7. First observed

TDQS

A3.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish that this is a safe read-only, non-destructive, closed-world operation. The description adds useful behavioral context beyond that: the quote is free, it reports the true debit via joules_all_in, and it indicates when the price is a maximum and when an empty answer is free.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is short and front-loads the core value proposition: exact pre-call price and free quote. Some phrasing such as 'Fund joules_all_in, the true debit' is slightly compressed and cryptic, but it does not waste space.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With an output schema, complete parameter descriptions, and read-only annotations, the description provides enough context for an agent to understand that this is a free preflight cost quote. It could be more complete by clarifying how site-related parameters affect the quote, but the structured fields carry that burden.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents the parameters in detail. The description adds a useful clarification for `path` and mentions `hops`, but most parameters are left to the schema, which is appropriate given the high coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states that this tool returns the exact price of a metered API call before the call is made, and that the quote itself is free. It is specific about the resource (metered call pricing) and gives a concrete path example, though it does not explicitly distinguish itself from quote-adjacent siblings such as market_quote.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives implied usage context ('before you make it') and points to funding joules_all_in, but it does not explicitly say when to use this versus alternatives like market_quote or funding_prepare, nor does it state exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources