How do I install DrillerDB?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does DrillerDB need an API key?

No required environment variable is listed on this record.

What transport does DrillerDB use?

DrillerDB is reached over HTTP.

When was DrillerDB last checked?

Last checked 2026-10-23. Drilling jobs, customers, invoices, crews, schedules, and well logs for well contractors.

DrillerDB MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.drillerdb.com

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

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

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.drillerdb-drillerdb": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.drillerdb.com"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.0.1
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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


Transport	Streamable HTTP
Authentication	OAuth 2.0 (Authorization Code + PKCE, Dynamic Client Registration)
Hosting	Managed by DrillerDB, LLC. Nothing to install or self-host.
Account	Requires an active DrillerDB account (app.drillerdb.com)
Registry name	`com.drillerdb/drillerdb`
Full docs	drillerdb.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

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:

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

{
  "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

Scope	Grants
`mcp:read`	Read projects, customers, invoices, proposals, work orders, crews, schedule, field reports, equipment, timecards, communications, inventory, and well logs
`mcp:write:low`	Trivially reversible writes, such as attaching a note or submitting a field report
`mcp:write:high`	State-changing writes, such as scheduling or dispatching a job or sending an invoice
`mcp:proposals:write`	Proposal 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)

Tool	Title
`ar_aging_report`	Accounts Receivable Aging Report
`customer_ltv_report`	Customer Lifetime Value Report
`get_communication_detail`	Get Communication Detail
`get_company_proposal_habits`	Get Company Proposal Habits
`get_compliance_form`	Get Compliance Form
`get_equipment_detail`	Get Equipment Detail
`get_geology_at_location`	Get Geology at Location
`get_invoice_detail`	Get Invoice Detail
`get_job_profitability`	Get Job Profitability
`get_maintenance_due`	Get Maintenance Due
`get_project_compliance_status`	Get Project Compliance Status
`get_project_detail`	Get Project Detail
`get_project_financials`	Get Project Financials
`get_proposal_detail`	Get Proposal Detail
`get_quote_detail`	Get Quote Detail
`get_quote_engagement`	Get Quote Engagement
`get_timecard_summary`	Get Timecard Summary
`get_work_order_detail`	Get Work Order Detail
`list_communications`	List Communications
`list_contacts`	List Contacts
`list_crews`	List Crews
`list_customers`	List Customers
`list_equipment`	List Equipment
`list_field_reports`	List Field Reports
`list_inventory`

Write tools (8)

Tool	Title	Scope	Approval-gated
`attach_note_to_project`	Attach Note to Project	`mcp:write:low`	no
`dispatch_project`	Dispatch Project	`mcp:write:high`	yes
`import_vendor_invoice`	Import Vendor Invoice	`mcp:write:high`	yes
`plan_crew_route`	Plan Crew Route	`mcp:write:low`	no
`schedule_project`	Schedule Project	`mcp:write:high`	yes
`send_invoice`	Send Invoice	`mcp:write:high`	yes
`submit_field_report`	Submit Field Report	`mcp:write:low`	no
`update_project_status`	Update Project Status	`mcp:write:high`	yes
All tools declare `openWorldHint: false` — each one operates only on the calling
company's own DrillerDB tenant data.

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.

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install DrillerDB?

Does DrillerDB need an API key?

What transport does DrillerDB use?

When was DrillerDB last checked?

Documentation

DrillerDB MCP Server

Quick start

Claude Code

Claude (web and desktop)

Microsoft Copilot

Gemini CLI

Cursor / VS Code / other clients

What you can ask

Permission scopes

Security

Tool catalog

Read tools (37)

Write tools (8)

Support

About DrillerDB

License