Skip to content
MCP server

qURL

Let an agent publish a local app or file as an expiring, scope-limited access link

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.11.1
Listing updated
3 days ago

About qURL

qURL is a freemium MCP server for security. It runs locally on your machine and is started by your AI client.

A qURL is a cryptographic, time-limited link to a resource kept off the public internet. This server gives an agent tools to create and manage them: publish a running localhost app, share it with a chosen lifetime, upload a PDF or image and mint a link to it, then resolve, audit or rotate links. Each link can expire on its own and be limited to a single use or a number of concurrent sessions. The pricing FAQ is blunt that a qURL is a bearer link, so it does not prove who holds it.

There are two modes. Without an API key it runs through the local qURL CLI and needs no account; with a key carrying qurl:read, qurl:write or qurl:resolve scopes it uses the API and unlocks upload tools. In local mode, publish_crid publishes an already-running app and share_by_crid issues its link; creating a link does not start the app or restrict an existing public URL.

It installs from npm as @layervai/qurl-mcp. Without an account you get up to 3 active resources with links lasting up to 24 hours; a free account allows 10 resources and 10 GiB a month, and the Team plan is $49 a month. LayerV's wider pitch is making apps unreachable by scanners.

Install

Run in a terminal

claude mcp add qurl-mcp --env QURL_API_KEY='<QURL_API_KEY>' --env QURL_SMTP_USERNAME='<QURL_SMTP_USERNAME>' --env QURL_SMTP_PASSWORD='<QURL_SMTP_PASSWORD>' -- npx -y @layervai/qurl-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "qurl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@layervai/qurl-mcp"
      ],
      "env": {
        "QURL_API_KEY": "<QURL_API_KEY>",
        "QURL_SMTP_USERNAME": "<QURL_SMTP_USERNAME>",
        "QURL_SMTP_PASSWORD": "<QURL_SMTP_PASSWORD>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "qurl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@layervai/qurl-mcp"
      ],
      "env": {
        "QURL_API_KEY": "<QURL_API_KEY>",
        "QURL_SMTP_USERNAME": "<QURL_SMTP_USERNAME>",
        "QURL_SMTP_PASSWORD": "<QURL_SMTP_PASSWORD>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "qurl-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@layervai/qurl-mcp"
      ],
      "env": {
        "QURL_API_KEY": "<QURL_API_KEY>",
        "QURL_SMTP_USERNAME": "<QURL_SMTP_USERNAME>",
        "QURL_SMTP_PASSWORD": "<QURL_SMTP_PASSWORD>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "qurl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@layervai/qurl-mcp"
      ],
      "env": {
        "QURL_API_KEY": "<QURL_API_KEY>",
        "QURL_SMTP_USERNAME": "<QURL_SMTP_USERNAME>",
        "QURL_SMTP_PASSWORD": "<QURL_SMTP_PASSWORD>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "qurl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@layervai/qurl-mcp"
      ],
      "env": {
        "QURL_API_KEY": "<QURL_API_KEY>",
        "QURL_SMTP_USERNAME": "<QURL_SMTP_USERNAME>",
        "QURL_SMTP_PASSWORD": "<QURL_SMTP_PASSWORD>"
      }
    }
  }
}

Configuration

  • QURL_API_KEYOptional. Without it, the tools run through the local qURL CLI (qurl), which needs no account. With it, the tools use the qURL API: a key with qurl:read, qurl:write, and/or qurl:resolve scopes from https://layerv.ai.
  • QURL_API_URLqURL API base URL. Defaults to https://api.layerv.ai. Override only for testing against a non-production qURL backend.
  • QURL_CONNECTOR_URLConnector base URL used by local-file, file-data, and text-to-PDF upload tools before minting a qURL.
  • QURL_LINK_HOSTSOptional comma-separated exact hostnames or IPs for uploaded-file links. No schemes, ports, or wildcards. Blank values retain any file-configured policy.
  • QURL_MCP_CONFIGOptional path to a shared qURL MCP config file. Both stdio and HTTP modes can read SMTP, connector, and default API settings from this file.
  • MCP_MAX_UPLOAD_FILE_DATA_BYTESMaximum decoded/local upload size. Accepts bytes or units such as 10mb; capped at 100mb.
  • QURL_SMTP_HOSTSMTP hostname for optional qURL link delivery.
  • QURL_SMTP_PORTSMTP port for optional qURL link delivery.
  • QURL_SMTP_SECUREWhether SMTP uses an implicit TLS connection (true/false).
  • QURL_SMTP_USERNAMESMTP authentication username.
  • QURL_SMTP_PASSWORDSMTP authentication password or app-specific credential.
  • QURL_SMTP_FROM_EMAILValidated sender email address for qURL delivery.
  • QURL_SMTP_FROM_NAMEOptional sender display name for qURL delivery.
  • QURL_SMTP_ALLOWED_RECIPIENTSOptional comma-separated exact recipient allowlist.
  • QURL_SMTP_ALLOWED_RECIPIENT_DOMAINSOptional comma-separated recipient-domain allowlist.
  • QURL_SMTP_MAX_RECIPIENTS_PER_MESSAGEMaximum recipients in one delivery request (default 10).
  • QURL_SMTP_MAX_RECIPIENTS_PER_HOURMaximum attempted recipients per qURL key per fixed hourly window (default 100).
  • QURL_MCP_FEEDBACKSet to off to hide and disable outbound LayerV product feedback. Default on. Feedback is sent only by an explicit submit_feedback tool call.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

publish_crid
Publish an already-running local app and return its CRID.
share_by_crid
Issue an access link for a published CRID.
mint_link
Mint a link for a resource managed through the API.
upload_file_qurl
Upload a local PDF or image and mint a link.

What it does

Share localhost
Publish a running local app and issue a link to it.
Expiring links
Set a lifetime; links can be single-use or session-limited.
File sharing
Upload a PDF or image and mint a short-lived link.
Link management
Mint, resolve, audit and rotate links.
No-account mode
Local CLI mode needs no account or key.
Scoped API keys
API mode uses read, write and resolve scopes.

Good for

  • Give a reviewer temporary access to a dev preview
  • Share a private API with a teammate for an hour
  • Send a PDF report as a short-lived link
  • Revoke or rotate a link that leaked
  • Audit who opened a shared resource

Pricing

Freemium, from $49 a month

Free tiers; Team $49/mo; Enterprise by pilot

Prices change. Check layerv.ai before you buy.

qURL FAQ

Do I need an account?

No for local CLI mode, with up to 3 active resources and 24-hour links; yes for the API tools and uploads.

Does a link restrict an existing public URL?

No. The README says creating a link alone does not publish an app or restrict a public URL.

What does it cost?

Free for individuals and a free account; Team is $49 a month for 50 resources and 50 GiB.

Does the link prove who opened it?

No. A qURL is a bearer link and is not bound to a person.

Is qURL free?

qURL has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

How do I add qURL to Claude Code?

Run this command in your terminal: claude mcp add qurl-mcp --env QURL_API_KEY='<QURL_API_KEY>' --env QURL_SMTP_USERNAME='<QURL_SMTP_USERNAME>' --env QURL_SMTP_PASSWORD='<QURL_SMTP_PASSWORD>' -- npx -y @layervai/qurl-mcp

What are the best alternatives to qURL?

The closest alternatives to qURL are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to qURL

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools