Materials Project

The Materials Project API provides direct access to the Materials Project database, a large-scale computational materials science database with data on tens of thousands of materials. The API is offered free of charge and supports machine learning, automated analysis, and bulk data downloads.

Materials Project publishes 29 API contracts indexed on the APIs.io network, including Defect Tasks API, JCESR Electrolyte Genome API, Materials Absorption API, and 26 more. Tagged areas include Chemistry, Materials Science, Physics, Research, and Scientific Computing.

The Materials Project catalog on APIs.io includes 1 Spectral governance ruleset.

Materials Project’s developer surface includes authentication, developer portal, documentation, signup flow, and 9 more developer resources.

🌐 Visit website 📡 Profile data on GitHub

33.8/100 thin ▬ flat Agent 34/100 agent ready Heartbeat 100/100 alive saas Full breakdown ↓
scored 2026-11-06 · rubric v0.27.0 · Show this score on your site →

AccessFreemiumSelf serve⚡ Free to try

1 published contract 1 MCP Servers

Chemistry Materials Science Physics Research Scientific Computing

What this lets a business do 1

Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →

Data & Reference Information Services

AE-230

DOIs

GET /doi/

Kin Score

Kin Score How this is scored →
scored 2026-11-06 · rubric v0.27.0

Composite quality — 33.8/100 · thin

Contract Quality 8.8 / 19

Developer Ergonomics 6.4 / 15

Access Clarity 3.2 / 15

Operational Transparency 1.0 / 10

Contract Governance 1.2 / 9

Discoverability 5.6 / 8

Regulatory Posture 1.8 / 15

Create-or-Update Ergonomics 0.0 / 10

Agent readiness — 34/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Pagination 5 / 5

Distinct Operations 0 / 3

MCP Tool Quality 6 / 6

Regulatory Posture applies to this provider. Its tags matched the Horizontal (data, software, accessibility, platform) regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

The six quality facets above are damped to 75 points between them, because the conditional facet above carries the other 25. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 75% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

Show this score on your site.

It updates itself when the score changes. Paste this where you link to your API docs:

<a href="https://apis.io/providers/materials-project/"><img src="https://apis.io/badge/materials-project/card.svg" alt="Materials Project on APIs.io — Kin Score by API Evangelist"></a>

Other styles, a README pill and a shields.io endpoint are on the badge page.

Raise your score.

Agent readiness — checks not met, largest first (exact, from this profile):

Idempotency +9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
A2A Agent Card +8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Request/Response Examples +7 pts — share of operations carrying request/response examples; else an Examples / Code Samples link
Registration Without a Human +6 pts — a `registration_endpoint` in the served RFC 8414 / OIDC discovery document
Delegated User Identity +6 pts — a served discovery document listing authorization_code in grant_types_supported (served), else an oauth2 authorizationCode flow or openIdConnect declared in an OpenAPI (documented)
Typed Event Surface +6 pts — AsyncAPI document, OR webhooks/callbacks objects in the as-published OpenAPI, OR common[].type includes Webhooks

8 more unmet checks in the Agent Readiness table above.

Kin Score — facets with the most composite points still available (weight × headroom):

Access Clarity scores 21.1 — up to +15.8 composite points
Contract Quality scores 46.9 — up to +13.3 composite points
Operational Transparency scores 10.5 — up to +11.6 composite points

Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from the provider profile at artifacts.apis.io/materials-project/apis.yml: open an issue on github.com/api-evangelist/materials-project to ask a question or point us at an artifact you publish. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Markets this provider is in provisional

The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.

Market	Position	Depth	Registered MCP server	Declares compatibility
Chemistry and Materials (chemical data depositors, materials-data APIs)	standard	17.2 (thin)	-	-

Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.

Standards implemented 2

Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.

Model Context Protocol (MCP)

measured — observed by APIs.io (verified)

OpenAPI

measured — observed by APIs.io (published)

APIs 29

Individual APIs this provider publishes, each with its own machine-readable definition.

Materials Project Defect Tasks API

The Defect Tasks API from Materials Project — 1 operation(s) for defect tasks.

Materials Project JCESR Electrolyte Genome API

