Agent Central

FBA storage fees

get_fba_storage_fees

Read-only

Returns stored monthly FBA storage estimates, Amazon Seller Economics product allocations with source SKUs, or long-term storage charges, as source rows or summed per product or per month. Source labels distinguish allocations from posted settlement charges. Empty months report Amazon's request outcome. Reads never create reports. FBA only, not AWD.

Input Schema

Name	Required	Description	Default
`sku`	No	Filter by seller SKU. monthly_storage resolves only unique current inventory mappings; allocations and long-term rows preserve Amazon source SKUs.
`asin`	No	Filter by ASIN.
`view`	No	monthly_storage: storage report estimates; monthly_product_allocation: stored historical Seller Economics product amounts and source SKUs; long_term_storage: long-term charge rows.	monthly_storage
`fnsku`	No	Filter by FNSKU.
`grain`	No	row: source rows (monthly_storage has one per product per fulfillment center). product: amounts summed per charge period and product. month: totals per charge period, with per-month Amazon request outcomes in diagnostics.source_periods. Sums keep source precision; round once at the total.	row
`limit`	No	Max rows to return (default 100, max 1000).
`offset`	No	Pagination offset (0-100000, default 0). Use the returned pagination.next_offset to continue.
`sort_by`	No	Column to sort by. Allowed columns depend on view and grain.
`end_date`	No	Optional charge-period range end (YYYY-MM-DD). The range may span at most 731 days. Defaults to start_date when supplied alone.
`sort_order`	No	Sort direction.	desc
`start_date`	No	Optional charge-period range start (YYYY-MM-DD). The range may span at most 731 days. Monthly views: charge months whose period starts in the range (a mid-month start includes that month). long_term_storage: charge_snapshot_date. Omitted: latest period only.
`snapshot_date`	No	Monthly views only. Stored charge-period partition date (YYYY-MM-DD, the first of the month). Defaults to latest available period. Not combined with start_date/end_date.
`month_of_charge`	No	Monthly views only. Filter by charge month (YYYY-MM). Not combined with start_date/end_date.
`include_raw_rows`	No	For tabular results, false returns compact rows capped at MCP_TEXT_ROW_PREVIEW_LIMIT (default 10), regardless of limit. Complete-page and custom non-tabular responses may ignore this option; see tool-specific notes. Default true; large full-row responses are capped separately. Freshness fields require include_diagnostics=true in either row mode, where supported.
`include_diagnostics`	No	True enables expanded freshness diagnostics. Where supported, snapshot_capture_at and snapshot_data_through_date are populated only when include_diagnostics=true, in both compact and full-row modes; values may still be null if source data is unavailable. Default false. Basic empty-result data-window diagnostics are included by default when available.

Output Schema

Name	Required	Description	Default
`evidence`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed29 schema fields changedNov 7, 2026

changedInput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

changedOutput schema / $schema

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

changedOutput schema / additionalProperties
```
Previous value: -trueNew value: +{}
```
removedOutput schema / properties / evidence / properties / effective_scope / $ref
```
Removed value: -"#/properties/evidence/properties/requested_scope"
```
addedOutput schema / properties / evidence / properties / effective_scope / additionalProperties
```
Added value: +false
```

addedOutput schema / properties / evidence / properties / effective_scope / properties

