# Novi EVA

Source: https://developers.novilabs.com/eva/

> Read Novi EVA well data, production and forecasts from code or an AI assistant, and load your own columns and shapefiles into EVA.

Work with Novi EVA, Novi's well analytics and forecasting application, from scripts or an AI assistant. EVA brings well-level data, forecasts and research together with your organization's own data, across US and Canadian basins.

- [Novi EVA on novilabs.com](https://novilabs.com/energy-analytics/novi-eva/): The EVA application: its data, research and workflows.

## What you can build

| You want | Use | Status |
| --- | --- | --- |
| Field values for up to 50,000 wells per call, in the order you sent them, for dataframes, load jobs and BI tools | [REST API](https://developers.novilabs.com/eva/api/) | [Preview] |
| Production history and forecast for up to 1,000 wells per call, for reserves and economics tools | [REST API](https://developers.novilabs.com/eva/api/) | [Preview] |
| Your own columns per well, and shapefile uploads, in EVA | [REST API](https://developers.novilabs.com/eva/api/) | [Preview] |
| Plain-language answers: benchmark basins or operators, build a type curve with High (P10), Mid (P50) and Low (P90) cases, map a cohort | [MCP server](https://developers.novilabs.com/eva/mcp/), 13 read-only tools | [Preview] |
| Area screens: count and rank wells within a radius of a reference set, by operator or vintage | [MCP server](https://developers.novilabs.com/eva/mcp/) | [Preview] |

EVA charts use the exceedance convention, where P10 is the High case. See [P-levels](https://developers.novilabs.com/concepts/p-levels/).

The MCP server is in preview and not yet available on company hosts.

## Which one to use

  **Pipelines and scripts**
    Use the REST API. Send a well list; get values back in your order, ready for a dataframe or a load job.
  
  **Questions in plain language**
    Use the MCP server. An assistant finds the right columns, applies your filters, and returns rankings, charts and maps with the basis and units stated.
  

## Access

- **REST API:** create a Developer API Token on the Organization Settings page in EVA and send it in the `x-api-key` header. The key acts for your EVA organization.
- **MCP server:** sign in from a supported assistant. You need the Access EVA and Access MCP permissions on your company's Novi account. API keys and personal tokens don't work on the MCP server.

## Next steps

  - [REST API](https://developers.novilabs.com/eva/api/): Base URL, authentication, endpoints and examples.
  - [MCP server](https://developers.novilabs.com/eva/mcp/): Tools, filters, pagination, conventions and limits.
  - [Connect Claude](https://developers.novilabs.com/eva/connect-claude/): Add EVA to Claude, Claude Code or Codex.
