# qURL

> qURL is a freemium MCP server for security. Let an agent publish a local app or file as an expiring, scope-limited access link. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** CLI, API
- **Website:** https://layerv.ai
- **Repository:** https://github.com/layervai/qurl-mcp
- **MCP Registry name:** io.github.layervai/qurl-mcp
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/qurl
