Skip to content

datadog-labs/cursor-plugin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

35 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

This plugin is currently in Preview.

Datadog Cursor Plugin

Query your Datadog data directly from Cursor using natural language. Ask about logs, metrics, traces, dashboards, monitors, and more.

What you need

Getting started

If you already have the Datadog MCP server registered separately, disable or remove it first to avoid conflicts.

  1. Open Cursor Settings by clicking on the gear icon in the left sidebar or by running the "Cursor Settings" command in the Command Palette.
  2. Go to the Plugins section
  3. Install the datadog plugin

Before you can start querying your Datadog data, you’ll need to connect the plugin to Datadog using your account. The setup process will guide you in selecting the correct Datadog MCP domain. After setup, restart Cursor and then complete authentication.

You can manually trigger setup by running the /ddsetup command in an agent chat window.

Using the plugin

Once connected, just ask the agent anything about your Datadog data:

Show me error logs from the last hour
What monitors are currently alerting?
Find traces for service "api-gateway" with latency > 500ms
List my dashboards

Can't connect?

Never connected before? Run the /ddsetup command in an agent chat window. It will help you provide the correct Datadog MCP domain and set up the MCP server.

Was working before but stopped? Run the /ddconfig command in an agent chat window. It will check your site, authentication status, and network access to help diagnose the issue.

Changing settings

The plugin provides a few commands you can run in the agent to manage configuration:

  • /ddconfig — change your Datadog site or switch organizations
  • /ddtoolsets — enable or disable groups of tools

Advanced usage

Key authentication

Instead of OAuth, you can authenticate using a Datadog API key and application key. Set all three environment variables before starting Cursor:

DD_MCP_DOMAIN=your-mcp-domain \
DD_API_KEY=your-api-key \
DD_APPLICATION_KEY=your-application-key

The DD_MCP_DOMAIN value must be the MCP domain (e.g. mcp.datadoghq.com, mcp.us3.datadoghq.com, mcp.datadoghq.eu), not a URL — do not include https://. When using key authentication, /ddsetup is not required — the plugin connects directly.

Environment variable overrides

The plugin uses environment variables with default values in its registration file. You can override these defaults by setting the environment variables directly:

  • DD_MCP_DOMAIN — overrides the Datadog MCP domain. If set, the plugin uses this value regardless of what /ddsetup or /ddconfig configured. Useful for non-standard environments or key authentication.
  • DD_MCP_TOOLSETS — overrides the enabled toolsets (comma-separated). If set, the plugin uses this value regardless of what /ddtoolsets configured.

When environment variables are set, /ddsetup, /ddconfig, and /ddtoolsets still edit the default values in the registration file, but those defaults won't take effect until the environment variables are removed.

Good to know

  • By default, authentication is handled via OAuth in your browser. Key authentication is also supported.
  • No Datadog credentials are sent to the AI model provider.

Support

Legal

See the LICENSE and NOTICE files included with this plugin.

For details on how Datadog handles your data, see the Datadog Privacy Policy.

Contributors