What can you do with this server?

The qURL MCP server enables AI agents to create, manage, and resolve secure, policy-bound links (qURLs) for protecting web resources. * Create secure links (create_qurl): Generate a protected qURL for any target URL with options for expiration, one-time use, session limits, custom domains, and fine-grained access policies (IP allowlists/denylists, geo restrictions, AI agent blocking, user-agent filtering). * Resolve access tokens (resolve_qurl): Exchange an access token to retrieve the target URL and temporarily open firewall access for the requester's IP. * List qURLs (list_qurls): Retrieve a paginated list of qURLs with filtering by status, date ranges, and search query. * Get details (get_qurl): Fetch full information about a qURL using its resource ID (r_) or display ID (q_), including access tokens. * Delete/revoke (delete_qurl): Immediately invalidate and remove a qURL link. * Extend expiration (extend_qurl): Prolong the expiry of an active qURL by a relative duration. * Update qURLs (update_qurl): Modify expiration, tags, or description on an existing qURL. * Mint new links (mint_link): Generate additional access tokens for an existing protected resource without duplicating policies. * Batch create (batch_create_qurls): Create up to 100 qURLs in a single request, with per-item error reporting for partial failures. * Read resources: Exposes qurl://links (active links) and qurl://usage (quota/usage) for agent access.

de en es ja ko ru zh

qURL

by layervai

Overview Schema Related Servers Score Discussions

TypeScript

Remote

@layervai/qurl-mcp

npm version

⚠️ Renamed from @layerv/qurl-mcp in v0.4.0. The old package is deprecated and will not receive further updates. If you're using @layerv/qurl-mcp@0.3.x, swap the scope in your MCP client config — same binary, same API key, no other changes.

MCP server for qURL™ secure link management.

Quantum URL (qURL) · The internet has a hidden layer. This is how you enter.

What it does

qURL MCP Server is a Model Context Protocol server that lets AI agents (Claude, GPT, Cursor, etc.) create, resolve, list, and manage qURL secure links natively. It connects to the qURL API over stdio transport, so any MCP-compatible client can use it without custom integration code.

Quick Start

Add the server to your MCP client configuration (Claude Desktop, Claude Code, etc.):

{
  "mcpServers": {
    "qurl": {
      "command": "npx",
      "args": ["@layervai/qurl-mcp"],
      "env": { "QURL_API_KEY": "lv_live_xxx" }
    }
  }
}

Replace lv_live_xxx with your actual API key. The key must have the appropriate scopes for the tools you intend to use (see below).

Available Tools

Tool	Description	Required Scope
`create_qurl`	Create a secure, policy-bound link to a protected resource	`qurl:write`
`resolve_qurl`	Resolve an access token to get the target URL and open firewall access	`qurl:resolve`
`list_qurls`	List active qURLs with optional pagination	`qurl:read`
`get_qurl`	Get details of a specific qURL by resource ID	`qurl:read`
`delete_qurl`	Revoke a qURL, immediately invalidating the link	`qurl:write`
`extend_qurl`	Extend the expiration of an active qURL (alias for `update_qurl`)	`qurl:write`
`update_qurl`	Update expiration, tags, or description on an active qURL	`qurl:write`
`mint_link`	Mint a new access link for an existing protected resource	`qurl:write`
`batch_create_qurls`	Create multiple qURLs in a single call	`qurl:write`

Available Resources

URI	Name	Description
`qurl://links`	Active qURL Links	List of all active qURL links
`qurl://usage`	qURL Usage & Quota	Current quota and usage information

Configuration

Environment Variable	Required	Description	Default
`QURL_API_KEY`	Conditional (see description)	API key with appropriate scopes (`qurl:read`, `qurl:write`, `qurl:resolve`). The server boots without it so MCP introspection (`tools/list`, `resources/list`, `prompts/list`) works for directory probes — required only on the first tool call or resource read, where invocations surface a typed `missing_api_key` error until the key is set.	--
`QURL_API_URL`	No	qURL API base URL	`https://api.layerv.ai`

Docker

A multi-stage Dockerfile is included for container-based deployment:

docker build -t qurl-mcp .
docker run -i -e QURL_API_KEY=lv_live_xxx qurl-mcp

The image runs as the non-root node user, ships only production dependencies, and uses tini as PID 1 for clean signal handling.

If a tool call returns missing_api_key despite QURL_API_KEY looking set, check stderr for the boot-time warning — some MCP hosts hide stderr, and the warning is the fastest way to spot a whitespace-only or unset value:

docker logs <container>          # if running detached
docker run -i -e QURL_API_KEY=lv_live_xxx qurl-mcp 2>&1  # interactive

Development

npm install
npm run build
npm test
npm run lint

Additional commands:

npm run dev          # Watch mode (rebuild on changes)
npm run format       # Format source with Prettier
npm run format:check # Check formatting without modifying files

License

MIT -- LayerV AI

Install Server

license - permissive license

quality

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

6dRelease cycle

9Releases (12mo)

Issues opened vs closed

Resources

Need Help?

Related Servers

Tools

View all tools

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/layervai/qurl-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server