Loading documentation…
Loading documentation…
Connect an MCP-compatible agent to the hosted API or the thin local adapters. The adapter is only a transport boundary; auth, credits, and product data stay in the API.
Start here when your application already uses a compatible tool client. The documented hosted endpoint is https://simlir.com/api/v1/mcp. Use a server or agent configuration that supports bearer headers. The endpoint and release-candidate adapters use the same three tool names and public response contract.
{
"mcpServers": {
"simlir": {
"url": "https://simlir.com/api/v1/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}@simlir/mcp-server
export SIMLIR_API_KEY=YOUR_API_KEY
npx @simlir/mcp-serversimlir-mcp
export SIMLIR_API_KEY=YOUR_API_KEY
simlir-mcp| Tool | Purpose | Cost |
|---|---|---|
| simlir_search_products | Semantic product search | 2 credits |
| simlir_search_products_by_image | Visual search from a hosted HTTPS image URL | 3 credits |
| simlir_lookup_products_by_identifier | Exact GTIN, MPN/model number, or retailer SKU lookup | 1 credit |
Required market code
gb, us, de, fr, es, it, au, ca
Beta catalogue
United Kingdom currently live. United States planned next.
Tool/API credits
Semantic 2 · visual 3 · exact lookup 1 · product 1
Images
Hosted HTTPS image_url only for visual search
Errors
400, 401, 402, 403, 404, 405, 413, 429, 500, 502
Store the key in the host's secret store or environment injection. Do not commit it, send it as a query parameter, log it, or expose it to browser JavaScript. MCP stdout must remain JSON-RPC transport; diagnostics belong in safe, metadata-only logs.
Create an account, generate a key, and use the same market-scoped contract from any channel. Keep keys in a server-side secret manager; never put one in a browser bundle, checked-in config, or support ticket.
Existing v1 Bearer keys and endpoints remain the compatibility baseline. There are no user-selectable scopes or sandbox environments today; the public demo and dashboard playground are separate evaluation surfaces, not alternate API environments.