# AirShelf Catalog (remote · mcp.airshelf.ai)

Cross-vendor B2B catalog for AI agents: search, compare, find equivalents, request a quote.

- Trust score: 58/100 (low)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mcp.airshelf.ai`: 58/100 (this document), [markdown](https://verifymcp.io/servers/ai-airshelf-catalog/mcp.md), [page](https://verifymcp.io/servers/ai-airshelf-catalog/mcp)

## Channel facts

- Endpoint: `https://mcp.airshelf.ai/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 63/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (request_quote).
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 18/100
  - 0% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (poor).
  - Context-footprint check failed: tool/resource definitions use about 2363 tokens (~236/item across 10 items; 7 tools + 3 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.
  - Supports UI / widget rendering.

## Install

### Claude

```bash
claude mcp add --transport http ai-airshelf-catalog https://mcp.airshelf.ai/mcp
```

### Codex

```toml
[mcp_servers.ai-airshelf-catalog]
url = "https://mcp.airshelf.ai/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-airshelf-catalog": {
      "type": "remote",
      "url": "https://mcp.airshelf.ai/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ai-airshelf-catalog --url https://mcp.airshelf.ai/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  ai-airshelf-catalog:
    url: "https://mcp.airshelf.ai/mcp"
```

### Other

```json
{
  "mcpServers": {
    "ai-airshelf-catalog": {
      "type": "http",
      "url": "https://mcp.airshelf.ai/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 58, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-01 (score 57, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 56, −1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 57, +1)

No change was recorded against any check on this day. Stability & Change Management went from 7 to 10. That category is still filling its 30-day observation window: 2 days of observed history at the previous scan, 3 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 56, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 55, +2)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 53)

First indexed and scored.

## MCP tools (7)

### `search_catalog` (~620 tokens)

Search product catalog

Search the AirShelf cross-vendor product catalog by natural-language query, across any brand and category (e.g. flowers, jewelry, skincare, chocolate, apparel, keyboards, office printers, industrial hardware). Returns ranked products with prices, specs, and per-row match accounting.
Example queries: "birthday bouquet under $80", "minimalist gold necklace", "Toshiba A3 colour multifunction device", "tactile mechanical keyboard under $150".

Result fields:
• canonical_name — the exact catalog name of the product.
• spec_absence_note — spec fields absent from this product's golden record; null when nothing is missing.
• constraint_match_score, matched_criteria, missing_criteria — which of the query's spec constraints the row satisfies.
• parsed.price_availability — all_null = true means every returned price is null, which is normal for B2B unlisted pricing; query_had_budget reports whether the query carried one.
• parsed.weak_match — the catalog could not satisfy the query's constraints, so the rows are approximate. parsed.no_match — no product satisfies a hard constraint, and candidates violating it were excluded server-side.

On a miss or near-miss for a specific brand+model the response may also carry a `tier3` block: a real-time lookup for the exact SKU asked about, which can appear alongside fuzzy-neighbour rows.
• tier3.status = "resolved" — a single-source reading of the page at tier3.source_url, MPN-confirmed but not AirShelf-verified (tier3.verification is "live-unverified"). tier3.cached = true means it came from a recent prior lookup, with fetched_at recording when the page was read.
• tier3.status = "abstain" — the lookup could not confirm the product exists as asked, so no specs, price, or availability were established. tier3.guidance describes the quote-request path.
No tier3 block on a miss means the lookup did not run (disabled, rate-limited, or no parseable product identity in the query).

Optional `market` (ISO 3166-1 alpha-2, e.g. "TH") biases the t…

Input parameters:

- `category` (string): Optional category filter (e.g. laser-printer, skincare, mechanical-keyboards)
- `limit` (integer): Max results
- `market` (string): Buyer market as ISO 3166-1 alpha-2 country code (e.g. "TH", "AU"). Biases the tier3 live lookup toward that market and scopes its cache. Pass whenever the buyer's location is known.
- `q` (string, required): Natural-language query. Supports budget hints (e.g. "under $150").
- `specs` (object): Hard spec facets, e.g. {"form_factor":"desktop","print_speed_ppm":33}. Filters by exact/range spec match.

Output parameters:

- `count` (number)
- `parsed` (object)
- `query` (string)
- `results` (array)
- `tier3` (object)
- `took_ms` (number)

### `find_products` (~368 tokens)

Discover and verify products for a need

Discover candidate products for a buyer need the verified catalog does not cover, and verify each one. Takes a need in natural language (e.g. "best value home espresso machine", market "TH"), runs a live web search, and returns up to 3 candidates, each independently checked by a live lookup against a fetched source page.

This applies when the need is described rather than named and search_catalog returned weak_match or nothing. For a specific brand+model, search_catalog is cheaper and returns the same live-lookup block on a miss.

Response fields:
• candidates[].verification — always "live-unverified": each candidate is a single-source reading of the page at candidates[].source_url, not an AirShelf-verified catalog record.
• candidates[].status — "resolved" means MPN-confirmed against that page; "abstain" means the product could not be confirmed to exist as named, so no specs, price, or availability were established.
• Candidates come from current web-search results, so they are a sample of what the market offers rather than a ranking.
• status at the top level — "disabled" or "rate_limited" means no discovery ran.

Optional `market` (ISO 3166-1 alpha-2) biases both discovery and each verification toward that country's retailers and scopes the lookup cache.

Input parameters:

- `market` (string): Buyer market as ISO 3166-1 alpha-2 country code (e.g. "TH"). Biases discovery + verification and scopes the cache.
- `max` (integer): Max candidates to verify (each costs a live lookup; capped at 3).
- `need` (string, required): The buyer need in natural language, e.g. "quiet mechanical keyboard for open office" or "best value home espresso machine".

Output parameters:

- `candidates` (array)
- `error` (string)
- `guidance` (string)
- `market`
- `need` (string)
- `serp_considered` (number)
- `status` (string)
- `took_ms` (number)
- `verification` (string)

### `get_product` (~81 tokens)

Get product details

Get the full golden record and latest price for one catalog product by slug ("<manufacturer>-<model>").

Returns the product's specs and provenance, plus canonical_name (its exact catalog name). In clients that render MCP Apps the response also draws one product card per call.

Input parameters:

- `slug` (string, required): Composite slug, e.g. keychron-q1-pro

Output parameters:

- `action` (string)
- `benefits` (array)
- `buttonLabel` (string)
- `buyUrl` (string)
- `imageUrl` (string)
- `pricing_gated` (boolean)
- `product` (object)
- `productId` (string)
- `title` (string)

### `compare_products` (~174 tokens)

Compare products

Compare 2-10 catalog products side-by-side on their datasheet specs. Slugs come from search_catalog and are case-insensitive and dash-tolerant ("e-STUDIO 331AC", "toshiba-e-studio-331ac" and "e-studio331ac" all resolve to the same product).

Returns one item per product with canonical_name and spec_absence_note (spec fields absent from that product's golden record). A slug that does not resolve comes back as not_found with a did_you_mean suggestion. Set `provenance` to include per-claim sources, a signed-attestation URL, and jwks_url.

Input parameters:

- `provenance` (boolean): Include per-claim source provenance + signed-attestation URL + jwks_url
- `slugs` (array, required): Catalog slugs to compare

Output parameters:

- `count` (number)
- `items` (array)

### `explain_product` (~52 tokens)

Explain how a record was built

Return the agentic build trace (BuilderRunTrace) for a SKU — every stage of the cold-run pipeline that produced this catalog row, including costs and outcomes.

Input parameters:

- `slug` (string, required): Composite slug to explain

Output parameters:

- `note` (string)
- `sku` (string)
- `slug` (string)
- `trace`

### `list_merchants` (~54 tokens)

List merchants

List the AirShelf merchants whose catalogs are searchable and who can receive a quote request, across every category. Returns each merchant's name, slug, and product count; the slug is the `merchant` argument for request_quote.

Output parameters:

- `merchants` (array)
- `total` (number)

### `request_quote` (~288 tokens)

Request a quote from a merchant

Send a quote request for catalog products to a merchant's sales team on behalf of a named buyer.

This is a two-step, double opt-in flow. The first call emails a confirmation link to `contact.email` and returns status "confirmation_required" — at that point no lead exists and the merchant has not been contacted. The buyer opens that email and confirms, and confirming is what sends their details onward. A later call with the same arguments reports where the request stands: "awaiting_confirmation" while the email is unconfirmed, or "received" with a reference_number once the buyer has confirmed.

Resolve `merchant` from list_merchants. For a brand list_merchants does not return (network-catalog brands), pass merchant:"airshelf-network" with brandSlug:"<manufacturer-slug>" and AirShelf routes the confirmed request to that brand.

Input parameters:

- `brandSlug` (string): Manufacturer slug (from search results) — required with merchant:"airshelf-network" so the lead reaches the right brand
- `contact` (object, required): Buyer contact details
- `merchant` (string, required): Merchant slug or id (from list_merchants), or "airshelf-network" for network-catalog brands
- `notes` (string): Any extra context from the buyer
- `products` (array, required): Catalog slugs the buyer is interested in
- `quantity` (integer): Units the buyer wants

Output parameters:

- `next_step` (string)
- `reference_number` (string)
- `status` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/ai-airshelf-catalog/mcp#diagnostics

## Score history

- 2026-08-03: 58
- 2026-08-02: 57
- 2026-08-01: 57
- 2026-07-31: 56
- 2026-07-30: 57
- 2026-07-29: 57
- 2026-07-28: 56
- 2026-07-27: 55
- 2026-07-26: 53

## Links

- Remote endpoint: https://mcp.airshelf.ai/mcp
- Changelog RSS feed: https://verifymcp.io/servers/ai-airshelf-catalog/mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/ai-airshelf-catalog/mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/ai-airshelf-catalog/mcp