simlir-mcp

Release 0.1.2 (simlir-mcp) providing a thin Python stdio adapter around the simlir public product API. It is intentionally separate from Simlir’s internal repository-intelligence MCP server and contains no ingestion code, customer data, database credentials, or internal repository tooling.

The historical PyPI 0.1.0 publication remains audit history, and 0.1.1 remains the preceding public release. Version 0.1.2 refreshes the public project description so it records the completed publication, clean install, MCP initialise/tools/list, and one authenticated read-only published-package smoke without repeating the earlier pre-publication wording. Support, rollback, and MCP directory acceptance remain separate gates; publication does not imply that those gates are complete. The public adapter artefact is licensed under Apache-2.0, as recorded by Joe Close, co-founder and legal/commercial reviewer. That licence covers this package’s source, generated types, fixtures, examples, and documentation; it does not grant rights to Simlir trademarks, the hosted service, returned data, or Simlir’s internal implementation. Support, rollback, and MCP directory acceptance remain separate gates; publication is not evidence that those gates are complete.

Local use

Install the published SDK and adapter:

python -m pip install simlir simlir-mcp
export SIMLIR_API_KEY=sk_your_key_here
python -m simlir_mcp

The adapter keeps JSON-RPC responses on stdout and writes only structured, metadata-only diagnostics to stderr. Never put an API key in a checked-in configuration file.

Claude Desktop, Cursor, or VS Code

The intended local configuration is:

{
  "mcpServers": {
    "simlir": {
      "command": "simlir-mcp",
      "env": {
        "SIMLIR_API_KEY": "${SIMLIR_API_KEY}"
      }
    }
  }
}

Supported tools

Tool names, required arguments, markets, and response shapes are pinned to the checked-in public contract. Update the contract first, then regenerate or update both MCP adapters and their tests when the public API changes.

The image tool requires image_url and market. Its optional query field adds shopper context such as a size, product role, compatibility requirement, or use case; Simlir combines that context with the visual signal. Image-only calls remain valid.

Development

PYTHONPATH=../python-sdk/src:src python -m unittest discover -s tests -p 'test_*.py'
python -m compileall -q src
python -m pip wheel --no-deps --no-build-isolation --wheel-dir /tmp/simlir-python-mcp-wheel .