DrillerDB Connector for Claude (MCP)

Model Context Protocol (MCP) connector

The DrillerDB connector lets you work with your DrillerDB account directly from Claude and other MCP-compatible clients (ChatGPT, Cursor, Codex). Ask about your drilling jobs, customers, invoices, and accounts receivable in plain English, query well-log and project history, and - with your approval - update job status or send customer proposals and invoices.

New to the integration? Start with the AI Assistant overview for what it can do, example prompts, and how approvals work.

Connecting

Add the following server as a custom connector in your MCP client:

https://mcp.drillerdb.com

Your client auto-discovers the sign-in flow from the server's OAuth metadata. Sign in with your existing DrillerDB account. Access is scoped to your own company only- the connector can never read another customer's data. You can revoke access at any time from your DrillerDB account.

Permissions (OAuth scopes)

mcp:read - read your projects, customers, invoices, proposals, schedule, equipment, communications, and well logs
mcp:write:low - low-risk additive writes (notes, field reports, status)
mcp:write:high - higher-risk writes (scheduling, vendor import, sending documents)
mcp:proposals:write - generate proposals

Actions that contact a customer or affect billing (sending a proposal or invoice, generating a proposal) are approval-gated: they pause for your explicit confirmation before anything is sent, and every call is audit-logged.

Available tools

Read (26)

list_my_projects, get_project_detail, list_projects_by_customer, get_project_financials, list_customers, list_invoices, get_invoice_detail, list_proposals, get_proposal_detail, list_work_orders, get_work_order_detail, list_crews, query_schedule, list_field_reports, list_project_files, list_communications, get_communication_detail, list_equipment, get_equipment_detail, list_timecards, get_timecard_summary, query_well_logs, customer_ltv_report, total_billed_by_contact, revenue_pipeline, ar_aging_report

Write (8)

update_project_status - Change a job's status
attach_note_to_project - Add a note to a project
submit_field_report - Submit a field report
schedule_project - Schedule a job (approval-gated)
import_vendor_invoice - Import a vendor bill (approval-gated)
generate_proposal - Generate a proposal (approval-gated)
send_proposal - Email a proposal to a customer (approval-gated)
send_invoice - Email an invoice to a customer (approval-gated)

Security & privacy

Tenant isolation: every request is scoped to your company, derived from your sign-in - never from tool input.
Approval gating: customer-facing and billing actions require your confirmation before running.
Audit log: every tool call records who, what, when, and the outcome.
Revocation: revoking the connector in DrillerDB immediately invalidates its access.

Data handling for the connector is described in our Privacy Policy (section 5.7). Questions: craig@drillerdb.com.

Troubleshooting

Connector won't connect / authentication fails: make sure you entered the server URL exactly as https://mcp.drillerdb.com (no trailing path), then complete the OAuth sign-in with your DrillerDB email and password. The connector uses OAuth 2.0 - it never asks for an API key.
"Sign in" loops or the authorize screen doesn't appear: confirm you can log in directly at app.drillerdb.com with the same credentials. If your account has SSO/2FA enabled and your client can't complete it, use an account without 2FA for the connector.
No data / empty results: results are scoped to the company on your DrillerDB account. If a tool returns nothing, confirm the data exists in that company (e.g. open the same list in the DrillerDB app).
A write tool "pauses" or asks for approval: that's expected. Sending invoices/proposals and generating proposals are approval-gated and return an approval-required prompt before they run - approve it to proceed.
Tools stop responding / rate limited: the server applies a per-client rate limit and returns HTTP 429 with a Retry-After header; wait and retry.
Revoke or reset access: remove the connector in your AI client, or revoke its access from your DrillerDB account - either immediately invalidates the connector's tokens.
Still stuck? Email craig@drillerdb.com with the client you're using (Claude.ai, Claude Desktop, etc.) and what you tried.