Getting started

Build the runtime, initialize local state, and make a first authenticated request.

DataPorch is a Go binary and globally installable CLI that runs locally and exposes an authenticated MCP surface plus a health surface:

/mcp is the authenticated MCP endpoint used by agent clients.
/healthz is a small health endpoint on the HTTP listener.
dataporch mcp is the stdio adapter bundled client plugins use; it forwards to the owner-only local MCP Unix socket.

For the fastest first run:

Install the CLI or build it from source.
Initialize local secrets and start the runtime.
Set explicit paths and execution limits.
Import a database.
Install a client plugin.

The default listener is 127.0.0.1:8080, so a fresh process is local-only until you deliberately change DATAPORCH_HTTP_ADDRESS. Use dataporch run -f for a foreground process or dataporch run for a native per-user service.

Local plugins do not require an MCP token. Direct HTTP clients can opt into the separate bearer-token flow documented in the database connection guide.