Osdu MCP Server
A MCP server that communicates to an OSDU Instance
Installation
npx osdu-mcp-serverAsk AI about Osdu MCP Server
Powered by Claude · Grounded in docs
I know everything about Osdu MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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 URLOSDU_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.
