simlir-mcp

Corrected release candidate (simlir-mcp 0.1.1) 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 and its published-package install/runtime smoke are verified. Corrected 0.1.1 metadata, project URLs, and the publication workflow are prepared locally; republish and a fresh published-package smoke remain pending. 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 .