Bring Oil And Gas
to Pydantic AI
ComboCurve MCP Server · 10 tools available to AI Agents
What is the ComboCurve MCP Server?
Connect your AI assistant to ComboCurve, the cloud-based energy platform for forecasting, valuation, and reporting in the oil and gas industry.
What you can do
- Project Management — List active projects, inspect configurations, and retrieve project-level metadata.
- Well Search — Find wells by ID, name, or geographic filters and view production history.
- Forecast Data — Retrieve monthly volume forecasts and decline curves for individual wells or full projects.
How it works
1. Add the ComboCurve integration to your AI toolset.
2. Provide your Service Account credentials (API Key + JWT Bearer Token).
3. Query your energy data via natural language commands.
Who is this for?
- Petroleum Engineers — Pull forecast curves and production volumes without opening the full platform.
- Financial Analysts — Extract valuation metrics and well economics for deal evaluation.
- Operations Teams — Check well statuses and production trends directly from chat.
Built-in capabilities (10)
Retrieve details of a specific forecast
Retrieve monthly forecasted volumes for a project and forecast
Retrieve details of a specific project
Retrieve details of a specific scenario
Retrieve detailed information about a specific well
Retrieve a list of forecasts for a specific project
Retrieve a list of projects in ComboCurve
Retrieve a list of scenarios for a specific project
Retrieve a list of wells in ComboCurve
Search for wells by name or chosen ID
Why Pydantic AI?
Pydantic AI validates every ComboCurve tool response against typed schemas, catching data inconsistencies at build time. Connect 10 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.
- —
Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application
- —
Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your ComboCurve integration code
- —
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
- —
Dependency injection system cleanly separates your ComboCurve connection logic from agent behavior for testable, maintainable code
ComboCurve in Pydantic AI
ComboCurve and 2,500 other MCP servers. One platform. One governance layer.
Teams that connect ComboCurve to Pydantic AI through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 2,500+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for ComboCurve in Pydantic AI
The ComboCurve MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 10 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in Pydantic AI only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.
* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
ComboCurve for Pydantic AI
Every tool call from Pydantic AI to the ComboCurve MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
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.
How does Pydantic AI discover MCP tools?
Create an MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.
Does Pydantic AI validate MCP tool responses?
Yes. When you define result types as Pydantic models, every tool response is validated against the schema. Invalid data raises a clear error instead of silently corrupting your pipeline.
Can I switch LLM providers without changing MCP code?
Absolutely. Pydantic AI abstracts the model layer. your ComboCurve MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.
MCPServerHTTP not found
Update: pip install --upgrade pydantic-ai
Connect ComboCurve with your favorite client
Step-by-step setup guides for every MCP-compatible client and framework:
Anthropic's native desktop app for Claude with built-in MCP support.
AI-first code editor with integrated LLM-powered coding assistance.
GitHub Copilot in VS Code with Agent mode and MCP support.
Purpose-built IDE for agentic AI coding workflows.
Autonomous AI coding agent that runs inside VS Code.
Anthropic's agentic CLI for terminal-first development.
Python SDK for building production-grade OpenAI agent workflows.
Google's framework for building production AI agents.
TypeScript toolkit for building AI-powered web applications.
TypeScript-native agent framework for modern web stacks.
Python framework for orchestrating collaborative AI agent crews.
Leading Python framework for composable LLM applications.
Data-aware AI agent framework for structured and unstructured sources.
Microsoft's framework for multi-agent collaborative conversations.
Give your AI agents the power of ComboCurve MCP Server
Production-grade ComboCurve MCP Server. Verified, monitored, and maintained by Vinkius. Ready for your AI agents — connect and start using immediately.