DrillerDB

com.drillerdbPublished by drillerdb.comOfficial publisherv1.0.1Updated Oct 27, 2026

Drilling jobs, customers, invoices, crews, schedules, and well logs for well contractors.

Overview

AI-generated overview

Hosted DrillerDB MCP server that lets an assistant read and act on a drilling contractor's jobs, customers, invoices, crews, schedules and well logs.

What you can do
  • Look up projects, customers, contacts, proposals, quotes, work orders, invoices and communications
  • Review schedules, crews, timecards, equipment, maintenance due, inventory and field reports
  • Query well logs and geology at a location, plus compliance forms and status
  • Run financial and reporting tools such as AR aging, customer lifetime value, job profitability, revenue pipeline and custom reports
  • Write notes, submit field reports, plan crew routes, and schedule, dispatch, update status, import vendor invoices or send invoices (higher-risk writes need approval)
When to use it
Useful for water-well and drilling contractors already running their business on DrillerDB who want to ask questions in plain English about jobs, receivables, schedules and well logs, or have an assistant draft field reports and prepare scheduling actions.
Requirements
A remote streamable HTTP endpoint at mcp.drillerdb.com added as a custom connector; no install or self-hosting. Requires an active DrillerDB account and OAuth 2.0 sign-in (Authorization Code with PKCE and dynamic client registration), with access scoped to the user's own company.
Before you install
The connector can change business records: write tools attach notes, submit field reports, plan routes, and schedule, dispatch, update status, import vendor invoices or send invoices. Higher-risk writes are approval-gated and run only after confirmation in the DrillerDB console, and customer-facing or money-moving actions require explicit confirmation. Access is revocable and every tool call is audit-logged; data stays within the user's own company tenant.

Installation

In SourceWeft

  1. Open DrillerDB in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.drillerdb%2Fdrillerdb/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "drillerdb": {
      "type": "http",
      "url": "https://mcp.drillerdb.com/"
    }
  }
}

README

DrillerDB MCP Server

Remote Model Context Protocol server for DrillerDB, the operating system for water-well and drilling contractors. Connect your DrillerDB account to Microsoft Copilot, Claude, ChatGPT, Codex, Cursor, VS Code, or any MCP client and work with your real jobs, customers, invoices, crews, and well logs in plain English.

https://mcp.drillerdb.com
TransportStreamable HTTP
AuthenticationOAuth 2.0 (Authorization Code + PKCE, Dynamic Client Registration)
HostingManaged by DrillerDB, LLC. Nothing to install or self-host.
AccountRequires an active DrillerDB account (app.drillerdb.com)
Registry namecom.drillerdb/drillerdb
Full docsdrillerdb.com/connectors/mcp

This repository holds the public documentation and the server.json registry manifest for the hosted DrillerDB MCP server. The server itself is a managed service and its source is not open.


Quick start

Add the server URL as a custom connector in your MCP client. OAuth sign-in happens automatically on first use, and access is scoped to your own DrillerDB company.

Claude Code

bash
claude mcp add --transport http drillerdb https://mcp.drillerdb.com

Claude (web and desktop)

Settings -> Connectors -> Add custom connector, then paste https://mcp.drillerdb.com.

Microsoft Copilot

DrillerDB is preparing the server for Microsoft MCP certification. After Microsoft publishes the certified connector, administrators can enable it from Microsoft's agent and connector catalog. The same DrillerDB OAuth sign-in and company-level permissions apply.

Gemini CLI

Install the DrillerDB extension directly from this repository:

bash
gemini extensions install https://github.com/DrillerDB/drillerdb-mcp

Gemini CLI loads the managed endpoint from gemini-extension.json and starts the DrillerDB OAuth sign-in flow when you authenticate the server.

Cursor / VS Code / other clients

json
{  "mcpServers": {    "drillerdb": {      "type": "http",      "url": "https://mcp.drillerdb.com"    }  }}

Your client discovers the OAuth endpoints automatically from /.well-known/oauth-protected-resource and the WWW-Authenticate header on a 401, so no client ID or secret needs to be configured by hand.


