ai.ironscout/ironscout

Official5 toolsLive

by ironscout

Read-only ammo pricing: offer search, caliber market snapshots, retailer directory. Descriptive.

MCP Server: ai.ironscout/ironscout

ai.ironscout/ironscout is an MCP server focused on read-only ammo pricing data. It provides search capabilities, caliber market snapshots, and a retailer directory. The description indicates the service is descriptive in nature and centers on ammo pricing without write access.

🛠️ Key Features

Read-only ammo pricing access
Search for ammo pricing information
Caliber market snapshots
Retailer directory

🚀 Use Cases

Finding ammo pricing via search
Comparing pricing context using caliber market snapshots
Locating retailers through a directory

⚡ Developer Benefits

Structured access to pricing, snapshots, and retailers
Tooling limited to read-only operations
Clear segmentation of market information (search, snapshots, directory)

⚠️ Limitations

Does not support modifying or writing pricing data (read-only)

Captured live from the server via tools/list.

search_offers

Search canonical ammunition products and their current per-retailer offers. Results are descriptive only — prices, availability, $/round, observation time, and provenance, with no verdicts, scores, or recommendations. Use each offer's `outUrl` for outbound links (do not rewrite it). `sort` is a mechanical ordering, never a judgement.

Parameters11

q	string	optional	Free-text query over product name/brand/description.
caliber	string	optional	Canonical caliber, e.g. "9mm" or ".223/5.56".
brand	string	optional
grain	integer	optional	Bullet weight in grains.
case	string	optional	Case material, e.g. "Brass", "Steel".
roundCountMin	integer	optional
roundCountMax	integer	optional
inStock	boolean	optional	When true, only products with in-stock offers are returned.
sort	string	optional	Mechanical ordering only. Defaults to pricePerRoundAsc.
page	integer	optional
pageSize	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Free-text query over product name/brand/description.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "caliber": {
      "description": "Canonical caliber, e.g. \"9mm\" or \".223/5.56\".",
      "type": "string",
      "minLength": 1,
      "maxLength": 60
    },
    "brand": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80
    },
    "grain": {
      "description": "Bullet weight in grains.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 2000
    },
    "case": {
      "description": "Case material, e.g. \"Brass\", \"Steel\".",
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "roundCountMin": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "roundCountMax": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100000
    },
    "inStock": {
      "description": "When true, only products with in-stock offers are returned.",
      "type": "boolean"
    },
    "sort": {
      "description": "Mechanical ordering only. Defaults to pricePerRoundAsc.",
      "type": "string",
      "enum": [
        "pricePerRoundAsc",
        "pricePerRoundDesc",
        "observedAtDesc"
      ]
    },
    "page": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_product

Fetch a single canonical product by its `canonicalProductId`, with current per-retailer offers. Descriptive only. Returns an `error_v1` body with `NOT_FOUND` if the id is unknown.

Parameters1

canonicalProductId

string

required

Canonical product id (CUID) from search results.

Raw schema

{
  "type": "object",
  "properties": {
    "canonicalProductId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Canonical product id (CUID) from search results."
    }
  },
  "required": [
    "canonicalProductId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_market_snapshot

Caliber-level price distribution (median, p25, p75, min, max) over a rolling window. Purely descriptive statistics with methodology and sample counts; never a forecast or recommendation. Returns `error_v1` `NOT_FOUND` when no snapshot exists for the caliber/window.

Parameters2

caliber	string	required	Canonical caliber, e.g. "9mm".
windowDays	any	optional	Rolling window in days. 7 or 30; defaults to 30.

Raw schema

{
  "type": "object",
  "properties": {
    "caliber": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "Canonical caliber, e.g. \"9mm\"."
    },
    "windowDays": {
      "description": "Rolling window in days. 7 or 30; defaults to 30.",
      "anyOf": [
        {
          "type": "number",
          "const": 7
        },
        {
          "type": "number",
          "const": 30
        }
      ]
    }
  },
  "required": [
    "caliber"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_calibers

Enumerate every canonical caliber IronScout recognizes, each flagged with whether a current market snapshot exists and its sample count. Calibers without a snapshot are still listed (with `hasSnapshot: false`).

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_retailers

List currently eligible/visible retailers. Ineligible retailers are omitted entirely (fail-closed, ADR-005). Descriptive directory only.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (5)

search_offersget_productget_market_snapshotlist_caliberslist_retailers

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.ironscout.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ironscout": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.ironscout.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: ai.ironscout/ironscout

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_offers

get_product

get_market_snapshot

list_calibers

list_retailers

Install

Remote endpoint

Related servers