{"library":"mp-api","title":"Materials Project API Client","description":"mp-api is the official Python client for the Materials Project API, providing programmatic access to the vast Materials Project database. It features the MPRester class for easy data retrieval and is actively maintained with frequent updates to align with the evolving API and new data methodologies.","language":"python","status":"active","last_verified":"Sat May 16","install":{"commands":["pip install mp-api"],"cli":null},"imports":["from mp_api.client import MPRester"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import os\nfrom mp_api.client import MPRester\n\n# Set your Materials Project API key as an environment variable\n# Example: export MP_API_KEY=\"YOUR_API_KEY_HERE\"\n# You can find your API key on your Materials Project profile dashboard.\n\napi_key = os.environ.get('MP_API_KEY', '')\n\nif not api_key:\n    print(\"Error: MP_API_KEY environment variable not set. Please set it to your Materials Project API key.\")\nelse:\n    try:\n        with MPRester(api_key) as mpr:\n            # Fetch summary data for silicon (material_id: mp-149)\n            material_id = \"mp-149\"\n            docs = mpr.materials.summary.search(material_ids=[material_id])\n            if docs:\n                print(f\"Material ID: {docs[0].material_id}\")\n                print(f\"Formula: {docs[0].formula_pretty}\")\n                print(f\"Band gap: {docs[0].band_gap} eV\")\n            else:\n                print(f\"No data found for material ID: {material_id}\")\n    except Exception as e:\n        print(f\"An error occurred: {e}\")","lang":"python","description":"This quickstart demonstrates how to instantiate the `MPRester` client using an API key from an environment variable and retrieve basic summary information for a material. You need a Materials Project API key, obtainable from your profile dashboard, to run this example.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-16","installed_version":"0.45.9","pypi_latest":"0.46.1","is_stale":true,"summary":{"python_range":"3.10–3.9","success_rate":50,"avg_install_s":36.5,"avg_import_s":16.39,"wheel_type":"sdist"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"mp-api","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"mp-api","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"broken","install_time_s":33.4,"import_time_s":null,"mem_mb":null,"disk_size":"621M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"mp-api","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"mp-api","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":35,"import_time_s":16.94,"mem_mb":210.3,"disk_size":"975M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"mp-api","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"mp-api","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":34.9,"import_time_s":16.98,"mem_mb":201.6,"disk_size":"942M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"mp-api","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"mp-api","exit_code":0,"wheel_type":"sdist","failure_reason":null,"import_side_effects":"clean","install_time_s":36.1,"import_time_s":15.26,"mem_mb":201.1,"disk_size":"938M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"mp-api","exit_code":1,"wheel_type":null,"failure_reason":"build_error","import_side_effects":null,"install_time_s":null,"import_time_s":null,"mem_mb":null,"disk_size":null},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"mp-api","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"broken","install_time_s":42.9,"import_time_s":null,"mem_mb":null,"disk_size":"660M"}]}}