MCP documentation menu

Connecting your AI assistant

The DataPulse MCP server is a remote server at:

https://mcp.datapulse.global

It uses the Streamable HTTP transport and OAuth sign-in. You never handle an API key. The first time your client connects, it opens a browser window where you log in with your DataPulse account, the same one you use on this website. If you don’t have an account yet, register here.

Claude (claude.ai and Claude Desktop)

  1. Open Settings → Connectors and choose Add custom connector.
  2. Give it a name, for example DataPulse, and enter https://mcp.datapulse.global as the URL.
  3. Choose Connect and log in with your DataPulse account.

Custom connectors are not available on every Claude plan. If you don’t see the option, check Anthropic’s documentation for your plan.

Claude Code

claude mcp add --transport http datapulse https://mcp.datapulse.global

Then run /mcp inside Claude Code and choose datapulse to log in.

Cursor

Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):

{
  "mcpServers": {
    "datapulse": {
      "url": "https://mcp.datapulse.global"
    }
  }
}

Cursor shows a login prompt for the server the first time it connects.

VS Code (GitHub Copilot)

Add the server to .vscode/mcp.json in your workspace, or to your user MCP configuration:

{
  "servers": {
    "datapulse": {
      "type": "http",
      "url": "https://mcp.datapulse.global"
    }
  }
}

opencode

Add the server to opencode.json (or ~/.config/opencode/opencode.json to use it in every project):

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "datapulse": {
      "type": "remote",
      "url": "https://mcp.datapulse.global",
      "timeout": 60000
    }
  }
}

Then log in:

opencode mcp auth datapulse

opencode allows 5 seconds per MCP request by default. Some DataPulse tools take longer than that. A first datapulse_domain_overview for a domain takes 15–30 seconds, and a synchronous scrape can wait up to 50. Set timeout as shown above.

Other clients

Any MCP client that supports remote servers with OAuth can connect to https://mcp.datapulse.global directly. For a client that only runs local (stdio) servers, use the mcp-remote bridge as the server command:

{
  "mcpServers": {
    "datapulse": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.datapulse.global"]
    }
  }
}

Checking the connection

Ask your assistant something like “Use DataPulse to give me an overview of example.com”. It should call datapulse_domain_overview and summarize the site, its DNS and its registration. To see what the server can do, ask it to “read the DataPulse MCP help”. It will call datapulse_help, which returns the same material as the guides.

How sign-in works

The server follows the MCP authorization specification, so a client that supports it sets up sign-in by itself:

  • Discovery. The server’s /.well-known/oauth-protected-resource document names DataPulse sign-in (https://auth.datapulse.global/) as its authorization server.
  • Client ID Metadata Documents. Your client identifies itself with the URL of a small JSON document it publishes, which lists its name and redirect URLs. DataPulse sign-in reads that document when you log in, so neither you nor the client has to register an OAuth application first.
  • OAuth 2.1 authorization code flow with PKCE (S256). Public clients need no client secret.
  • Refresh tokens. Clients that request offline_access stay signed in without logging in again each session.

Client ID Metadata Documents were added in the 2025-11-25 revision of the MCP authorization specification. Clients written for earlier revisions may try to register themselves with dynamic client registration, which DataPulse sign-in doesn’t offer. See Troubleshooting.

Scopes

Each tool needs one OAuth scope. The tool reference shows the scope on every tool page.

ScopeTools
datapulse:dnsLive DNS, RDAP and domain health; DNS history, label search, infrastructure similarity, clusters and registrars; UDRP case law (DisputeDB)
datapulse:scrapeWeb scraping and datapulse_domain_overview

datapulse_help, the ICANN Applicant Guidebook, 2026 Round applications and IDN variant tools need no scope. Clients normally request every scope the server advertises: datapulse:mcp, datapulse:dns and datapulse:scrape. Which tools actually work for you depends on your DataPulse plan.

Troubleshooting

401 Unauthorized. Your access token is missing or has expired. Reconnect or log in to the server again from your client. For example, use /mcp in Claude Code or opencode mcp auth datapulse.

403 Forbidden, or a tool reports missing permissions. You are signed in, but your plan doesn’t include that tool. See Pricing, or check your account at /app/. If calls that worked earlier start failing, you may have used up today’s MCP credits.

Your client says the server doesn’t support client registration. The client is trying dynamic client registration, which DataPulse sign-in doesn’t offer. Update it to a version that supports Client ID Metadata Documents, or contact us with the name of your MCP client.

The login page reports a redirect or callback URL error. With Client ID Metadata Documents, your client’s own document lists the redirect URLs it may use, so this is usually a problem in the client. Report it to the client’s developer, or contact us with the name of your MCP client and the URL shown in the error.

Tool calls time out. Raise your client’s MCP request timeout to 60 seconds or more. See the opencode example above.