@layervai/qurl-mcp 0.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +98 -0
  3. package/dist/client.d.ts +278 -0
  4. package/dist/client.d.ts.map +1 -0
  5. package/dist/client.js +156 -0
  6. package/dist/client.js.map +1 -0
  7. package/dist/index.d.ts +3 -0
  8. package/dist/index.d.ts.map +1 -0
  9. package/dist/index.js +34 -0
  10. package/dist/index.js.map +1 -0
  11. package/dist/prompts/audit-links.d.ts +7 -0
  12. package/dist/prompts/audit-links.d.ts.map +1 -0
  13. package/dist/prompts/audit-links.js +31 -0
  14. package/dist/prompts/audit-links.js.map +1 -0
  15. package/dist/prompts/rotate-access.d.ts +18 -0
  16. package/dist/prompts/rotate-access.d.ts.map +1 -0
  17. package/dist/prompts/rotate-access.js +41 -0
  18. package/dist/prompts/rotate-access.js.map +1 -0
  19. package/dist/prompts/secure-a-service.d.ts +38 -0
  20. package/dist/prompts/secure-a-service.d.ts.map +1 -0
  21. package/dist/prompts/secure-a-service.js +141 -0
  22. package/dist/prompts/secure-a-service.js.map +1 -0
  23. package/dist/resources/_shared.d.ts +31 -0
  24. package/dist/resources/_shared.d.ts.map +1 -0
  25. package/dist/resources/_shared.js +42 -0
  26. package/dist/resources/_shared.js.map +1 -0
  27. package/dist/resources/links.d.ts +15 -0
  28. package/dist/resources/links.d.ts.map +1 -0
  29. package/dist/resources/links.js +22 -0
  30. package/dist/resources/links.js.map +1 -0
  31. package/dist/resources/usage.d.ts +15 -0
  32. package/dist/resources/usage.d.ts.map +1 -0
  33. package/dist/resources/usage.js +18 -0
  34. package/dist/resources/usage.js.map +1 -0
  35. package/dist/server.d.ts +37 -0
  36. package/dist/server.d.ts.map +1 -0
  37. package/dist/server.js +58 -0
  38. package/dist/server.js.map +1 -0
  39. package/dist/tools/_shared.d.ts +78 -0
  40. package/dist/tools/_shared.d.ts.map +1 -0
  41. package/dist/tools/_shared.js +80 -0
  42. package/dist/tools/_shared.js.map +1 -0
  43. package/dist/tools/batch-create.d.ts +426 -0
  44. package/dist/tools/batch-create.d.ts.map +1 -0
  45. package/dist/tools/batch-create.js +81 -0
  46. package/dist/tools/batch-create.js.map +1 -0
  47. package/dist/tools/create-qurl.d.ts +316 -0
  48. package/dist/tools/create-qurl.d.ts.map +1 -0
  49. package/dist/tools/create-qurl.js +106 -0
  50. package/dist/tools/create-qurl.js.map +1 -0
  51. package/dist/tools/delete-qurl.d.ts +55 -0
  52. package/dist/tools/delete-qurl.d.ts.map +1 -0
  53. package/dist/tools/delete-qurl.js +76 -0
  54. package/dist/tools/delete-qurl.js.map +1 -0
  55. package/dist/tools/extend-qurl.d.ts +238 -0
  56. package/dist/tools/extend-qurl.d.ts.map +1 -0
  57. package/dist/tools/extend-qurl.js +45 -0
  58. package/dist/tools/extend-qurl.js.map +1 -0
  59. package/dist/tools/get-qurl.d.ts +231 -0
  60. package/dist/tools/get-qurl.d.ts.map +1 -0
  61. package/dist/tools/get-qurl.js +39 -0
  62. package/dist/tools/get-qurl.js.map +1 -0
  63. package/dist/tools/list-qurls.d.ts +395 -0
  64. package/dist/tools/list-qurls.d.ts.map +1 -0
  65. package/dist/tools/list-qurls.js +72 -0
  66. package/dist/tools/list-qurls.js.map +1 -0
  67. package/dist/tools/mint-link.d.ts +384 -0
  68. package/dist/tools/mint-link.d.ts.map +1 -0
  69. package/dist/tools/mint-link.js +75 -0
  70. package/dist/tools/mint-link.js.map +1 -0
  71. package/dist/tools/output-schemas.d.ts +1261 -0
  72. package/dist/tools/output-schemas.d.ts.map +1 -0
  73. package/dist/tools/output-schemas.js +173 -0
  74. package/dist/tools/output-schemas.js.map +1 -0
  75. package/dist/tools/resolve-qurl.d.ts +72 -0
  76. package/dist/tools/resolve-qurl.d.ts.map +1 -0
  77. package/dist/tools/resolve-qurl.js +42 -0
  78. package/dist/tools/resolve-qurl.js.map +1 -0
  79. package/dist/tools/update-qurl.d.ts +330 -0
  80. package/dist/tools/update-qurl.d.ts.map +1 -0
  81. package/dist/tools/update-qurl.js +96 -0
  82. package/dist/tools/update-qurl.js.map +1 -0
  83. package/package.json +58 -0
