
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
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.
Installation
In SourceWeft
- Open DrillerDB in the dashboard and add it to a workspace.
- Connect the required credentials. They are stored privately and never shown on public pages.
- 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.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.
This repository holds the public documentation and the
server.jsonregistry 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
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:
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
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
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_idbound 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)
Write tools (8)
Support
- Documentation: https://drillerdb.com/connectors/mcp
- Email: [email protected]
- Issues with this documentation: open an issue on this repository.
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
0Version history
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