# holdmark · facts about online stores

> holdmark · facts about online stores is a free MCP server for e-commerce. Read-only registry of online store delivery and refund facts, for agents and scripts. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://holdmark.org/api
- **MCP Registry name:** org.holdmark/registry
- **Categories:** e-commerce, analytics and data
- **Listing updated:** 2026-11-15

## About

Every fact in the holdmark registry comes with its answer, its source and the period it covers. A store's file says whether it delivers orders (measured with carriers) and whether it refunds money (measured with payment processors), and adds bank claims per 1,000 orders and a verified-order volume band such as "+50.000".

The registry deliberately does not rank or score stores. Listings default to alphabetical order, the caller sorts and filters, and the merchant's category is shown as declared rather than checked. Figures are rounded against the merchant, volume is given only as a band, and anything unmeasured (customer service, product quality, opinions) is listed in a not_measured field. If there is too little data, a fact answers not_measured instead of "no".

The same data is reachable over a streamable HTTP MCP endpoint and a keyless JSON API. The API allows 120 requests per minute per address, responses can be cached for five minutes, and data is recalculated daily. Only stores that connected their data are included, so a missing store says nothing about it.

## Features

- **Delivery and refund facts:** Each store file answers whether orders are delivered and money is refunded, with the source named.
- **Source and period on every fact:** Facts carry the data source (carrier or payment processor) and the period they cover.
- **Rounded against the merchant:** Favourable figures round down and unfavourable ones round up, so a store never looks better than measured.
- **Volume in bands:** Order volume is reported as a band, never an exact count.
- **Filterable store listing:** List stores by declared category or whether they meet the published limits, and sort by any figure.
- **Explicit not-measured field:** Customer service, product quality and opinions are declared as outside the registry.

## Good for

- Check whether an online store delivers and refunds before an assistant recommends a purchase
- Compare stores in a category using the same measured facts
- Build a script that pulls a store's file by domain
- Add store-reliability facts to a shopping assistant

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http registry https://holdmark.org/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://holdmark.org/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "registry": {
      "url": "https://holdmark.org/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "registry": {
      "type": "http",
      "url": "https://holdmark.org/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "registry": {
      "serverUrl": "https://holdmark.org/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "registry": {
      "type": "http",
      "url": "https://holdmark.org/mcp"
    }
  }
}
```

## FAQ

### Do I need an API key?

No. The API docs say reading is free, keyless and needs no registration.

### Can the registry change a store's file?

No. It is read-only; nobody can edit a file from outside, including by paying.

### What are the rate limits?

Up to 120 requests per minute from one address; beyond that the API returns 429.

### What happens if a store is not listed?

The API returns 404 with not_in_registry. Only stores that connected their data are included, and absence is not a judgement.

### May I reuse the data?

Yes, with attribution to holdmark.org and a link to the store's file, and without presenting it as a recommendation or guarantee.

### Is holdmark · facts about online stores free?

Yes. holdmark · facts about online stores is free to use.

### How do I add holdmark · facts about online stores to Claude Code?

Run this command in your terminal: claude mcp add --transport http registry https://holdmark.org/mcp

### What are the best alternatives to holdmark · facts about online stores?

The closest alternatives to holdmark · facts about online stores are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and O'So MCP Server for PrestaShop.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.

---
Source: https://ai-powered.com/mcp/holdmark-facts-about-online-stores
