# Petrora

> Texas Railroad Commission oil and gas data, cleaned and joined, with a stable page for every well, operator, and permit. Every page is citable. Data is public record; Petrora is not affiliated with the RRC.

Petrora covers drilling permits since 1966, wellbores, completions, lease production, operators (P-5), formation tops, UIC disposal and injection permits with reported volumes, and TexNet seismicity. Figures from lagging sources are labeled with the period they are reported through; nothing is estimated or extrapolated.

## Entity pages

Addresses are type first, then state. Sections scoped to the Texas regulator carry a `tx` segment (`/counties/tx/reeves`, `/operators/tx/217012`, `/permits/tx/918112`); wells, formations, basins, cross-section, and maps do not, because their identifiers or extents are not state-bound. The same shape applies to the API (`/v1/data/operators/tx/217012`).

- [Well by API number](https://petrora.com/wells/4233734003): `https://petrora.com/wells/{10-digit API}` (state code 42, county code, unique number); the 8-digit RRC form and the dashed 42-XXX-XXXXX form redirect to it. Permits, completions, chain of custody, production, formation tops, casing, perforations, injection, seismicity.
- [Cross-section](https://petrora.com/cross-section): `https://petrora.com/cross-section?apis={api,api,...}`; up to eight wells' formation tops side by side, subsea-aligned where elevations are filed.
- [Operator](https://petrora.com/operators/tx/217012): `https://petrora.com/operators/tx/{RRC operator number}`; P-5 details, cumulative production, recent permits by county. Sub-pages: /permits, /wells, /leases, /p5 (the organization report).
- [Operators ranked by recent permits](https://petrora.com/operators/tx)
- [Wells: every well, filterable by county, district, operator, depth, and production; CSV with a free account](https://petrora.com/wells)
- [Roadmap: what is live, in progress, and next](https://petrora.com/roadmap)
- [Water: Texas disposal capacity and injected volumes, statewide and by county and operator](https://petrora.com/water/tx)
- [Earthquakes: TexNet events by month, county area, and recent M3.5+](https://petrora.com/earthquakes/tx)
- Operator drill-downs: https://petrora.com/operators/tx/{number}/permits, /wells, /leases, and /counties/{county-slug} (one operator in one county); county leases at https://petrora.com/counties/tx/{county-slug}/leases; the wells list with filters and CSV at https://petrora.com/wells
- County disposal pages at https://petrora.com/water/tx/{county-slug}; county earthquake areas at https://petrora.com/earthquakes/tx/{county-slug}; single events at https://petrora.com/earthquakes/tx/events/{texnet-id}
- [County](https://petrora.com/counties/tx/reeves): `https://petrora.com/counties/tx/{slug}` (lower-case, spaces to hyphens); activity windows, trend, top operators, new entrants, disposal, seismicity. Sub-pages `/permits`, `/operators`, and `/leases`; a lease is in every county its completed wells are in.
- [Counties ranked](https://petrora.com/counties/tx)
- [Basins](https://petrora.com/basins): `https://petrora.com/basins/{permian|eagle-ford|gulf-coast|east-texas|barnett|panhandle}`; RRC districts grouped by region, rolled-up permits, operators, disposal, earthquakes, every county in the basin.
- [Formation](https://petrora.com/formations/wolfcamp): `https://petrora.com/formations/{slug}`; wells reporting the top, depth by county (median, P10-P90), operators, recent wells. From completion filings, not permits.
- [Formations ranked](https://petrora.com/formations)
- [Lease](https://petrora.com/leases/tx/o-13-31062): `https://petrora.com/leases/tx/{type}-{district}-{lease}` (o or g, RRC district, lease number); monthly oil and gas as reported on Form PR, reporting operators, wells completed on the lease, and a fitted decline curve labelled as a model.
- [Leases ranked](https://petrora.com/leases/tx)
- [Maps](https://petrora.com/map): [permits](https://petrora.com/map/permits) with the list filters as query parameters (`?county=reeves&days=365`), [disposal wells](https://petrora.com/map/disposal) by county or operator, [earthquakes](https://petrora.com/map/earthquakes) by window and magnitude; the last two overlay each other.
- [Field](https://petrora.com/fields/tx/85280300): `https://petrora.com/fields/tx/{RRC field number}`; the Commission's named reservoir: leases, operators, counties, ten years of monthly oil and gas. [Fields ranked](https://petrora.com/fields/tx).
- [Permits](https://petrora.com/permits/tx): newest first; filter with `?county={name}&days={1-365|all}&district=&operator=&type=&hz=&minDepth=`; CSV with a free account.
- [Permit](https://petrora.com/permits/tx/918112): `https://petrora.com/permits/tx/{RRC permit number}`; application type, lifecycle dates, surface location, amendments.
- [Data catalog and live counts](https://petrora.com/data)

## API

- [OpenAPI 3.1 document](https://api.petrora.com/v1/openapi.json): the machine-readable contract for every endpoint, parameter, and response field. Reads are public with no key; CSV downloads and the watchlist routes take a bearer token from a free account. Import it as actions or tools.
- [Interactive reference](https://api.petrora.com/v1/docs): the same document rendered with a try-it client.
- [API reference](https://petrora.com/guides/api-reference): how to use the API; identifiers (API numbers, operator numbers, lease ids), permit windows on the first-seen date, production by lease, lags.
- Base URL `https://api.petrora.com/v1/data/...`; every entity row carries its page `url`, which is the thing to cite.
- [Connect your AI](https://petrora.com/connect): remote MCP server at https://mcp.petrora.com/mcp (OAuth sign-in or an account API key as bearer; 28 read-only tools, one per API read), in beta, testers on request; an account's free trial covers the connector and the API, which needs a key as a bearer token.

## Getting started (one page per step)

- [Create an account](https://petrora.com/start/create-an-account): Sign up with an email address or a Google account, in about a minute. What the account unlocks now, what it will unlock next, and what it costs during the beta.
- [Explore the data](https://petrora.com/start/explore-the-data): A map of what Petrora holds and where it lives: wells, permits, counties, operators, formations, leases, produced water, and earthquakes, with how to find any of them and what each page tells you.
- [Read a well page](https://petrora.com/start/read-a-well-page): What each section of a Petrora well page means, which source it comes from, and how to tell current facts from historical ones.
- [Follow an operator](https://petrora.com/start/follow-an-operator): Find an operator, read their activity over the last 90 days, and see where they are permitting.
- [Track permits in a county](https://petrora.com/start/track-permits): Watch new drilling permits in a county as they appear, understand the seen and issued dates, and read the permit rows.
- [Connect your AI](https://petrora.com/start/connect-your-ai): Add Petrora to Claude, ChatGPT, or another assistant so it answers Texas well questions with live data and cites the page. What the connector is, why you would want it, and how it works.
- [Use the API](https://petrora.com/start/use-the-api): Make your first requests to the Petrora data API, follow the links from one record to the next, and find the interactive reference where every endpoint, parameter, and field is listed.
- [Say hello](https://petrora.com/start/say-hello): How to send feedback, report a wrong record, ask for a state or a data source, or talk about working together. One address, read by a person.

## Guides: Wells

- [API numbers explained](https://petrora.com/guides/api-numbers): How a Texas API well number is built, what each part means, why a well can have several suffixes, and how to look one up.
- [Completion reports, formation tops, and the wellbore file](https://petrora.com/guides/wellbore-records-w2-g1): What the W-2 and G-1 completion reports contain, how formation tops, casing, and perforations reach the RRC wellbore file, and how Petrora computes subsea depths.
- [The EWA wellbore file and well status](https://petrora.com/guides/ewa-wellbore-file): What the RRC's wellbore (EWA) file says about each well, what the well types and the on-schedule flag mean, and why it is the source for a well's current operator.

## Guides: Connect

- [Connect Petrora to Claude](https://petrora.com/guides/connect-claude): Add Petrora as a custom connector in Claude so it can look up Texas wells, operators, permits, and disposal data and cite the page for every answer.
- [Connect Petrora to ChatGPT](https://petrora.com/guides/connect-chatgpt): Add Petrora as a connector in ChatGPT so it can query Texas well, operator, permit, and disposal data and cite petrora.com pages.
- [Connect Copilot, Cursor, and other MCP clients](https://petrora.com/guides/connect-other-clients): How to add Petrora's MCP server to Microsoft Copilot Studio, Cursor, VS Code, and any other client that supports remote MCP servers.
- [API reference](https://petrora.com/guides/api-reference): How to use the Petrora data API. Read-only JSON over Texas Railroad Commission and TexNet records, with a citation URL on every entity. What the endpoints are for, how to read the identifiers, windows, and dates, and where the machine-readable contract lives.

## Guides: Operators

- [Operator numbers and the P-5 report](https://petrora.com/guides/operator-numbers-p5): What an RRC operator number is, what the P-5 Organization Report contains, why one company can have several numbers, and how Petrora decides a well's operator of record.

## Guides: Reference

- [RRC districts, counties, and offshore tracts](https://petrora.com/guides/rrc-districts-counties): How the Railroad Commission divides Texas into districts, why county names in the data include offshore tracts, and how to read district and county codes.
- [How current the data is](https://petrora.com/guides/data-freshness): When each Railroad Commission source updates, how long each one lags the real world, and the rules Petrora follows so that lag is never hidden.

## Guides: Water

- [Saltwater disposal and injection permits in Texas](https://petrora.com/guides/saltwater-disposal-texas): How the RRC permits disposal and injection wells (W-14 and H-1), what the UIC permit records, how injected volumes are reported on the H-10 and through TexNet, and how to read them.
- [Texas earthquakes, TexNet, and seismic response areas](https://petrora.com/guides/texas-earthquakes-texnet): Where Texas earthquake data comes from, how the RRC responds to induced seismicity with seismic response areas, and how Petrora relates earthquakes to disposal wells.

## Guides: Permits

- [How Texas drilling permits work](https://petrora.com/guides/texas-drilling-permits): What a Railroad Commission drilling permit (Form W-1) is, who files it, what the application types and dates mean, and how long a permit stays valid.

## Guides: Production

- [How Texas production data is reported](https://petrora.com/guides/texas-production-data): Why Texas oil production is reported by lease rather than by well, what the PDQ data contains, what casinghead gas and condensate mean in the reports, and how far the data lags.