Added value: +{
+  "end_date": {
+    "anyOf": [
+      {
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "filters": {
+    "additionalProperties": {},
+    "propertyNames": {
+      "type": "string"
+    },
+    "type": "object"
+  },
+  "group_by": {
+    "items": {
+      "maxLength": 128,
+      "minLength": 1,
+      "type": "string"
+    },
+    "type": "array"
+  },
+  "marketplace_id": {
+    "anyOf": [
+      {
+        "minLength": 1,
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "reporting_time_zone": {
+    "anyOf": [
+      {
+        "minLength": 1,
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "sort": {
+    "items": {
+      "additionalProperties": false,
+      "properties": {
+        "direction": {
+          "enum": [
+            "asc",
+            "desc"
+          ],
+          "type": "string"
+        },
+        "field": {
+          "maxLength": 128,
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "field",
+        "direction"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "start_date": {
+    "anyOf": [
+      {
+        "format": "date",
+        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  }
+}

addedOutput schema / properties / evidence / properties / effective_scope / required

Added value: +[
+  "marketplace_id",
+  "start_date",
+  "end_date",
+  "reporting_time_zone",
+  "group_by",
+  "sort",
+  "filters"
+]

addedOutput schema / properties / evidence / properties / effective_scope / type
```
Added value: +"object"
```
removedOutput schema / properties / evidence / properties / grain / items / $ref
```
Removed value: -"#/properties/evidence/properties/tool"
```
addedOutput schema / properties / evidence / properties / grain / items / maxLength
```
Added value: +128
```
addedOutput schema / properties / evidence / properties / grain / items / minLength
```
Added value: +1
```
addedOutput schema / properties / evidence / properties / grain / items / type
```
Added value: +"string"
```
removedOutput schema / properties / evidence / properties / join_keys / items / properties / field / $ref
```
Removed value: -"#/properties/evidence/properties/tool"
```
addedOutput schema / properties / evidence / properties / join_keys / items / properties / field / maxLength
```
Added value: +128
```
addedOutput schema / properties / evidence / properties / join_keys / items / properties / field / minLength
```
Added value: +1
```
addedOutput schema / properties / evidence / properties / join_keys / items / properties / field / type
```
Added value: +"string"
```

changedOutput schema / properties / evidence / properties / observed / properties / data_start / anyOf

Previous value: -[
-  {
-    "format": "date",
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "format": "date",
+    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / evidence / properties / observed / properties / data_through / anyOf

Previous value: -[
-  {
-    "format": "date",
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "format": "date",
+    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / evidence / properties / requested_scope / properties / end_date / anyOf

Previous value: -[
-  {
-    "format": "date",
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "format": "date",
+    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / evidence / properties / requested_scope / properties / filters / propertyNames
```
Added value: +{
+  "type": "string"
+}
```
removedOutput schema / properties / evidence / properties / requested_scope / properties / group_by / items / $ref
```
Removed value: -"#/properties/evidence/properties/tool"
```
addedOutput schema / properties / evidence / properties / requested_scope / properties / group_by / items / maxLength
```
Added value: +128
```
addedOutput schema / properties / evidence / properties / requested_scope / properties / group_by / items / minLength
```
Added value: +1
```
addedOutput schema / properties / evidence / properties / requested_scope / properties / group_by / items / type
```
Added value: +"string"
```
removedOutput schema / properties / evidence / properties / requested_scope / properties / sort / items / properties / field / $ref
```
Removed value: -"#/properties/evidence/properties/tool"
```
addedOutput schema / properties / evidence / properties / requested_scope / properties / sort / items / properties / field / maxLength
```
Added value: +128
```
addedOutput schema / properties / evidence / properties / requested_scope / properties / sort / items / properties / field / minLength
```
Added value: +1
```
addedOutput schema / properties / evidence / properties / requested_scope / properties / sort / items / properties / field / type
```
Added value: +"string"
```

changedOutput schema / properties / evidence / properties / requested_scope / properties / start_date / anyOf

Previous value: -[
-  {
-    "format": "date",
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "format": "date",
+    "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

Changed2 schema fields changedOct 28, 2026

changedInput schema / properties / end_date / description

Previous value: -"Optional charge-period range end (YYYY-MM-DD). Defaults to start_date when supplied alone."New value: +"Optional charge-period range end (YYYY-MM-DD). The range may span at most 731 days. Defaults to start_date when supplied alone."

changedInput schema / properties / start_date / description

Previous value: -"Optional charge-period range start (YYYY-MM-DD), up to 731 days with end_date. Monthly views: charge months whose period starts in the range (a mid-month start includes that month). long_term_storage: charge_snapshot_date. Omitted: latest period only."New value: +"Optional charge-period range start (YYYY-MM-DD). The range may span at most 731 days. Monthly views: charge months whose period starts in the range (a mid-month start includes that month). long_term_storage: charge_snapshot_date. Omitted: latest period only."

Changed7 schema fields changedOct 28, 2026

changedInput schema / properties / end_date / description

Previous value: -"long_term_storage only. End charge_snapshot_date (YYYY-MM-DD). Defaults to start_date when supplied alone."New value: +"Optional charge-period range end (YYYY-MM-DD). Defaults to start_date when supplied alone."

addedInput schema / properties / grain

Added value: +{
+  "default": "row",
+  "description": "row: source rows (monthly_storage has one per product per fulfillment center). product: amounts summed per charge period and product. month: totals per charge period, with per-month Amazon request outcomes in diagnostics.source_periods. Sums keep source precision; round once at the total.",
+  "enum": [
+    "row",
+    "product",
+    "month"
+  ],
+  "type": "string"
+}

changedInput schema / properties / month_of_charge / description

Previous value: -"Monthly views only. Filter by charge month (YYYY-MM for monthly_product_allocation)."New value: +"Monthly views only. Filter by charge month (YYYY-MM). Not combined with start_date/end_date."

changedInput schema / properties / snapshot_date / description

Previous value: -"Monthly views only. Stored charge-period partition date (YYYY-MM-DD). Defaults to latest available period."New value: +"Monthly views only. Stored charge-period partition date (YYYY-MM-DD, the first of the month). Defaults to latest available period. Not combined with start_date/end_date."

changedInput schema / properties / sort_by / description

Previous value: -"Column to sort by. Allowed columns depend on view."New value: +"Column to sort by. Allowed columns depend on view and grain."

changedInput schema / properties / sort_by / enum

Previous value: -[
-  "estimated_monthly_storage_fee",
-  "est_base_msf",
-  "est_sus",
-  "base_rate",
-  "average_quantity_on_hand",
-  "month_of_charge",
-  "snapshot_date",
-  "asin",
-  "sku",
-  "amount_charged",
-  "qty_charged",
-  "charge_snapshot_date",
-  "asin",
-  "sku",
-  "amount",
-  "base_amount",
-  "utilization_surcharge_amount",
-  "month_of_charge",
-  "snapshot_date",
-  "asin",
-  "sku"
-]New value: +[
+  "estimated_monthly_storage_fee",
+  "est_base_msf",
+  "est_sus",
+  "base_rate",
+  "average_quantity_on_hand",
+  "month_of_charge",
+  "snapshot_date",
+  "asin",
+  "sku",
+  "fulfillment_center_count",
+  "product_count",
+  "row_count",
+  "amount_charged",
+  "qty_charged",
+  "charge_snapshot_date",
+  "amount",
+  "base_amount",
+  "utilization_surcharge_amount"
+]

changedInput schema / properties / start_date / description

Previous value: -"long_term_storage only. Start charge_snapshot_date (YYYY-MM-DD). Defaults to latest charge snapshot when omitted."New value: +"Optional charge-period range start (YYYY-MM-DD), up to 731 days with end_date. Monthly views: charge months whose period starts in the range (a mid-month start includes that month). long_term_storage: charge_snapshot_date. Omitted: latest period only."

Changed2 schema fields changedOct 27, 2026

changedInput schema / properties / include_diagnostics / description

Previous value: -"True may add expanded freshness diagnostics. Basic empty-result data-window diagnostics are included by default when available."New value: +"True enables expanded freshness diagnostics. Where supported, snapshot_capture_at and snapshot_data_through_date are populated only when include_diagnostics=true, in both compact and full-row modes; values may still be null if source data is unavailable. Default false. Basic empty-result data-window diagnostics are included by default when available."

changedInput schema / properties / include_raw_rows / description

Previous value: -"False returns compact rows. Default true."New value: +"For tabular results, false returns compact rows capped at MCP_TEXT_ROW_PREVIEW_LIMIT (default 10), regardless of limit. Complete-page and custom non-tabular responses may ignore this option; see tool-specific notes. Default true; large full-row responses are capped separately. Freshness fields require include_diagnostics=true in either row mode, where supported."

Changed5 schema fields changedOct 27, 2026

changedOutput schema / properties / evidence / properties / basis / properties / date / items / enum

Previous value: -[
-  "order_date",
-  "reporting_date",
-  "click_attribution_date",
-  "posted_date",
-  "settlement_date",
-  "snapshot_date",
-  "live_observation_time",
-  "event_time",
-  "effective_date",
-  "not_applicable",
-  "not_reported"
-]New value: +[
+  "order_date",
+  "reporting_date",
+  "click_attribution_date",
+  "posted_date",
+  "financial_event_group_start",
+  "settlement_date",
+  "snapshot_date",
+  "live_observation_time",
+  "event_time",
+  "effective_date",
+  "not_applicable",
+  "not_reported"
+]

changedOutput schema / properties / evidence / properties / entity_types / items / enum

Previous value: -[
-  "account",
-  "marketplace",
-  "product",
-  "variation_family",
-  "listing",
-  "offer",
-  "inventory_item",
-  "fulfillment_center",
-  "order",
-  "order_item",
-  "campaign",
-  "ad_group",
-  "ad",
-  "target",
-  "keyword",
-  "search_query",
-  "portfolio",
-  "store",
-  "audience_segment",
-  "dsp_advertiser",
-  "shipment",
-  "inbound_plan",
-  "fulfillment_operation",
-  "transaction",
-  "settlement",
-  "financial_event",
-  "return",
-  "reimbursement",
-  "promotion",
-  "review",
-  "catalog_definition",
-  "audit_event",
-  "not_applicable"
-]New value: +[
+  "account",
+  "marketplace",
+  "product",
+  "variation_family",
+  "listing",
+  "offer",
+  "inventory_item",
+  "fulfillment_center",
+  "order",
+  "order_item",
+  "campaign",
+  "ad_group",
+  "ad",
+  "target",
+  "keyword",
+  "search_query",
+  "portfolio",
+  "store",
+  "audience_segment",
+  "dsp_advertiser",
+  "shipment",
+  "inbound_plan",
+  "fulfillment_operation",
+  "transaction",
+  "settlement",
+  "financial_event",
+  "financial_event_group",
+  "return",
+  "reimbursement",
+  "promotion",
+  "review",
+  "catalog_definition",
+  "audit_event",
+  "not_applicable"
+]

changedOutput schema / properties / evidence / properties / join_keys / items / properties / entity_type / enum

Previous value: -[
-  "account",
-  "marketplace",
-  "product",
-  "variation_family",
-  "listing",
-  "offer",
-  "inventory_item",
-  "fulfillment_center",
-  "order",
-  "order_item",
-  "campaign",
-  "ad_group",
-  "ad",
-  "target",
-  "keyword",
-  "search_query",
-  "portfolio",
-  "store",
-  "audience_segment",
-  "dsp_advertiser",
-  "shipment",
-  "inbound_plan",
-  "fulfillment_operation",
-  "transaction",
-  "settlement",
-  "financial_event",
-  "return",
-  "reimbursement",
-  "promotion",
-  "review",
-  "catalog_definition",
-  "audit_event",
-  "not_applicable"
-]New value: +[
+  "account",
+  "marketplace",
+  "product",
+  "variation_family",
+  "listing",
+  "offer",
+  "inventory_item",
+  "fulfillment_center",
+  "order",
+  "order_item",
+  "campaign",
+  "ad_group",
+  "ad",
+  "target",
+  "keyword",
+  "search_query",
+  "portfolio",
+  "store",
+  "audience_segment",
+  "dsp_advertiser",
+  "shipment",
+  "inbound_plan",
+  "fulfillment_operation",
+  "transaction",
+  "settlement",
+  "financial_event",
+  "financial_event_group",
+  "return",
+  "reimbursement",
+  "promotion",
+  "review",
+  "catalog_definition",
+  "audit_event",
+  "not_applicable"
+]

changedOutput schema / properties / evidence / properties / join_keys / items / properties / role / enum

Previous value: -[
-  "account_id",
-  "marketplace_id",
-  "asin",
-  "advertised_asin",
-  "purchased_asin",
-  "child_asin",
-  "parent_asin",
-  "seller_sku",
-  "fnsku",
-  "order_id",
-  "order_item_id",
-  "campaign_id",
-  "ad_group_id",
-  "ad_id",
-  "target_id",
-  "keyword_id",
-  "search_query",
-  "portfolio_id",
-  "shipment_id",
-  "inbound_plan_id",
-  "operation_id",
-  "transaction_id",
-  "settlement_id",
-  "promotion_id",
-  "not_applicable"
-]New value: +[
+  "account_id",
+  "marketplace_id",
+  "asin",
+  "advertised_asin",
+  "purchased_asin",
+  "child_asin",
+  "parent_asin",
+  "seller_sku",
+  "fnsku",
+  "order_id",
+  "order_item_id",
+  "campaign_id",
+  "ad_group_id",
+  "ad_id",
+  "target_id",
+  "keyword_id",
+  "search_query",
+  "portfolio_id",
+  "shipment_id",
+  "inbound_plan_id",
+  "operation_id",
+  "transaction_id",
+  "financial_event_group_id",
+  "settlement_id",
+  "promotion_id",
+  "not_applicable"
+]

changedOutput schema / properties / evidence / properties / metric_families / items / enum

Previous value: -[
-  "sales",
-  "traffic",
-  "advertising",
-  "inventory",
-  "returns",
-  "reimbursements",
-  "fees",
-  "profitability",
-  "catalog",
-  "rank",
-  "fulfillment",
-  "pricing",
-  "promotions",
-  "reviews",
-  "audit",
-  "availability",
-  "not_applicable"
-]New value: +[
+  "sales",
+  "traffic",
+  "advertising",
+  "inventory",
+  "returns",
+  "reimbursements",
+  "payouts",
+  "fees",
+  "profitability",
+  "catalog",
+  "rank",
+  "fulfillment",
+  "pricing",
+  "promotions",
+  "reviews",
+  "audit",
+  "availability",
+  "not_applicable"
+]

Changed6 schema fields changedOct 22, 2026

changedInput schema / properties / month_of_charge / description

Previous value: -"monthly_storage only. Filter by Amazon's month_of_charge value from the report."New value: +"Monthly views only. Filter by charge month (YYYY-MM for monthly_product_allocation)."

changedInput schema / properties / sku / description

Previous value: -"Filter by seller SKU. monthly_storage resolves SKU through the latest FBA inventory snapshot by ASIN/FNSKU."New value: +"Filter by seller SKU. monthly_storage resolves only unique current inventory mappings; allocations and long-term rows preserve Amazon source SKUs."

changedInput schema / properties / snapshot_date / description

Previous value: -"monthly_storage only. Ingestion snapshot date (YYYY-MM-DD). Defaults to latest."New value: +"Monthly views only. Stored charge-period partition date (YYYY-MM-DD). Defaults to latest available period."

changedInput schema / properties / sort_by / enum

Previous value: -[
-  "estimated_monthly_storage_fee",
-  "est_base_msf",
-  "est_sus",
-  "base_rate",
-  "average_quantity_on_hand",
-  "month_of_charge",
-  "snapshot_date",
-  "asin",
-  "sku",
-  "amount_charged",
-  "qty_charged",
-  "charge_snapshot_date",
-  "asin",
-  "sku"
-]New value: +[
+  "estimated_monthly_storage_fee",
+  "est_base_msf",
+  "est_sus",
+  "base_rate",
+  "average_quantity_on_hand",
+  "month_of_charge",
+  "snapshot_date",
+  "asin",
+  "sku",
+  "amount_charged",
+  "qty_charged",
+  "charge_snapshot_date",
+  "asin",
+  "sku",
+  "amount",
+  "base_amount",
+  "utilization_surcharge_amount",
+  "month_of_charge",
+  "snapshot_date",
+  "asin",
+  "sku"
+]

changedInput schema / properties / view / description

Previous value: -"monthly_storage returns GET_FBA_STORAGE_FEE_CHARGES_DATA rows; long_term_storage returns GET_FBA_FULFILLMENT_LONGTERM_STORAGE_FEE_CHARGES_DATA rows."New value: +"monthly_storage: storage report estimates; monthly_product_allocation: stored historical Seller Economics product amounts and source SKUs; long_term_storage: long-term charge rows."

changedInput schema / properties / view / enum

Previous value: -[
-  "monthly_storage",
-  "long_term_storage"
-]New value: +[
+  "monthly_storage",
+  "long_term_storage",
+  "monthly_product_allocation"
+]

AddedOct 7, 2026

TDQS

A4.2/5.0

Behavior4/5

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

With readOnlyHint=true already supplied, the description adds useful behavioral context: 'Reads never create reports,' source labels distinguish allocations from posted settlement charges, and empty months report Amazon's request outcome. It does not discuss permissions, rate limits, or freshness mechanics, but those are partly covered by the schema and annotations.

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

Conciseness5/5

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

The description is front-loaded and efficient, with each sentence conveying a distinct purpose, scope, output-mode, or behavioral fact. There is no filler or repetition.

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?

Given the tool's complexity, 15 optional parameters, and the presence of an output schema, the description covers the key conceptual choices and scope limits well. Minor details such as pagination, date-range behavior, and diagnostics are left to the schema, which is appropriate.

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 coverage is 100%, so the input schema already documents all 15 parameters in detail. The description adds conceptual meaning about view/grain choices and source-label distinctions, but it does not provide parameter-level syntax or constraints beyond what the schema already supplies.

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

Purpose5/5

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

The description uses a specific verb, 'Returns,' and names the exact resource: monthly FBA storage estimates, Seller Economics product allocations, or long-term storage charges. It also distinguishes the tool from adjacent scope by stating 'FBA only, not AWD' and clarifies the output shape via source rows or summed grains.

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

Usage Guidelines4/5

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

The description gives clear usage context: choose among monthly storage, product allocation, or long-term charge views, and choose source rows or product/month sums. It also explicitly excludes AWD. It stops short of naming a specific sibling tool to use instead for AWD or general fee estimates, but the context is strong.

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

All Agent Central tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.