qURL MCP Server

io.github.layervai/qurl-mcp

Repository Registry

What is the qURL MCP server?

Mint, resolve, audit, and rotate scope-limited expiring access links (qURLs) for AI agents.

How to install qURL

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

QURL_API_KEY
required
secret
API key for the qURL API with qurl:read, qurl:write, and/or qurl:resolve scopes. Obtain from https://layerv.ai.
QURL_API_URL
qURL API base URL. Defaults to https://api.layerv.ai. Override only for testing against a non-production qURL backend.
QURL_CONNECTOR_URL
Connector base URL used by local-file, file-data, and text-to-PDF upload tools before minting a qURL.
QURL_MCP_CONFIG
Optional 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_BYTES
Maximum decoded/local upload size. Accepts bytes or units such as 10mb; capped at 100mb.
QURL_SMTP_HOST
SMTP hostname for optional qURL link delivery.
QURL_SMTP_PORT
SMTP port for optional qURL link delivery.
QURL_SMTP_SECURE
Whether SMTP uses an implicit TLS connection (true/false).
QURL_SMTP_USERNAME
secret
SMTP authentication username.
QURL_SMTP_PASSWORD
secret
SMTP authentication password or app-specific credential.
QURL_SMTP_FROM_EMAIL
Validated sender email address for qURL delivery.
QURL_SMTP_FROM_NAME
Optional sender display name for qURL delivery.
QURL_SMTP_ALLOWED_RECIPIENTS
Optional comma-separated exact recipient allowlist.
QURL_SMTP_ALLOWED_RECIPIENT_DOMAINS
Optional comma-separated recipient-domain allowlist.
QURL_SMTP_MAX_RECIPIENTS_PER_MESSAGE
Maximum recipients in one delivery request (default 10).
QURL_SMTP_MAX_RECIPIENTS_PER_HOUR
Maximum attempted recipients per qURL key per fixed hourly window (default 100).

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "qurl-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@layervai/qurl-mcp"
      ],
      "env": {
        "QURL_API_KEY": "<YOUR_QURL_API_KEY>",
        "QURL_API_URL": "<YOUR_QURL_API_URL>",
        "QURL_CONNECTOR_URL": "<YOUR_QURL_CONNECTOR_URL>",
        "QURL_MCP_CONFIG": "<YOUR_QURL_MCP_CONFIG>",
        "MCP_MAX_UPLOAD_FILE_DATA_BYTES": "<YOUR_MCP_MAX_UPLOAD_FILE_DATA_BYTES>",
        "QURL_SMTP_HOST": "<YOUR_QURL_SMTP_HOST>",
        "QURL_SMTP_PORT": "<YOUR_QURL_SMTP_PORT>",
        "QURL_SMTP_SECURE": "<YOUR_QURL_SMTP_SECURE>",
        "QURL_SMTP_USERNAME": "<YOUR_QURL_SMTP_USERNAME>",
        "QURL_SMTP_PASSWORD": "<YOUR_QURL_SMTP_PASSWORD>",
        "QURL_SMTP_FROM_EMAIL": "<YOUR_QURL_SMTP_FROM_EMAIL>",
        "QURL_SMTP_FROM_NAME": "<YOUR_QURL_SMTP_FROM_NAME>",
        "QURL_SMTP_ALLOWED_RECIPIENTS": "<YOUR_QURL_SMTP_ALLOWED_RECIPIENTS>",
        "QURL_SMTP_ALLOWED_RECIPIENT_DOMAINS": "<YOUR_QURL_SMTP_ALLOWED_RECIPIENT_DOMAINS>",
        "QURL_SMTP_MAX_RECIPIENTS_PER_MESSAGE": "<YOUR_QURL_SMTP_MAX_RECIPIENTS_PER_MESSAGE>",
        "QURL_SMTP_MAX_RECIPIENTS_PER_HOUR": "<YOUR_QURL_SMTP_MAX_RECIPIENTS_PER_HOUR>"
      }
    }
  }
}

Related MCP servers

Layerz

Structured financial modeling for AI agents: build, version, audit models, export to Excel.

io.github.lazyants/hetzner

Active

MCP server for the Hetzner Cloud API — servers, networks, volumes, firewalls, and more.

TypeScript

View repository →

io.github.lazyants/lexware

Active

MCP server for the Lexware Office API — invoices, contacts, articles, and vouchers.

TypeScript

View repository →

io.github.lazyants/transkribus

Active

MCP server for the Transkribus REST API — collections, documents, HTR/OCR, and models.

TypeScript

View repository →

io.github.lazymac2x/a11y-scorer

Maintained

Cloudflare Workers MCP server: a11y-scorer

View repository →

io.github.lazymac2x/agent-loop-detector

Maintained

Cloudflare Workers MCP server: agent-loop-detector

View repository →