mcpgw documentation

Pick the quadrant that matches what you're trying to do.

These docs follow the Diátaxis framework: tutorials for learning, how-to guides for solving specific problems, reference for looking things up, and explanation for understanding the design.

10-minute quickstart First traced call →

Diátaxis quadrants

Four kinds of doc, four reasons to read

Lessons

Tutorials

Learning-oriented walkthroughs. Follow them top-to-bottom; designed so you cannot fail if you copy carefully.

Recipes

How-to guides

Task-oriented recipes. Each one solves a single problem and assumes you already know how to start the gateway.

Dictionary

Reference

Information-oriented technical descriptions. Look here for the exact answer to "what does this field do?"

Discussion

Explanation

Understanding-oriented discussion. Make the right design call, not just copy a recipe.

Start here

First time with mcpgw?

Quickstart

10 minutes from docker pull to first traced span in Datadog APM.

Your first traced MCP call

Run mcpgw locally, point an MCP client at it, watch the span land in Datadog.

Protect a real MCP server

Wrap an existing filesystem MCP server with deny / redact / rate-limit rules.

Popular how-tos

Solving a specific problem?

Reference

Looking up a specific fact

Configuration schema

Every key in mcpgw.yaml.

Policy rule schema

Full grammar for policy.rules[].

OpenTelemetry semantic conventions

Span names, attributes, enum values.

Audit log schema

Every field in audit.jsonl.

Error codes

Every JSON-RPC + HTTP code mcpgw can return.

CLI commands and flags

mcpgw server, stdio, key generate, healthcheck, version.