osdu-mcp-server by danielscholl - MCP Server

OSDU MCP Server

AI-powered access to OSDU subsurface data through natural language.

Enable AI assistants to interact with the OSDU (Open Subsurface Data Universe) platform through conversational interfaces. Search data, manage schemas, handle records, and maintain compliance—all through natural language.

Why OSDU MCP Server?

Transform complex OSDU API workflows into simple conversations:

Before:

curl -X POST https://osdu.com/api/search/v2/query \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"kind":"osdu:wks:master-data--Well:*"}'
# ... parse JSON, check schemas, format records, handle ACLs ...

After:

You: "Find all wells in the North Sea and show their schemas"
AI: ✅ Found 247 wells
    📋 Retrieved schema requirements
    🎯 Ready to work with the data

Key Features

Feature	Description
Natural Language	Complex API calls and Elasticsearch queries through conversation
Multi-Cloud Auth	Azure, AWS, and GCP with zero-config credential discovery
31 MCP Tools	Complete OSDU API coverage (storage, search, schema, legal, partition)
Template-Driven	Pre-built templates eliminate format-guessing errors
Safety Controls	Write/delete protection, confirmation requirements, audit logging
Resources & Prompts	Guided workflows and interactive examples

Quick Start

Setup

mcp add osdu-mcp-server -- uvx osdu-mcp-server \
  -e OSDU_MCP_SERVER_URL=https://your-osdu.com \
  -e OSDU_MCP_SERVER_DATA_PARTITION=opendes \
  -e AZURE_CLIENT_ID=your-client-id \
  -e AZURE_TENANT_ID=your-tenant-id

Or add manually to your MCP configuration:

{
  "mcpServers": {
    "osdu-mcp-server": {
      "command": "uvx",
      "args": ["osdu-mcp-server"],
      "env": {
        "OSDU_MCP_SERVER_URL": "https://your-osdu.com",
        "OSDU_MCP_SERVER_DATA_PARTITION": "opendes",
        "AZURE_CLIENT_ID": "your-client-id",
        "AZURE_TENANT_ID": "your-tenant-id"
      }
    }
  }
}

Note: Authentication credentials (Azure/AWS/GCP) are auto-discovered from your environment. See for all auth methods.

Try It

"Check the health of my OSDU platform"

"List all schemas available in the system"

"Find wells in the North Sea region"

"Show me the legal tag template"

What's Included

31 Tools across 6 OSDU services:

Core - Health checks and user entitlements
Partition - List, get, create, update, and delete partitions
Legal - Complete legal tag management with search and batch operations
Schema - Schema discovery, search, and management
Search - Elasticsearch queries and record discovery
Storage - Full CRUD operations with versioning and batch support

3 Prompts for guided workflows:

Capability overview and quick start
Search pattern guidance with Elasticsearch examples
Complete record lifecycle workflows

4 Resources with working templates:

Legal tag templates
Record structure examples
ACL format patterns
Search query patterns

Configuration

Required

OSDU_MCP_SERVER_URL - Your OSDU platform URL
OSDU_MCP_SERVER_DATA_PARTITION - Data partition ID

Optional

OSDU_MCP_SERVER_DOMAIN - Data domain for ACLs (default: contoso.com)
OSDU_MCP_ENABLE_WRITE_MODE - Enable create/update (default: false)
OSDU_MCP_ENABLE_DELETE_MODE - Enable delete/purge (default: false)

License

Apache License 2.0 - see for details.

• • •