@@ -0,0 +1,96 @@
1
+ import { z } from "zod";
2
+ import { resourceIdSchema, toStructuredContent, withMissingApiKeyHandler, zodErrorToToolResult, } from "./_shared.js";
3
+ import { updateQurlOutputSchema } from "./output-schemas.js";
4
+ // Tags must match the API constraints: 1-50 chars, start with alphanumeric,
5
+ // allow alphanumerics/spaces/underscores/hyphens. Max 10 tags per resource.
6
+ // See qurl/api/openapi.yaml -> UpdateQurlRequest.tags.
7
+ const tagSchema = z
8
+ .string()
9
+ .min(1)
10
+ .max(50)
11
+ .regex(/^[a-zA-Z0-9][a-zA-Z0-9 _-]*$/, "Tag must start with alphanumeric and contain only letters, numbers, spaces, underscores, or hyphens");
12
+ export const updateQurlBaseSchema = z.object({
13
+ resource_id: resourceIdSchema("update"),
14
+ extend_by: z.string().min(1).optional().describe('Duration to extend by (e.g., "24h", "7d"). Mutually exclusive with expires_at.'),
15
+ expires_at: z.string().datetime().optional().describe("Absolute expiration timestamp (RFC 3339). Mutually exclusive with extend_by."),
16
+ tags: z
17
+ .array(tagSchema)
18
+ .max(10)
19
+ .optional()
20
+ .describe("Replace all tags on this resource (max 10 tags, each 1-50 chars)"),
21
+ description: z
22
+ .string()
23
+ .max(500)
24
+ .optional()
25
+ .describe("Replace the resource description (max 500 chars)"),
26
+ custom_domain: z
27
+ .string()
28
+ .max(253)
29
+ .optional()
30
+ .describe("Replace the custom domain bound to this resource (max 253 chars, must be registered/active/owned). " +
31
+ 'Pass "" to clear.'),
32
+ preserve_host: z
33
+ .boolean()
34
+ .optional()
35
+ .describe("Whether to preserve the original Host header when proxying via the custom domain. " +
36
+ "Only meaningful when custom_domain is set; default false on the API side."),
37
+ });
38
+ export const updateQurlSchema = updateQurlBaseSchema
39
+ .refine((data) => !(data.extend_by && data.expires_at), {
40
+ message: "Provide either extend_by or expires_at, not both",
41
+ })
42
+ .refine(
43
+ // Use `!== undefined` rather than truthy checks so the API's "clear"
44
+ // semantics work: the spec documents `description: ""` and `tags: []`
45
+ // as valid payloads that clear the field, and the same applies to
46
+ // `custom_domain: ""`. A plain `||` would reject these because
47
+ // empty string / empty array / `false` are falsy in JS.
48
+ (data) => data.extend_by !== undefined ||
49
+ data.expires_at !== undefined ||
50
+ data.tags !== undefined ||
51
+ data.description !== undefined ||
52
+ data.custom_domain !== undefined ||
53
+ data.preserve_host !== undefined, {
54
+ message: "At least one update field (extend_by, expires_at, tags, description, custom_domain, or preserve_host) is required",
55
+ });
56
+ export function updateQurlTool(client) {
57
+ return {
58
+ name: "update_qurl",
59
+ title: "Update qURL",
60
+ description: "Update a qURL's expiration, tags, description, custom domain, or proxy host-header behavior. The richer alternative to `extend_qurl` — use `update_qurl` whenever you need anything beyond a relative time push. " +
61
+ "Accepts both `r_` and `q_` IDs (q_ is auto-resolved). " +
62
+ "**Constraints:** `extend_by` and `expires_at` are mutually exclusive; at least one update field (`extend_by`, `expires_at`, `tags`, `description`, `custom_domain`, `preserve_host`) must be set. " +
63
+ "**Clearing fields:** pass `description: \"\"`, `tags: []`, or `custom_domain: \"\"` to clear those fields explicitly. " +
64
+ "Use `extend_qurl` when the only change is a relative time push. " +
65
+ "Use `delete_qurl` when you want to revoke entirely. " +
66
+ "**Errors:** if the input fails schema refinements (both extend_by + expires_at, or no fields set), the handler returns an `isError: true` content block before any API call. Other API errors throw with the API's `code`/`statusCode`. " +
67
+ "Returns the updated resource (same shape as `get_qurl`).",
68
+ // Base shape for MCP tool registration; refinements run in the handler
69
+ inputSchema: updateQurlBaseSchema,
70
+ outputSchema: updateQurlOutputSchema,
71
+ annotations: {
72
+ title: "Update qURL",
73
+ readOnlyHint: false,
74
+ destructiveHint: false,
75
+ idempotentHint: false,
76
+ openWorldHint: true,
77
+ },
78
+ handler: withMissingApiKeyHandler(async (raw) => {
79
+ const parsed = updateQurlSchema.safeParse(raw);
80
+ if (!parsed.success)
81
+ return zodErrorToToolResult(parsed.error);
82
+ const { resource_id, ...body } = parsed.data;
83
+ const result = await client.updateQURL(resource_id, body);
84
+ return {
85
+ content: [
86
+ {
87
+ type: "text",
88
+ text: JSON.stringify(result.data),
89
+ },
90
+ ],
91
+ structuredContent: toStructuredContent(result.data),
92
+ };
93
+ }),
94
+ };
95
+ }
96
+ //# sourceMappingURL=update-qurl.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"update-qurl.js","sourceRoot":"","sources":["../../src/tools/update-qurl.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,58 @@
1
+ {
2
+ "name": "@layervai/qurl-mcp",
3
+ "version": "0.4.0",
4
+ "description": "MCP server for qURL™ — secure link management for AI agents. Quantum URL is how you enter the hidden layer of the internet.",
5
+ "mcpName": "io.github.layervai/qurl-mcp",
6
+ "type": "module",
7
+ "bin": {
8
+ "qurl-mcp": "./dist/index.js"
9
+ },
10
+ "main": "./dist/index.js",
11
+ "types": "./dist/index.d.ts",
12
+ "scripts": {
13
+ "build": "tsc",
14
+ "dev": "tsc --watch",
15
+ "start": "node dist/index.js",
16
+ "lint": "eslint src/",
17
+ "test": "vitest run",
18
+ "format": "prettier --write 'src/**/*.ts'",
19
+ "format:check": "prettier --check 'src/**/*.ts'",
20
+ "prepublishOnly": "npm run build"
21
+ },
22
+ "keywords": [
23
+ "mcp",
24
+ "qurl",
25
+ "layerv",
26
+ "security",
27
+ "ai-agents"
28
+ ],
29
+ "author": "LayerV AI",
30
+ "license": "MIT",
31
+ "repository": {
32
+ "type": "git",
33
+ "url": "https://github.com/layervai/qurl-mcp"
34
+ },
35
+ "dependencies": {
36
+ "@modelcontextprotocol/sdk": "^1.12.1",
37
+ "zod": "^3.24.4"
38
+ },
39
+ "devDependencies": {
40
+ "@eslint/js": "^9.27.0",
41
+ "@types/node": "^25.4.0",
42
+ "@typescript-eslint/eslint-plugin": "^8.59.0",
43
+ "@typescript-eslint/parser": "^8.32.1",
44
+ "eslint": "^10.2.1",
45
+ "prettier": "^3.8.3",
46
+ "typescript": "^6.0.3",
47
+ "vitest": "^4.1.5"
48
+ },
49
+ "engines": {
50
+ "node": ">=18"
51
+ },
52
+ "files": [
53
+ "dist/"
54
+ ],
55
+ "publishConfig": {
56
+ "access": "public"
57
+ }
58
+ }