Route providing computed data for a legacy molecule such as charge, electron affinity, and ionization energy. The unique identifier for a molecule is its `task_id` (e.g. `mol-45...

Materials Project Materials Absorption API

The Materials Absorption API from Materials Project — 1 operation(s) for materials absorption.

Materials Project Materials Alloys API

Route for retrevial of information about which hypothetical alloy(s) a given material might belong to, following the methodolgy discussed by [Woods-Robinson, Horton and Persson]...

Materials Project Materials API

Route for "core" information associated with a given material in the Materials Project database. The unique identifier for a material is its `material_id` (e.g. `mp-149`). Core ...

Materials Project Materials Bonds API

Route for retrevial of bonding information for a given material.

Materials Project Materials Chemical Environment API

The Materials Chemical Environment API from Materials Project — 1 operation(s) for materials chemical environment.

Materials Project Materials Dielectric API

Route providing computed dielectric data for a material following the methodology discussed by [Petousis *et al.*](https://doi.org/10.1038/sdata.2016.134) Note that dielectric d...

Materials Project Materials Elasticity API

Route providing computed elasticity data for a material following the methodology discussed by [de Jong *et al.*](https://doi.org/10.1038/sdata.2015.9) Note that elasticity data...

Materials Project Materials Electrodes API

Route providing computed electrode data for a material following the methodology discussed by [Shen *et al.*](https://doi.org/10.1038/s41524-020-00422-3) Note that electrode dat...

Materials Project Materials Electronic Structure API

Routes providing computed electronic structure related data for a material such as band gap and fermi level. Python objects for line-mode band structures, density of states, and...

Materials Project Materials EOS API

Route providing computed equations of state data for a material following the methodology discussed by [Latimer *et al.*](https://doi.org/10.1038/s41524-018-0091-x) Note that eq...

Materials Project Materials Grain Boundaries API

Route providing computed grain boundary data for a material following the methodology discussed by [Hui *et al.*](https://doi.org/10.1016/j.actamat.2019.12.030) Note that grain ...

Materials Project Materials Magnetism API

Route providing computed magnetic ordering related data for a material following the methodology discussed by [Horton *et al.*](https://doi.org/10.1038/s41524-019-0199-7) Note t...

Materials Project Materials Oxidation States API

Route providing computed oxidation state data for a material following the methodology employed by the [BVAnalyzer](https://pymatgen.org/pymatgen.analysis.bond_valence.html) in ...

Materials Project Materials Phonon API

**Under construction** Route providing computed phonon data for a material following the methodology discussed by [Petretto *et al.*](https://doi.org/10.1038/sdata.2018.65) Note...

Materials Project Materials Piezoelectric API

Route providing computed piezoelectric data for a material following the methodology discussed by [de Jong *et al.*](https://doi.org/10.1038/sdata.2015.53) Note that piezoelectr...

Materials Project Materials Provenance API

Route providing provenance data for a material such as whether it is theoretical, its associated ICSD entries, and relevant references in literature. Note that provenance data m...

Materials Project Materials Robocrystallographer API

Route providing a computed text description for a material following the methodology discussed by [Ganose *et al.*](https://doi.org/10.1557/mrc.2019.94) Note that descriptions m...

Materials Project Materials Similarity API

Route providing a computed similarity metric between materials following the methodology discussed by Zimmerman *et al.* in [10.3389/fmats.2017.00034](https://doi.org/10.3389/fm...

Materials Project Materials Substrates API

Route providing computed suggested substrate data for a material following the methodology discussed by [Ding *et al.*](https://doi.org/10.1021/acsami.6b01630) Note that substra...

Materials Project Materials Summary API

Route providing a large amount of amalgamated data for a material. This is constructed by combining subsets of data from many of the other API endpoints. The summary endpoint is...

Materials Project Materials Surface Properties API

Route providing computed surface property data for a material following the methodology discussed by [Tran *et al.*](https://doi.org/10.1038/sdata.2016.80) Note that surface dat...

Materials Project Materials Synthesis API

Route providing a synthesis recipes for materials extracted from literature following the methodology discussed by [Kononova *et al.*](https://doi.org/10.1038/s41597-019-0224-1)...

Materials Project Materials Tasks API

Route for "core" information associated with a given calculation in the Materials Project database. Multiple calculations can ultimately be associated with a unique material, an...

Materials Project Materials Thermo API

Route providing computed thermodynamic data for a material such as formation energy and energy above hull. Corrected energy values are also available that employ the schemes dis...

Materials Project Materials XAS API

Route providing computed x-ray absorption spectroscopy data for a material following the methodology discussed by [Mathew *et al.*](https://doi.org/10.1038/sdata.2018.151) and [...

Materials Project Molecules Summary API

Route for a summary of all data calculated on 'core' molecules in the Materials Project molecules database. See the `MoleculeSummaryDoc` schema for a full list of fields returne...

Materials Project DO Is API

Route providing DOI and bibtex reference information for a material. Note that this data may not be available for all materials in the Materials Project database. See the `DOIDo...

Scroll for all 29

Open Collections 30

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Materials Project Defect Tasks API

OPEN COLLECTION

Materials Project Defect Tasks DOIs API

OPEN COLLECTION

Materials Project Defect Tasks JCESR Electrolyte Genome API

OPEN COLLECTION

Materials Project Defect Tasks Materials Absorption API

OPEN COLLECTION

Materials Project Defect Tasks Materials Alloys API

OPEN COLLECTION

Project Defect Tasks Materials API

OPEN COLLECTION

Materials Project Defect Tasks Materials Bonds API

OPEN COLLECTION

Materials Project Defect Tasks Materials Chemical Environment API

OPEN COLLECTION

Materials Project Defect Tasks Materials Dielectric API

OPEN COLLECTION

Materials Project Defect Tasks Materials Elasticity API

OPEN COLLECTION

Materials Project Defect Tasks Materials Electrodes API

OPEN COLLECTION

Materials Project Defect Tasks Materials Electronic Structure API

OPEN COLLECTION

Materials Project Defect Tasks Materials EOS API

OPEN COLLECTION

Materials Project Defect Tasks Materials Grain Boundaries API

OPEN COLLECTION

Materials Project Defect Tasks Materials Magnetism API

OPEN COLLECTION

Materials Project Defect Tasks Materials Oxidation States API

OPEN COLLECTION

Materials Project Defect Tasks Materials Phonon API

OPEN COLLECTION

Materials Project Defect Tasks Materials Piezoelectric API

OPEN COLLECTION

Materials Project Defect Tasks Materials Provenance API

OPEN COLLECTION

Materials Project Defect Tasks Materials Robocrystallographer API

OPEN COLLECTION

Materials Project Defect Tasks Materials Similarity API

OPEN COLLECTION

Materials Project Defect Tasks Materials Substrates API

OPEN COLLECTION

Materials Project Defect Tasks Materials Summary API

OPEN COLLECTION

Materials Project Defect Tasks Materials Surface Properties API

OPEN COLLECTION

Materials Project Defect Tasks Materials Synthesis API

OPEN COLLECTION

Materials Project Defect Tasks Materials Tasks API

OPEN COLLECTION

Materials Project Defect Tasks Materials Thermo API

OPEN COLLECTION

Materials Project Defect Tasks Materials XAS API

OPEN COLLECTION

Materials Project Defect Tasks Molecules Summary API

OPEN COLLECTION

Materials Project API

OPEN COLLECTION

Scroll for all 30

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Materials Project MCP Server

Remote MCP server at docs.materialsproject.org over HTTP; 3 tools listed.

MCP SERVER

Materials Project API pricing

Not yet checked against Materials Project's own pricing page. Compiled by API Evangelist on 2026-05-04; confirm before you rely on a figure. A free plan or tier is listed.

Plan	Price
Free freemium	Free
Professional paid	Free
Enterprise enterprise	—

Plan details, limits and sources →

Rate limits

Free Tier Default: 10 requests per minute
Free Tier Monthly Quota: 1000 requests per month
Professional Tier Default: 100 requests per minute

Compiled by API Evangelist, not yet checked against Materials Project's documentation. All 5 limits →

Pricing Plans 1

Published pricing tiers and plan structures.

Materials Project Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Materials Project Rate Limits

5 limits

RATE LIMITS

Service Levels 1

Uptime the provider promises or reports, as SLA4OAI. Read from its own pages; APIs.io runs no monitors.

Materials Project

SLA

FinOps 1

Cost, billing, and metering signals for API financial operations.

Materials Project Finops

FINOPS

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Materials Project API Rules

52 rules · 42 errors 9 warnings 1 info

SPECTRAL

Security Posture 2

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Materials Project Authentication

apiKey · 1 scheme

SECURITY

Materials Project Domain Security

TLSv1.3

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Materials Project Agentic Access

41 operations

41 operations · 0 acting

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

Portal

Portal

Signup

Signup

Documentation 1

Reference material describing how the API behaves

Documentation

Documentation

Agent Surfaces 2

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

LlmsText

LlmsText

Build 1

SDKs, sample code, and the tooling you integrate with

GitHubOrganization

GitHubOrganization

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Operate 1

Status, limits, changes, and where to get help

RateLimits

RateLimits

Commercial 2

Pricing, plans, and the legal terms of use

Plans

Plans

FinOps

FinOps

Company 1

The organization behind the API

Website

Website

Other 1

Properties that don't map to a standard resource type

CapabilityMap

CapabilityMap

Source (apis.yml)

aid: materials-project
name: Materials Project
description: The Materials Project API provides direct access to the Materials Project database, a large-scale computational
  materials science database with data on tens of thousands of materials. The API is offered free of charge and supports machine
  learning, automated analysis, and bulk data downloads.
type: Index
deliveryModel:
  model: saas
  open_source: false
  commercial: true
  callable_host: true
  label: Hosted service · you call their endpoint
  confidence: high
  source:
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  gated: none
  gated_source:
  - onboarding
  label: Freemium · Self-serve signup
  confidence: medium
  source:
  - plans
  - authentication
  - security
  generated: '2026-11-06'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/materials-project.png
url: https://raw.githubusercontent.com/api-evangelist/materials-project/refs/heads/main/apis.yml
x-docs-platform: gitbook
x-docs-platform-confidence: high
x-docs-platform-checked: 2026-10-04
tags:
- Chemistry
- Materials Science
- Physics
- Research
- Scientific Computing
created: '2025-02-06'
modified: '2026-09-16'
specificationVersion: '0.23'
apis:
- aid: materials-project:materials-project-defect-tasks-api
  name: Materials Project Defect Tasks API
  description: The Defect Tasks API from Materials Project — 1 operation(s) for defect tasks.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Defect Tasks
  properties:
  - type: OpenAPI
    url: openapi/materials-project-defect-tasks-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-jcesr-electrolyte-genome-api
  name: Materials Project JCESR Electrolyte Genome API
  description: Route providing computed data for a legacy molecule such as charge,             electron affinity, and ionization
    energy. The unique identifier for a molecule             is its `task_id` (e.g. `mol-45807`). See the `MoleculesDoc` schema
    for a full list of             fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - JCESR Electrolyte Genome
  properties:
  - type: OpenAPI
    url: openapi/materials-project-jcesr-electrolyte-genome-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-absorption-api
  name: Materials Project Materials Absorption API
  description: The Materials Absorption API from Materials Project — 1 operation(s) for materials absorption.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Absorption
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-absorption-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-alloys-api
  name: Materials Project Materials Alloys API
  description: Route for retrevial of information about which hypothetical alloy(s) a given material might belong to, following
    the methodolgy discussed by [Woods-Robinson, Horton and Persson](https://arxiv.org/pdf/2206.10715).
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Alloys
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-alloys-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-api
  name: Materials Project Materials API
  description: Route for "core" information associated with a given material in the Materials Project             database.
    The unique identifier for a material is its `material_id` (e.g. `mp-149`). Core data in             this context refers
    to the crystal structure, information associated with it such as the density             and chemical formula, and the
    associated calculations which are identified with unique `task_id`             values. It does not contain any materials
    properties such as the formation energy or band gap, please             consult other property-specific endpoints for
    this information. See the `MaterialsDoc` schema for             a full list of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-bonds-api
  name: Materials Project Materials Bonds API
  description: Route for retrevial of bonding information for a given material.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Bonds
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-bonds-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-chemical-environment-api
  name: Materials Project Materials Chemical Environment API
  description: The Materials Chemical Environment API from Materials Project — 1 operation(s) for materials chemical environment.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Chemical Environment
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-chemical-environment-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-dielectric-api
  name: Materials Project Materials Dielectric API
  description: Route providing computed dielectric data for a material following the             methodology discussed by
    [Petousis *et al.*](https://doi.org/10.1038/sdata.2016.134)             Note that dielectric data has not been calculated
    for all materials in the Materials             Project database. See the `DielectricDoc` schema for a full list of fields
    returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Dielectric
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-dielectric-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-elasticity-api
  name: Materials Project Materials Elasticity API
  description: Route providing computed elasticity data for a material following the             methodology discussed by
    [de Jong *et al.*](https://doi.org/10.1038/sdata.2015.9)             Note that elasticity data has not been calculated
    for all materials in the Materials             Project database. See the `ElasticityDoc` schema for a full list of fields
    returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Elasticity
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-elasticity-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-electrodes-api
  name: Materials Project Materials Electrodes API
  description: Route providing computed electrode data for a material following the             methodology discussed by [Shen
    *et al.*](https://doi.org/10.1038/s41524-020-00422-3)             Note that electrode data has not been calculated for
    all materials in the Materials             Project database. See the `InsertionElectrodeDoc` and `ConversionElectrodeDoc`
    schema             for a full list of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Electrodes
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-electrodes-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-electronic-structure-api
  name: Materials Project Materials Electronic Structure API
  description: Routes providing computed electronic structure related data for a material such as             band gap and
    fermi level. Python objects for line-mode band structures, density of states, and             fermi surfaces are also
    available. This data was obtained following the methodology discussed by             [Munro *et al.*](https://doi.org/10.1038/s41524-020-00383-7)
    and [Ganose *et al.*](https://doi.org/10.21105/joss.03089)             Note that full band structure, density of states,
    and fermi surface data has not been calculated for             all materials in the Materials Project database. See the
    `ElectronicStructureDoc` and `FermiDoc` schema             for a full list of fields returned by the associated routes.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Electronic Structure
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-electronic-structure-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-eos-api
  name: Materials Project Materials EOS API
  description: Route providing computed equations of state data for a material following the             methodology discussed
    by [Latimer *et al.*](https://doi.org/10.1038/s41524-018-0091-x)             Note that equations of state data has not
    been calculated for all materials in the Materials             Project database. See the `EOSDoc` schema for a full list
    of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials EOS
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-eos-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-grain-boundaries-api
  name: Materials Project Materials Grain Boundaries API
  description: Route providing computed grain boundary data for a material following the             methodology discussed
    by [Hui *et al.*](https://doi.org/10.1016/j.actamat.2019.12.030)             Note that grain boundary data has not been
    calculated for all materials in the Materials             Project database. See the `GrainBoundaryDoc` schema for a full
    list of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Grain Boundaries
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-grain-boundaries-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-magnetism-api
  name: Materials Project Materials Magnetism API
  description: Route providing computed magnetic ordering related data for a material following the             methodology
    discussed by [Horton *et al.*](https://doi.org/10.1038/s41524-019-0199-7)             Note that magnetic data has not
    been calculated for all materials in the Materials             Project database. See the `MagnetismDoc` schema for a full
    list of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Magnetism
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-magnetism-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-oxidation-states-api
  name: Materials Project Materials Oxidation States API
  description: Route providing computed oxidation state data for a material following the             methodology employed
    by the [BVAnalyzer](https://pymatgen.org/pymatgen.analysis.bond_valence.html)             in Pymatgen. Note that oxidation
    state data has not been calculated for all materials in the Materials             Project database. See the `OxidationStateDoc`
    schema for a full list of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Oxidation States
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-oxidation-states-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-phonon-api
  name: Materials Project Materials Phonon API
  description: '**Under construction** Route providing computed phonon data for a material following the             methodology
    discussed by [Petretto *et al.*](https://doi.org/10.1038/sdata.2018.65)             Note that phonon data has not been
    calculated for all materials in the Materials             Project database. See the `PhononBSDOSDoc` schema for a full
    list of fields returned by this route.'
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Phonon
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-phonon-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-piezoelectric-api
  name: Materials Project Materials Piezoelectric API
  description: Route providing computed piezoelectric data for a material following the             methodology discussed
    by [de Jong *et al.*](https://doi.org/10.1038/sdata.2015.53)             Note that piezoelectric data has not been calculated
    for all materials in the Materials             Project database. See the `PiezoDoc` schema for a full list of fields returned
    by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Piezoelectric
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-piezoelectric-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-provenance-api
  name: Materials Project Materials Provenance API
  description: Route providing provenance data for a material such as whether it is theoretical,             its associated
    ICSD entries, and relevant references in literature. Note that provenance data             may not be available for all
    materials in the Materials Project database. See the `ProvenanceDoc`             schema for a full list of fields returned
    by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Provenance
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-provenance-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-robocrystallographer-api
  name: Materials Project Materials Robocrystallographer API
  description: Route providing a computed text description for a material following the             methodology discussed
    by [Ganose *et al.*](https://doi.org/10.1557/mrc.2019.94)             Note that descriptions may not been calculated for
    all materials in the Materials             Project database. See the `RobocrysDoc` schema for a full list of fields returned
    by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Robocrystallographer
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-robocrystallographer-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-similarity-api
  name: Materials Project Materials Similarity API
  description: Route providing a computed similarity metric between materials following the             methodology discussed
    by Zimmerman *et al.* in [10.3389/fmats.2017.00034](https://doi.org/10.3389/fmats.2017.00034)             and [10.1039/C9RA07755C](https://doi.org/10.1039/C9RA07755C).             Note
    that similarity data has not been calculated for all materials in the Materials             Project database. See the
    `SimilarityDoc` schema for a full list of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Similarity
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-similarity-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-substrates-api
  name: Materials Project Materials Substrates API
  description: Route providing computed suggested substrate data for a material following the             methodology discussed
    by [Ding *et al.*](https://doi.org/10.1021/acsami.6b01630)             Note that substrate data has not been calculated
    for all materials in the Materials             Project database. See the `SubstratesDoc` schema for a full list of fields
    returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Substrates
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-substrates-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-summary-api
  name: Materials Project Materials Summary API
  description: Route providing a large amount of amalgamated data for a material. This is constructed by             combining
    subsets of data from many of the other API endpoints. The summary endpoint is very useful for             performing queries
    for materials over a large property space. Note that every unique material within             the Materials Project should
    have a set of summary data. See the `SummaryDoc` schema for a full list of             fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Summary
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-summary-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-surface-properties-api
  name: Materials Project Materials Surface Properties API
  description: Route providing computed surface property data for a material following the             methodology discussed
    by [Tran *et al.*](https://doi.org/10.1038/sdata.2016.80)             Note that surface data has not been calculated for
    all materials in the Materials             Project database. See the `SurfacePropDoc` schema for a full list of fields
    returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Surface Properties
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-surface-properties-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-synthesis-api
  name: Materials Project Materials Synthesis API
  description: Route providing a synthesis recipes for materials extracted from literature             following the methodology
    discussed by [Kononova *et al.*](https://doi.org/10.1038/s41597-019-0224-1)             Note that synthesis recipes may
    not be available for all materials in the Materials             Project database. See the `SynthesisSearchResultModel`
    schema for a full list of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Synthesis
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-synthesis-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-tasks-api
  name: Materials Project Materials Tasks API
  description: Route for "core" information associated with a given calculation in the Materials Project             database.
    Multiple calculations can ultimately be associated with a unique material, and are the source             of its reported
    properties. The unique identifier for a calculation is its `task_id`. Note             that the `material_id` chosen for
    a given material is sourced from one of the `task_id` values             associated with it. Core data in this context
    refers to calculation quantities such as parsed input             and output data (e.g. VASP input flags, atomic forces,
    structures) and runtime statistics. See the             `TaskDoc` schema for a full list of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Tasks
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-tasks-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-thermo-api
  name: Materials Project Materials Thermo API
  description: Route providing computed thermodynamic data for a material such as             formation energy and energy
    above hull. Corrected energy values are also available that employ             the schemes discussed by             [Jain
    *et al.*](https://journals.aps.org/prb/abstract/10.1103/PhysRevB.84.045115)             and [Wang *et al.*](https://chemrxiv.org/engage/chemrxiv/article-details/60c758d9469df42a4ef45757)            See
    the `ThermoDoc` schema for a full list of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials Thermo
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-thermo-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-materials-xas-api
  name: Materials Project Materials XAS API
  description: Route providing computed x-ray absorption spectroscopy data for a material following the             methodology
    discussed by [Mathew *et al.*](https://doi.org/10.1038/sdata.2018.151)             and [Chen *et al.*](https://doi.org/10.1038/s41597-021-00936-5)             Note
    that x-ray absorption spectroscopy data has not been calculated for all materials in the Materials             Project
    database. See the `XASDoc` schema for a full list of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Materials XAS
  properties:
  - type: OpenAPI
    url: openapi/materials-project-materials-xas-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-molecules-summary-api
  name: Materials Project Molecules Summary API
  description: Route for a summary of all data calculated on 'core' molecules in the Materials Project             molecules
    database. See the `MoleculeSummaryDoc` schema for a full list of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - Molecules Summary
  properties:
  - type: OpenAPI
    url: openapi/materials-project-molecules-summary-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
- aid: materials-project:materials-project-dois-api
  name: Materials Project DO Is API
  description: Route providing DOI and bibtex reference information for a material.             Note that this data may not
    be available for all materials in the Materials             Project database. See the `DOIDoc` schema for a full list
    of fields returned by this route.
  humanURL: https://next-gen.materialsproject.org/api
  baseURL: https://api.materialsproject.org
  tags:
  - DOIs
  properties:
  - type: OpenAPI
    url: openapi/materials-project-dois-api-openapi.yml
  - type: Documentation
    url: https://next-gen.materialsproject.org/api
  - type: GettingStarted
    url: https://docs.materialsproject.org/downloading-data/using-the-api
common:
- type: CapabilityMap
  url: capabilities/materials-project-capability-edges.yml
  name: Materials Project Business Capability Map
- type: Plans
  url: plans/materials-project-plans-pricing.yml
- type: RateLimits
  url: rate-limits/materials-project-rate-limits.yml
- type: FinOps
  url: finops/materials-project-finops.yml
- type: Website
  url: https://materialsproject.org
- type: AgenticAccess
  url: agentic-access/materials-project-agentic-access.yml
- type: DomainSecurity
  url: security/materials-project-domain-security.yml
- type: Authentication
  url: authentication/materials-project-authentication.yml
- type: Portal
  url: https://materialsproject.org/
- type: Documentation
  url: https://docs.materialsproject.org/
- type: GitHubOrganization
  url: https://github.com/materialsproject
- type: Signup
  url: https://materialsproject.org/login
- type: LlmsText
  url: https://docs.materialsproject.org/llms.txt
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

Materials Project API — frequently asked questions

Does Materials Project have an API?

Yes. APIs.io lists 29 APIs from Materials Project, including Materials Project Defect Tasks API, Materials Project JCESR Electrolyte Genome API and Materials Project Materials Absorption API, and 26 more.

Is there an OpenAPI specification for the Materials Project API?

Yes. APIs.io indexes 29 OpenAPI specifications for Materials Project, each linked for download from this page.

How do I authenticate with the Materials Project API?

Materials Project uses bearer-token authentication (apiKey · 1 scheme). The details are profiled on APIs.io as Materials Project Authentication.

How much does the Materials Project API cost?

APIs.io lists 3 pricing plans for Materials Project, with each plan's price, limits and inclusions under Pricing on this page.

Does Materials Project have an MCP server?

Yes. APIs.io lists 1 MCP server for Materials Project: Remote MCP server at docs.materialsproject.org over HTTP; 3 tools listed.

Is the Materials Project API ready for AI agents?

Materials Project has a Kin Score of 33.8 out of 100 (thin) and an Agent Readiness score of 34.4 (agent-ready), scored by API Evangelist on 2026-11-06.

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/materials-project"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/materials-project/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/materials-project/evidence"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.