---
title: Datadog
description: Query metrics, monitors, and logs through Datadog's MCP server.
type: connection
keywords:
  - mcp
  - observability
  - metrics
  - monitoring
  - logs
---

# Datadog

Connection integration for eve. Query metrics, monitors, and logs through Datadog's MCP server.

## Install

Add the connection from eve's registry. This writes the initial definition under `agent/connections/` and installs its authentication dependency when needed:

```bash
eve add connection/datadog
```

## Quick start

### MCP · JWT bearer

Create `agent/connections/datadog.ts`. The connection name is derived from the filename:

```ts
// agent/connections/datadog.ts
import { connect } from "@vercel/connect/eve";
import { defineMcpClientConnection } from "eve/connections";

export default defineMcpClientConnection({
  url: "https://mcp.datadoghq.com/api/mcp",
  description: "Datadog: query metrics, monitors, logs, and incidents.",
  auth: connect({
    connector: "datadog",
    principalToSubject: (principal) => {
      const email = principal.type === "user" ? principal.attributes?.email : undefined;
      if (typeof email !== "string") {
        throw new Error("JWT bearer authentication requires a user principal with an email.");
      }
      return { type: "jwt-bearer", sub: email };
    },
  }),
});
```

Connect exchanges a JWT bearer assertion for a provider token. `principalToSubject` maps each principal to the subject your IdP expects.

## Configure

### MCP · JWT bearer

Link your project, create the connector, and pull OIDC locally:

```bash
vercel link
vercel connect create datadog
vercel env pull
```

For JWT bearer, `principalToSubject` controls the asserted subject. The default maps app principals to `{ type: "app" }` and user principals to `{ type: "user", id, issuer }`.

Match the MCP `url` to your Datadog site (`datadoghq.com`, `datadoghq.eu`, and so on).

See the [Connections docs](/docs/connections) for principal types, headers, approval, and protocol-specific filters.

[Read the full connection documentation](/docs/connections/mcp)

---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)

For agent-facing discovery, including API and MCP surfaces, see [/agents.md](/agents.md)