Overview
Features
MCP Resources on demand
Access on-demand optimade:// resources (docs/filters, spec/queryable_props, docs/providers, docs/filter_presets, prompts, and results) to guide filtering and query execution.
Linting tool for filters
lint_filter(filter) validates syntax and whitelist compliance, returning 'ok', 'warn: …', or 'syntax error: …'.
OPTIMADE query generation and preview
query_optimade(filter, baseUrls?) returns a preview (first 5 results) and a link to the full JSON result resource.
Provider discovery
list_providers() discovers global public OPTIMADE endpoints.
Provider fallback
If baseUrls is omitted or unavailable, the server falls back from user-provided to config defaults to a public mirror (https://optimade.fly.dev).
Deployment via uvx/cline
Easily deployable via uvx and cline with a simple JSON manifest.
Proxy support
Proxy-ready via .env (HTTP_PROXY, HTTPS_PROXY) for VPNs or corporate networks.
Result persistence and summarization
OPTIMADE responses are saved locally under optimade://results/<uuid> and a session summary is generated during interaction.
Who Is This For?
- Materials scientists:Query compositional data and crystal structures across OPTIMADE databases using natural language prompts.
- AI/ML developers:Integrate natural-language prompts to generate OPTIMADE filters and retrieve results.




