From materials-project
Use when querying the Materials Project database for crystal structures, material properties, or generating phase diagrams. Requires the MP_API_KEY environment variable to be set.
How this skill is triggered — by the user, by Claude, or both
Slash command
/materials-project:materials-projectThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Query the Materials Project database for structures, properties, and thermodynamic data.
Query the Materials Project database for structures, properties, and thermodynamic data.
| Scenario | Recommended Tool | Why |
|---|---|---|
| Retrieving known crystal structures, band gaps, or phase diagrams from a curated database | Materials Project API | Fast access to DFT-computed data without running calculations |
| Exploring structures when no API key is available | AFLOW / OQMD web interface | Alternative open databases with overlapping coverage |
| Running custom DFT on a modified structure | ASE + VASP / CP2K / PySCF | Materials Project gives starting points, not bespoke calculations |
Key rule: Use the Materials Project API when you need experimentally or computationally validated structures and properties without running fresh quantum chemistry calculations.
export MP_API_KEY="your_key_here"
python scripts/query_materials.py --formula Fe2O3
python scripts/query_materials.py --material-id mp-149
Generate phase diagrams for a chemical system.
python scripts/query_materials.py --chemsys Li-Fe-O --phase-diagram
Results are printed as JSON to stdout. Structures can be saved as CIF files with --save-cif <dir>.
MP_API_KEY. All requests will fail immediately with an authentication error.energy_above_hull == 0 alone to guarantee synthesizability. It indicates thermodynamic stability in the DFT phase diagram, not kinetic accessibility.energy_above_hull to find stable phases; values closer to zero are more thermodynamically stable.--save-cif if you plan to feed them into ASE, VASP, or visualization tools.WebFetch on https://docs.materialsproject.org/ before answering.| Error / Symptom | Likely Cause | Fix |
|---|---|---|
MP_API_KEY environment variable not set | Missing API key | Export MP_API_KEY before running the script |
| Connection error or timeout | Network issue or API rate limiting | Retry after a short delay or check Materials Project status page |
| Empty results for a formula | No matching entries in the database | Try a different formula formatting or search by element chemsys |
ValueError during phase diagram generation | Entry mismatch or unsupported chemsys | Verify the chemsys string uses valid elements separated by hyphens |
| Missing properties in response | Data field not available for that material | Check the Materials Project documentation for field availability by version |
If the user asks about recently added features, new data fields, or version-specific syntax changes, use WebFetch on the official documentation at https://docs.materialsproject.org/ before answering.
Searches MemPalace before answering questions about past work, people, projects, or prior decisions. Returns verbatim stored content instead of guessing from model memory.
Guides Payload CMS config (payload.config.ts), collections, fields, hooks, access control, APIs. Debugs validation errors, security, relationships, queries, transactions, hook behavior.
Implements vector databases with Pinecone, Weaviate, Qdrant, Milvus, pgvector for semantic search, RAG, recommendations, and similarity systems. Optimizes embeddings, indexing, and hybrid search.
npx claudepluginhub wugroup-xjtlu/cc-skills-zhenghaowu-group --plugin materials-project