@simlir-ai/mcp-server

@simlir-ai/mcp-server

The published Node.js Model Context Protocol adapter for the Simlir public product intelligence API is available on npm as @simlir-ai/mcp-server version 0.1.1 under Apache-2.0. The package is open source; installing the adapter does not provide free access to the Simlir service. API access still requires a Simlir account, API key, and any applicable credits or plan entitlement.

This package is intentionally separate from Simlir's repository-intelligence MCP server. It contains no ingestion code, customer data, database credentials, or repository tooling.

The npm package contains only the adapter and its public integration contract. Simlir's ingestion methods, backend code, database, customer data, service, and trademarks remain outside the Apache-2.0 licence.

Supported tools

Tool	API operation	Credits
simlir_search_products	Semantic product search	2
simlir_search_products_by_image	Visual product search with optional natural-language context	3
simlir_lookup_products_by_identifier	Exact GTIN/MPN/SKU lookup	1

The tool names, inputs, market set, response envelopes, and error handling are bound to the checked-in public contract at public/api/openapi.json.

Local configuration

export SIMLIR_API_KEY=sk_your_key_here
npx @simlir-ai/mcp-server

Get an API key at https://simlir.com/dashboard/sign-up?ref=mcp-node.

Claude Desktop, Cursor, or VS Code

{
  "mcpServers": {
    "simlir": {
      "command": "npx",
      "args": ["@simlir-ai/mcp-server"],
      "env": {
        "SIMLIR_API_KEY": "${SIMLIR_API_KEY}"
      }
    }
  }
}

See examples/claude-desktop.json for the copy-paste configuration. Do not put a real API key in a checked-in config.

Development

npm install
npm run contract:check
npm test
npm run pack:check

The package uses HTTPS by default, validates all user inputs, caps request timeouts and retries, does not log query strings or response bodies, and keeps MCP stdout reserved for JSON-RPC transport.

For image search, pass image_url and market. Add the optional query field when the image should be combined with requirements such as “slim fridge freezer for a small flat” or “vegan protein suitable for cutting”. The image remains the visual signal; the context supplies the shopper’s semantic intent.

Support and maintenance

• Documentation: https://simlir.com/docs/mcp-setup
• API key support: https://simlir.com/dashboard/sign-up?ref=mcp-node
• Security reports: use Simlir's security contact until the public repository security policy is published.

API response changes must update the canonical spec first, then this adapter's contract version and tests. Never hand-edit a copied response field list.