@deeplinknow/mcp

The DeepLinkNow MCP server. It lets coding agents (Claude Code, Cursor, VS Code, Windsurf and any other MCP client) add deferred deep linking to an iOS, Android, React Native, Expo or Flutter app, check a link domain's Universal Links and App Links setup, and migrate from Firebase Dynamic Links, Branch, AppsFlyer or Adjust.

DeepLinkNow does deep linking only: Universal Links and App Links on your domain, and deferred deep links that survive an install. No attribution, ad tracking or advertising IDs. Any path on your link domain already works as a deep link.

Tools

It also exposes deeplinknow://llms.txt and deeplinknow://docs/{page} as resources, and two prompts: add_deferred_deep_linking and migrate_to_deeplinknow.

Related MCP server: ULink MCP Server

Install

Requires Node.js 20 or later. The server runs locally over stdio.

Claude Code

claude mcp add deeplinknow -- npx -y @deeplinknow/mcp

With the link tools (--scope user keeps the key out of the project's .mcp.json):

claude mcp add deeplinknow --scope user --env DEEPLINKNOW_API_KEY=YOUR_PRIVATE_KEY -- npx -y @deeplinknow/mcp

Cursor

Add to .cursor/mcp.json in the project, or ~/.cursor/mcp.json for every project:

{
  "mcpServers": {
    "deeplinknow": {
      "command": "npx",
      "args": ["-y", "@deeplinknow/mcp"],
      "env": { "DEEPLINKNOW_API_KEY": "${env:DEEPLINKNOW_API_KEY}" }
    }
  }
}

Leave out env if you don't need the link tools.

VS Code

Add to .vscode/mcp.json. VS Code asks for the key once and stores it securely:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "deeplinknow-api-key",
      "description": "DeepLinkNow private API key (dln_priv_…), only for list_links and create_link. Leave empty otherwise.",
      "password": true
    }
  ],
  "servers": {
    "deeplinknow": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@deeplinknow/mcp"],
      "env": { "DEEPLINKNOW_API_KEY": "${input:deeplinknow-api-key}" }
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "deeplinknow": {
      "command": "npx",
      "args": ["-y", "@deeplinknow/mcp"],
      "env": { "DEEPLINKNOW_API_KEY": "YOUR_PRIVATE_KEY" }
    }
  }
}

Leave out env if you don't need the link tools. This file is in your home directory, so the key isn't committed with your project.

Other clients

Any MCP client that runs stdio servers: command npx, arguments -y @deeplinknow/mcp.

Configuration

Never put the private key in your app: the app uses the public key (dln_pub_…). The server never prints, logs or returns the key; it only sends it in the x-api-key header to the API.

Tell your agent about it

Paste AGENTS.md into your repo's AGENTS.md or CLAUDE.md so every agent session knows how to use DeepLinkNow.

Privacy Policy

• What it sends, and where. get_setup_guide, search_docs, migrate_from and the resources fetch public docs from https://deeplinknow.com. check_domain fetches only https://<the domain you give it>/.well-known/…, Apple's CDN (app-site-association.cdn-apple.com), Google's Digital Asset Links API and the four public block lists; it refuses domains that resolve to private or local addresses. list_links and create_link send your API key and the link fields you give them to the DeepLinkNow API. explain_match_result makes no requests.

• What it stores. Nothing on disk. Docs, block lists and check results are cached in memory while the server runs (docs for an hour, block lists for a day, domain results for 5 minutes).

• No telemetry. The server collects no usage data and has no analytics.

• DeepLinkNow's own data handling is in the privacy policy. Questions: deeplinknow.com.

Develop

pnpm install
pnpm test        # vitest, network mocked
pnpm typecheck
pnpm lint        # Ultracite (Biome)
pnpm build       # dist/, runnable with node dist/index.js
pnpm smoke       # starts dist/index.js over stdio and lists the tools

The spec, with requirement IDs (MCP-…) that the tests cite, is docs/sdks/mcp.md in the DeepLinkNow repository.

License

MIT