# ComboCurve MCP

> ComboCurve connects your agent to the cloud-based energy platform for forecasting, valuation, and reporting. It lets you pull project metadata, find wells by name or ID, get historical production data, and retrieve detailed monthly volume forecasts and decline curves directly from chat. Stop logging into the full system just to check a number.

## Overview
- **Category:** erp-operations
- **Price:** Free
- **Tags:** oil-and-gas, forecasting, valuation, production-reporting, well-management, energy-data

## Description

You can connect your agent to ComboCurve for all things oil and gas forecasting. This lets you pull operational details without ever opening the main platform. You tell it what you need—like production volumes or project statuses—and it gets the data straight from the source. Need to check a well’s history? Your client finds that specific information, pulling up everything from its initial status to current trends. Want to see how much oil is predicted for next quarter? It runs those forecast curves and gives you monthly volume breakdowns for any project or individual well. For financial analysts doing deal work, it pulls the exact valuation metrics needed to evaluate a lease. The Vinkius catalog makes this possible by letting your agent talk directly to ComboCurve's API. You just ask questions using natural language; the platform handles all the complex data retrieval and reporting.

## Tools

### get_forecast
Pulls specific details for any given forecast model or run.

### get_monthly_volumes
Retrieves forecasted oil volumes month by month for a specified project and forecast.

### get_project
Gathers comprehensive metadata about one specific operational project.

### get_scenario_details
Retrieves the technical parameters defining a particular production or financial scenario.

### get_well
Fetches all detailed operational information for an individual well, including history and status.

### list_forecasts
Retrieves a complete list of available forecasts tied to a specific project.

### list_projects
Gathers a comprehensive roster of all projects managed within ComboCurve.

### list_scenarios
Retrieves a full list of defined scenarios for a selected project.

### list_wells
Returns an exhaustive list of all wells tracked in the system.

### search_wells_by_name
Searches for and identifies specific wells using either their name or assigned ID number.

## Prompt Examples

**Prompt:** 
```
Show me all active projects in ComboCurve.
```

**Response:** 
```
You have 4 active projects:
1. 'Permian Basin Q1' — 142 wells, last updated today
2. 'Eagle Ford Development' — 87 wells, last updated yesterday
3. 'Delaware Lease Eval' — 34 wells, last updated Jan 18
4. 'Bakken Acquisition' — 56 wells, last updated Jan 15
Would you like forecast data for any of these?
```

**Prompt:** 
```
Show monthly volumes for forecast 'fc-yyyy' in project 'proj-xxxx'.
```

**Response:** 
```
Forecast 'fc-yyyy' monthly volumes (oil, bbl):
- Jan 2026: 12,400
- Feb 2026: 11,800
- Mar 2026: 11,200
- Apr 2026: 10,650
Decline rate: ~4.8%/month. Would you like gas and NGL volumes as well?
```

**Prompt:** 
```
Get the type curve parameters for the 'Wolfcamp A' formation.
```

**Response:** 
```
Type Curve parameters for 'Wolfcamp A': Initial decline (Di) is 65%, with a b-factor of 1.2, transitioning to a terminal decline (d_term) of 6% at month 36. EUR is estimated at 450 MBOE.
```

## Capabilities

### List active projects
The agent retrieves a list of ongoing or completed projects within your portfolio.

### Search specific wells
You find and gather detailed information on any well using its name, ID, or geographic filters.

### Retrieve forecast data
The system pulls projected monthly oil volumes and decline curves for a given project or well.

### Get project details
You pull up comprehensive metadata about an entire operational project.

### Check scenario parameters
The agent pulls the specific technical rules that govern a financial or production scenario.

## Use Cases

### Checking a sudden drop in production volumes.
The ops manager asks their agent: 'Why did Well ABC's output dip last month?' The agent first uses `get_well` to confirm the recent status, then calls `list_forecasts` to compare that actual performance against expected trends. It presents a clear variance report in minutes.

### Performing due diligence on a new acquisition.
The financial analyst asks: 'What are the valuation metrics for the Permian Basin Q1 project?' The agent uses `get_project` to pull all metadata and then calls `get_scenario_details` to provide the necessary economic parameters required for deal review.

### Comparing multiple drilling options.
The engineer needs to compare three different potential outcomes. They ask the agent to retrieve data using `list_projects`, then call `get_forecast` for each one, getting immediate volume comparisons without leaving the chat.

### Quickly finding a well's ID and status.
The team member knows the name of the target well but not its ID. They use `search_wells_by_name` to find the exact ID, then pass that ID to `get_well` for all operational details in two simple steps.

## Benefits

- Stop manually running reports. You can check a well's status or pull its full history using the `get_well` tool in one prompt.
- Need to evaluate potential deals? Use the agent to extract valuation metrics directly by calling `get_project` and pulling key data points for immediate analysis.
- Forecasting used to be a multi-step process. Now, you simply request monthly volumes using `get_monthly_volumes` and get structured results instantly.
- Don't waste time figuring out which forecast runs exist. The `list_forecasts` tool gives you a complete overview of what data is available for any project.
- You can cross-reference current well performance against historical predictions by calling both the `get_well` tool and then using `list_forecasts` to compare trends.

## How It Works

The bottom line is that you ask a question, and it returns structured, actionable data without needing to navigate complex dashboards.

1. First, you add the ComboCurve integration to your AI toolset and provide your Service Account credentials (API Key + JWT Bearer Token).
2. Next, you give a natural language command to your client, asking for specific data—for example, 'What are the monthly volumes for Project X?'
3. The system executes the necessary API calls, retrieves the raw energy data, and presents the forecast or operational details right in your chat window.

## Frequently Asked Questions

**How do I use the `search_wells_by_name` tool?**
You simply tell your agent to search for a well by name or ID. It returns the confirmed unique identifiers and detailed records, which you can then pass to other tools like `get_well`.

**Can I get forecast data using the `list_forecasts` tool?**
No, `list_forecasts` only gives you a list of available forecast names for a project. To actually see the numbers, you need to call `get_monthly_volumes` or `get_forecast`.

**What is the difference between `get_project` and `list_projects`?**
`list_projects` gives you a roster of everything ComboCurve tracks. `get_project`, however, pulls all the detailed metadata—the full description and key stats—for one project only.

**How do I compare well data across different scenarios?**
You first list the available scenarios using `list_scenarios`. Then, you call `get_scenario_details` to pull the technical parameters for each scenario and compare them side-by-side.

**What service account credentials are needed to run the `list_wells` tool?**
You need a valid API Key and JWT Bearer Token provided in your client setup. The MCP validates these tokens before executing any query, ensuring secure access to all well data.

**If I try to use `get_well` with a well ID that doesn't exist, what happens?**
The MCP returns a specific HTTP 404 error code. Your agent will receive structured JSON detailing the failure and suggesting an alternative search method for you.

**What data points does the `get_project` tool provide besides the name?**
It returns comprehensive metadata, including the total number of associated wells and the project's last update date. This helps you scope your analysis immediately upon retrieval.

**Is there a limit when using the `list_scenarios` tool for very large projects?**
The MCP supports pagination, allowing you to retrieve results in manageable chunks. You simply request the next page of data until all project scenarios are collected.

**How do I get my ComboCurve API key?**
Go to **Admin > API Keys** in the ComboCurve UI and generate a new key. Copy it and paste it below.

**What is the Bearer Token?**
ComboCurve uses a JWT (Bearer Token) generated from a Service Account for authentication. You can generate it using their SDKs or a custom script.

**Can I update well data?**
The current version focuses on reading data. Write operations for wells and forecasts may be added in future updates.