What you can ask

  • "Which jobs are ready to schedule this week?"
  • "What does Acme Farms still owe us, and how old is it?"
  • "Show me the well log for the Johnson project."
  • "How is revenue pacing this quarter compared to last?"
  • "Which rigs have maintenance coming due?"
  • "Draft the field report for today's crew and attach it to the job."

Permission scopes

ScopeGrants
mcp:readRead projects, customers, invoices, proposals, work orders, crews, schedule, field reports, equipment, timecards, communications, inventory, and well logs
mcp:write:lowTrivially reversible writes, such as attaching a note or submitting a field report
mcp:write:highState-changing writes, such as scheduling or dispatching a job or sending an invoice
mcp:proposals:writeProposal generation and delivery

Higher-risk write tools are approval-gated: the tool returns an approval-required result first, and the action only runs once you approve it in the DrillerDB console. Nothing that contacts a customer or moves money happens without an explicit confirmation.


Security

  • Tenant isolation. Every query is filtered by the company_id bound to your OAuth token, never by tool input. There is no way to reach another contractor's data.
  • Audit log. Every tool call is recorded: who called it, which tool, when, and the outcome.
  • Revocable. You can revoke the connector's access at any time from your DrillerDB account, which immediately invalidates its tokens.
  • Rate limited. Per-consumer limits protect the service and your account.
  • First-party. DrillerDB owns the API and the data. No connector data is sold or used for advertising.

See the DrillerDB Privacy Policy for how data is collected, used, and retained.


Tool catalog

Read tools (37)

ToolTitle
ar_aging_reportAccounts Receivable Aging Report
customer_ltv_reportCustomer Lifetime Value Report
get_communication_detailGet Communication Detail
get_company_proposal_habitsGet Company Proposal Habits
get_compliance_formGet Compliance Form
get_equipment_detailGet Equipment Detail
get_geology_at_locationGet Geology at Location
get_invoice_detailGet Invoice Detail
get_job_profitabilityGet Job Profitability
get_maintenance_dueGet Maintenance Due
get_project_compliance_statusGet Project Compliance Status
get_project_detailGet Project Detail
get_project_financialsGet Project Financials
get_proposal_detailGet Proposal Detail
get_quote_detailGet Quote Detail
get_quote_engagementGet Quote Engagement
get_timecard_summaryGet Timecard Summary
get_work_order_detailGet Work Order Detail
list_communicationsList Communications
list_contactsList Contacts
list_crewsList Crews
list_customersList Customers
list_equipmentList Equipment
list_field_reportsList Field Reports
list_inventoryList Inventory
list_invoicesList Invoices
list_my_projectsList My Projects
list_project_filesList Project Files
list_projects_by_customerList Projects by Customer
list_proposalsList Proposals
list_timecardsList Timecards
list_work_ordersList Work Orders
query_scheduleQuery Schedule
query_well_logsQuery Well Logs
revenue_pipelineRevenue Pipeline
run_reportRun Report
total_billed_by_contactTotal Billed by Contact

Write tools (8)

ToolTitleScopeApproval-gated
attach_note_to_projectAttach Note to Projectmcp:write:lowno
dispatch_projectDispatch Projectmcp:write:highyes
import_vendor_invoiceImport Vendor Invoicemcp:write:highyes
plan_crew_routePlan Crew Routemcp:write:lowno
schedule_projectSchedule Projectmcp:write:highyes
send_invoiceSend Invoicemcp:write:highyes
submit_field_reportSubmit Field Reportmcp:write:lowno
update_project_statusUpdate Project Statusmcp:write:highyes
All tools declare openWorldHint: false — each one operates only on the calling
company's own DrillerDB tenant data.

Support

About DrillerDB

DrillerDB is project management, well logging, scheduling, proposals, invoicing, equipment tracking, and customer history for water-well and drilling contractors, in one system. Learn more at drillerdb.com.

License

The documentation in this repository is MIT licensed. Use of the hosted DrillerDB MCP server is governed by the DrillerDB Terms of Service.

Source: README.md at commit 4707fb6

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts