# Gridstate

> Power data your agents can verify. Search power projects, plants, generators, and grid operations through one API and hosted MCP. Every key fact links to its source.

- **Getting started**
- [Use public energy data](https://gridstatelabs.com/docs.md): Search public energy records in one API and open the source behind each result.
- [Make your first API request](https://gridstatelabs.com/docs/quickstart.md): Create an API key and make your first Gridstate request.
- [Authenticate API requests](https://gridstatelabs.com/docs/authentication.md): Bearer API keys, scopes, and pinning the dated API contract.
- [Connect an agent with MCP](https://gridstatelabs.com/docs/mcp-server.md): Add Gridstate’s hosted MCP server to Claude Code, Codex, Cursor, or VS Code.

- **Common workflows**
- [Screen a site with public evidence](https://gridstatelabs.com/docs/site-diligence.md): Resolve a location, create a site, and run an assessment that abstains when the public record is insufficient.
- [Trace a fact to its source](https://gridstatelabs.com/docs/provenance.md): Follow a response value to the preserved source file, exact locator, and content hash.
- [Query historical state](https://gridstatelabs.com/docs/point-in-time.md): Separate when a source fact was valid from when Gridstate learned it.

- **Understand the data**
- [Check data coverage](https://gridstatelabs.com/docs/coverage.md): Confirm which domains and geographies are populated before using a Gridstate response.

- **Reference**
- [Page through collection results](https://gridstatelabs.com/docs/pagination.md): Follow opaque cursors across deterministic Gridstate collections.
- [Handle API errors](https://gridstatelabs.com/docs/errors.md): Read RFC 9457 problem details, choose a retry policy, and trace a failed request.

- **API reference**
- Api
  - Openapi json
    - [Read the complete OpenAPI contract](https://gridstatelabs.com/docs/api/openapi-json/get.md)
  - V1
    - Assessments
      - Assessmentid
        - [Read a non-capacity screening-friction assessment with abstention and limitations](https://gridstatelabs.com/docs/api/v1/assessments/assessmentid/get.md)
        - Expert review json
          - [Export a structured blinded expert-review packet](https://gridstatelabs.com/docs/api/v1/assessments/assessmentid/expert-review-json/get.md)
        - Exports
          - [Start an idempotent assessment export](https://gridstatelabs.com/docs/api/v1/assessments/assessmentid/exports/post.md)
      - Exports
        - Exportid
          - [Read a completed assessment export](https://gridstatelabs.com/docs/api/v1/assessments/exports/exportid/get.md)
      - Portfolio comparisons
        - [Start an idempotent portfolio comparison](https://gridstatelabs.com/docs/api/v1/assessments/portfolio-comparisons/post.md)
        - Comparisonid
          - [Read a completed portfolio comparison](https://gridstatelabs.com/docs/api/v1/assessments/portfolio-comparisons/comparisonid/get.md)
    - Balancing authority operations
      - [List EIA balancing-authority hourly operations](https://gridstatelabs.com/docs/api/v1/balancing-authority-operations/get.md)
    - Change events
      - [List immutable fact change events](https://gridstatelabs.com/docs/api/v1/change-events/get.md)
    - Claim policy
      - [Read bounded acquired-data claims and separately blocked external-validation claims](https://gridstatelabs.com/docs/api/v1/claim-policy/get.md)
    - Data coverage
      - [Read canonical data coverage and explicit limitations](https://gridstatelabs.com/docs/api/v1/data-coverage/get.md)
    - Dockets
      - Controlnumber
        - Filings
          - [List official PUCT docket filing metadata](https://gridstatelabs.com/docs/api/v1/dockets/controlnumber/filings/get.md)
    - Error codes
      - Code
        - [Read remediation guidance for a stable API error code](https://gridstatelabs.com/docs/api/v1/error-codes/code/get.md)
    - Evidence search
      - [Search source evidence using weighted lexical, exact, and prefix matching](https://gridstatelabs.com/docs/api/v1/evidence-search/get.md)
    - Generation plants
      - [List current EIA generation plants](https://gridstatelabs.com/docs/api/v1/generation-plants/get.md)
    - Generator operations
      - [List EIA generator monthly operations](https://gridstatelabs.com/docs/api/v1/generator-operations/get.md)
    - Generators
      - [List current or version-selected EIA generators](https://gridstatelabs.com/docs/api/v1/generators/get.md)
    - Health
      - [Service health](https://gridstatelabs.com/docs/api/v1/health/get.md)
    - Load forecasts
      - [List observed load forecast facts](https://gridstatelabs.com/docs/api/v1/load-forecasts/get.md)
    - Markets
      - Market
        - Queue summary
          - [Summarize queue activity for a market](https://gridstatelabs.com/docs/api/v1/markets/market/queue-summary/get.md)
    - Operations
      - Operationid
        - [Read assessment operation status](https://gridstatelabs.com/docs/api/v1/operations/operationid/get.md)
    - Provenance audit
      - [Measure locator coverage across material canonical facts](https://gridstatelabs.com/docs/api/v1/provenance-audit/get.md)
    - Quality
      - [Read harvest quality; this is not independent field-accuracy validation](https://gridstatelabs.com/docs/api/v1/quality/get.md)
    - Queue records
      - [List normalized queue records](https://gridstatelabs.com/docs/api/v1/queue-records/get.md)
      - Recordid
        - Details
          - [Read complete normalized queue fields and original row evidence](https://gridstatelabs.com/docs/api/v1/queue-records/recordid/details/get.md)
        - Evidence
          - [Resolve a queue record to its preserved source row and public source artifact](https://gridstatelabs.com/docs/api/v1/queue-records/recordid/evidence/get.md)
    - Ready
      - [Service and canonical database readiness](https://gridstatelabs.com/docs/api/v1/ready/get.md)
    - Release
      - [Read immutable build, schema, and data release identity](https://gridstatelabs.com/docs/api/v1/release/get.md)
    - Resource adequacy
      - [List observed resource adequacy facts](https://gridstatelabs.com/docs/api/v1/resource-adequacy/get.md)
    - Service territory resolutions
      - [Resolve a point against evidence-classified electric service territories](https://gridstatelabs.com/docs/api/v1/service-territory-resolutions/post.md)
    - Sites
      - [Create a tenant-scoped site](https://gridstatelabs.com/docs/api/v1/sites/post.md)
      - Siteid
        - [Read a tenant-scoped site](https://gridstatelabs.com/docs/api/v1/sites/siteid/get.md)
        - Assessments
          - [Start an idempotent site assessment](https://gridstatelabs.com/docs/api/v1/sites/siteid/assessments/post.md)
    - Sources
      - [List registered sources](https://gridstatelabs.com/docs/api/v1/sources/get.md)
    - Transmission projects
      - [List evidence-linked transmission projects](https://gridstatelabs.com/docs/api/v1/transmission-projects/get.md)