Guide
CrudeCode is a connector: it gives the AI you already use public oil and gas data and the calculators to work with it. You add one link, sign in with your email, and ask your questions in plain English. It's free.
Connect it
The link is the same everywhere:
https://mcp.crudecode.dev/mcpClaude (web and desktop)
- Open Customize in the left sidebar, then Connectors.
- Click + and choose Add custom connector.
- Name it CrudeCode, paste the link and click Add.
- Click Connect. A crudecode.dev page opens to sign you in (see below). Click Allow, and you're back in Claude, connected.
On a Team or Enterprise plan, an owner may need to add it for the organization first.
Claude Code
Run this once, then type /mcp in Claude Code and choose CrudeCode to sign in:
claude mcp add --transport http crudecode https://mcp.crudecode.dev/mcpOther AI apps and agents
Any app that supports remote MCP servers with OAuth sign-in can use the same link.
Sign in
- Enter your email. We send an 8-digit code from login@crudecode.dev; type it in. There's no password.
- A new email address gets an account on the spot. If you signed up on crudecode.dev before, you'll land in the same account.
- Your AI stays signed in. If it ever asks you to reconnect, or you add CrudeCode on a new computer or app, sign in again the same way.
- If you signed up before November 2026 you may have a personal link (
mcp.crudecode.dev/<your-code>/mcp). It still works.
What to ask
Ask the way you'd ask an analyst. Your AI decides which tools to use. Some examples:
- What has EOG brought online in Lea County, New Mexico since 2024, and how do the first 12 months compare with 2022?
- Show me the NYMEX WTI strip today and how the 2027 contracts moved over the last month.
- Compare Diamondback's and Coterra's free cash flow over the last eight quarters.
- Plot monthly gas production for Washington County, Pennsylvania since 2015, split by operator.
- Here's a data room. Pull out the wells, the interests and the operating costs.
- What's inside this ARIES database? Show me the forecasts and the economics settings.
- Value these 12 producing wells at the strip with a 75% working interest, $9,000 a month per well in operating cost and 4.6% severance.
For a valuation, your AI will ask you for the inputs that have no default: operating cost on a working-interest deal, capital for undrilled wells, and severance. Data rooms and ARIES databases are read in your AI's own workspace, so it needs to be able to run code (in claude.ai, Code execution and file creation turned on). See a full worked example.
The tools
Eleven tools. All but one only read; the one that writes sends us a message, and only when you agree.
| Tool | What it does | Reads or writes |
|---|---|---|
Coverage by stateget_coverage | What data exists in each state, how complete each field is, and the latest month. | Reads |
Search wells and operatorssearch | Finds wells, leases and operators by name or API number. | Reads |
Well headerget_well | One well's header: operator, location, status, dates, depths, lateral, completion. | Reads |
Monthly productionget_production | Monthly oil, gas and water for wells, leases, operators or counties. | Reads |
Table referenceget_schema | Documents every table and column your AI can query. | Reads |
Run a SQL queryrun_sql | A read-only SELECT across wells, production, prices, EIA, SEC financials and news. Up to 200 rows back in the chat. | Reads |
Export a SQL query to a fileexport_sql | The same query, returned as a file for your AI to analyze in code. For larger pulls. | Reads |
Get a packaged procedureget_skill | Step-by-step procedures for data rooms, ARIES databases and well forecasting. | Reads |
Forecast wells for a dealdeal_forecast_wells | Checks the decline parameters your AI sets for each well and returns the forecast and EUR. | Reads |
Value a dealdeal_valuation | Monthly cash flow on the NYMEX strip with your interests and costs, PV by reserve category and an Excel workbook. | Reads |
Message the CrudeCode teammessage_team | Sends a bug report or a data request to us, after you agree to what it says. | Writes |
Coverage
Well headers and monthly production from state regulators, plus daily and monthly oil and gas prices since 1986, NYMEX WTI and Henry Hub futures for every trading day since 2010, EIA weekly supply and Short-Term Energy Outlook data, quarterly financials for 33 public operators from SEC filings, and headlines from nine trade publications.
| State | Wells | Monthly production |
|---|---|---|
| Texas | 1,050,849 | Through Jul 2026 |
| Oklahoma | 456,857 | Not yet |
| Pennsylvania | 279,649 | Through Aug 2026 |
| Ohio | 242,069 | Through Sep 2025 |
| Wyoming | 210,771 | Through Aug 2026 |
| Louisiana | 209,114 | Not yet |
| New Mexico | 142,472 | Through Sep 2026 |
| Colorado | 124,397 | Through Aug 2026 |
| West Virginia | 118,705 | Through Jun 2026 |
| North Dakota | 43,711 | Through Jul 2026 |
| Montana | 42,050 | Through Jun 2026 |
| Utah | 40,160 | Through Sep 2026 |
Counts as of Nov 4, 2026; your AI can ask get_coverage for today's. Ohio and Pennsylvania file production quarterly or yearly, so those months are spread evenly. Not in yet: other states, federal offshore, and SEC reserves.
Limits
- SQL in the chat: up to 200 rows per query, and 30 seconds per query.
- Exports to a file: up to 250,000 rows (4 MB) per call and 5 million rows a day. They need an app that can run code, such as Claude Code or claude.ai with code execution on.
- Calls: 30 a minute and 2,000 a day per person.
Troubleshooting
- The sign-in code didn't arrive
- Check spam for mail from login@crudecode.dev, then ask for a new code.
- "Already signed in as" a different email
- Choose Use a different email on the sign-in page.
- Claude doesn't use CrudeCode
- Make sure the connector is switched on for the chat (the + menu, then Connectors), and mention oil and gas data in your question.
- An export or a data room says it needs code execution
- In claude.ai, turn on Code execution and file creation under Settings, Capabilities (on Team and Enterprise plans an owner sets it under Organization settings). Claude Code can always run code.
- No production for an Oklahoma or Louisiana well
- Those states have well headers but no production data yet. It means not available, not zero.
- Something looks wrong
- Ask your AI to send it to the CrudeCode team, or email support@crudecode.dev.
How we handle your data: privacy policy. The rules for using it: terms of use. Questions: support@crudecode.dev.