protogrid

Search / com.osmanth/shop-search

Osmanth Shop Search

R1· needs a key

Live product search for AI agents across Shopify merchants and major retailers.

v0.2.1 · active · repository · website · descriptor JSON · versions

An agent can connect on its own if it already holds X_API_KEY, X_API_KEY.Remote endpoint behind a static API key or header. The registry never sees the value; the agent fills the placeholder.
Quality81new
Trust66of 100
Uptime, 30 days43%
Latency p50258 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "shop-search": {
      "type": "http",
      "url": "https://api.osmanth.com/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}
claude mcp add --transport http shop-search https://api.osmanth.com/mcp --header "X-API-Key: ${X_API_KEY}" --header "Authorization: ${X_API_KEY}"
[mcp_servers.shop-search]
url = "https://api.osmanth.com/mcp"
env_http_headers = { "X-API-Key" = "X_API_KEY", "Authorization" = "X_API_KEY" }
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "shop-search": {
      "type": "remote",
      "url": "https://api.osmanth.com/mcp",
      "enabled": true,
      "headers": {
        "X-API-Key": "{env:X_API_KEY}",
        "Authorization": "{env:X_API_KEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "shop-search": {
      "type": "http",
      "url": "https://api.osmanth.com/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=shop-search&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vYXBpLm9zbWFudGguY29tL21jcCIsImhlYWRlcnMiOnsiWC1BUEktS2V5IjoiJHtYX0FQSV9LRVl9IiwiQXV0aG9yaXphdGlvbiI6IiR7WF9BUElfS0VZfSJ9fQ%3D%3D"
}
{
  "servers": {
    "shop-search": {
      "type": "http",
      "url": "https://api.osmanth.com/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}
{
  "mcpServers": {
    "shop-search": {
      "httpUrl": "https://api.osmanth.com/mcp",
      "headers": {
        "X-API-Key": "${X_API_KEY}",
        "Authorization": "${X_API_KEY}"
      }
    }
  }
}
extensions:
  "shop-search":
    enabled: true
    name: "shop-search"
    type: streamable_http
    uri: "https://api.osmanth.com/mcp"
    headers:
      "X-API-Key": "${X_API_KEY}"
      "Authorization": "${X_API_KEY}"
    timeout: 300

Placeholders to fill from your own secret store: ${X_API_KEY}, ${X_API_KEY}. The registry never accepts secret values.

Quality 81 / 100new

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene86 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations1 of 1 tools declare readOnlyHint or destructiveHint
  • fail
    tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: search_products (destructiveHint, idempotentHint)
  • pass
    tools.token_costabout 258 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stabilityn/a · weight 15
  • n/a
    stability.changes, stability.rug_pulltool history recorded for 2 of the 7 days needed
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

1 tools, about 258 tokens to load them all · tool set 3d1037dfb227 · checked 2026-11-07 18:01 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 66 / 100

provenance85
liveness0
freshness100
hygiene100

+repository +dns-namespace +website -unreachable(2 failures) +updated-3d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://api.osmanth.com/mcp streamable-httpapi_key ${X_API_KEY}yes43%258 ms2025-11-252026-11-07

Tools (1)

search_productsread-onlySearch live products across Shopify merchants (Shopify Global Catalog) and major retailers (Channel3). Returns normalized products with title, price, currency, merchant, buy_url, image_url, ships_to and source. Always show the `disclosure` text to the user near the links. Do not cache results.

Schemas: list_tools.

Also listed as

1 other active names share this repository: com.osmanth/agent-hub

Similar MCP servers

More from com.osmanth

Official server.json
{
  "name": "com.osmanth/shop-search",
  "title": "Osmanth Shop Search",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://api.osmanth.com/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "X-API-Key",
          "isSecret": true,
          "isRequired": true,
          "description": "Free API key from https://api.osmanth.com/keys"
        }
      ]
    }
  ],
  "version": "0.2.1",
  "repository": {
    "url": "https://github.com/fcubeve-alt/osmanth-mcp",
    "source": "github",
    "subfolder": "shop-search"
  },
  "websiteUrl": "https://api.osmanth.com/",
  "description": "Live product search for AI agents across Shopify merchants and major retailers."
}