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 Getting Started 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 LICENSE for details.

---

<div align="center">

Getting Started • Authentication • Architecture • Contributing

</div>