---
title: "Enterprise MCP server (Streamable HTTP transport)"
method: POST
path: "/api/mcp"
tags: ["Enterprise MCP"]
---

# Enterprise MCP server (Streamable HTTP transport)

`POST /api/mcp`

## Request

- Base URL: `https://enterprise.drillerdb.com`
- URL: `https://enterprise.drillerdb.com/api/mcp`
- Auth: OAuth 2 (authorization code, authorization URL `https://enterprise.drillerdb.com/oauth/authorize`, token URL `https://enterprise.drillerdb.com/oauth/token`, scopes: `mcp:read:enterprise`)

Model Context Protocol endpoint for DrillerDB Enterprise customers: drilling-company prospect data, lead scores, saved lists, territories and market signals, exposed as MCP tools. Connect an MCP client to this URL; it discovers the OAuth server from the WWW-Authenticate header on the first 401 and from /.well-known/oauth-protected-resource. GET on the same path opens the server-to-client event stream and DELETE ends a session, per the MCP Streamable HTTP transport. Human setup guide: https://enterprise.drillerdb.com/docs.

## Request body

- JsonRpcRequest: A JSON-RPC 2.0 request as defined by the Model Context Protocol.
  - `jsonrpc` '2.0', required
  - `id` union
    - string
    - integer
  - `method` string, required: MCP method, e.g. initialize, tools/list, tools/call.
  - `params` object

## Response `200`

JSON-RPC response, as application/json or as a text/event-stream of JSON-RPC messages.

- JsonRpcResponse
  - `jsonrpc` '2.0', required
  - `id` union
    - string
    - integer
  - `result` object
  - `error` object
    - `code` integer, required
    - `message` string, required
    - `data` unknown

## Other responses

- `401`: Missing or invalid token. WWW-Authenticate: Bearer realm="enterprise-mcp", error=..., resource_metadata="https://enterprise.drillerdb.com/.well-known/oauth-protected-resource".

---

[API](https://skmtc.dev/drillerdb/apis/drillerdb-public-apis.md) · [All operations](https://skmtc.dev/drillerdb/apis/drillerdb-public-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/drillerdb/apis/drillerdb-public-apis/revisions/aeb372774d99?raw)