telique-mcp 1.0.25 → 1.0.26

package/dist/annotations.d.ts

@@ -0,0 +1,5 @@
+export declare const READ_ONLY_ANNOTATIONS: {
+    readonly readOnlyHint: true;
+    readonly openWorldHint: false;
+    readonly destructiveHint: false;
+};

package/dist/annotations.js

@@ -0,0 +1,5 @@
+export const READ_ONLY_ANNOTATIONS = {
+    readOnlyHint: true,
+    openWorldHint: false,
+    destructiveHint: false,
+};

package/dist/lib.d.ts

@@ -10,4 +10,5 @@ export { registerStatusTools } from "./tools/status.js";
 export { registerKnowledge, TELIQUE_KNOWLEDGE } from "./knowledge.js";
 export { ICONS, ICON_LIGHT_DATA_URI, ICON_DARK_DATA_URI } from "./icons.js";
 export { VERSION } from "./version.js";
+export { READ_ONLY_ANNOTATIONS } from "./annotations.js";
 export type { ToolRegistrar } from "./types.js";

package/dist/lib.js

@@ -14,3 +14,5 @@ export { registerKnowledge, TELIQUE_KNOWLEDGE } from "./knowledge.js";
 // Metadata
 export { ICONS, ICON_LIGHT_DATA_URI, ICON_DARK_DATA_URI } from "./icons.js";
 export { VERSION } from "./version.js";
+// Annotations
+export { READ_ONLY_ANNOTATIONS } from "./annotations.js";

package/dist/tools/cnam.js

@@ -1,12 +1,13 @@
 import { z } from "zod";
 import { formatResponse } from "../utils/formatting.js";
+import { READ_ONLY_ANNOTATIONS } from "../annotations.js";
 export function registerCnamTools(server, client) {
     server.tool("cnam_lookup", "Look up the Caller Name (CNAM) for a phone number via TransUnion LIDB. Returns the calling_name (up to 15 characters), calling_name_status (available/unavailable), and presentation_indicator (allowed/restricted). Results are cached server-side for 24 hours.", {
         phone_number: z
             .string()
             .regex(/^\d{10,15}$/)
             .describe("10-15 digit phone number to look up"),
-    }, async ({ phone_number }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ phone_number }) => {
         const result = await client.get(`/v1/telique/cnam/${phone_number}`);
         return formatResponse(result);
     });

package/dist/tools/composite.js

@@ -1,12 +1,13 @@
 import { z } from "zod";
 import { formatResponse } from "../utils/formatting.js";
+import { READ_ONLY_ANNOTATIONS } from "../annotations.js";
 export function registerCompositeTools(server, client) {
     server.tool("lookup_tn", "Composite phone number lookup across multiple Telique services. Dips LRN, CNAM, DNO, and LERG (NPA-NXX from lerg_6) in parallel and returns a consolidated view. Use this for a quick, comprehensive profile of any phone number.", {
         phone_number: z
             .string()
             .regex(/^\d{10}$/)
             .describe("10-digit US phone number"),
-    }, async ({ phone_number }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ phone_number }) => {
         const npa = phone_number.substring(0, 3);
         const nxx = phone_number.substring(3, 6);
         const [lrn, cnam, dno, lerg] = await Promise.all([

package/dist/tools/graphql.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { formatResponse } from "../utils/formatting.js";
+import { READ_ONLY_ANNOTATIONS } from "../annotations.js";
 export function registerGraphqlTools(server, client) {
     server.tool("graphql_query", `Execute GraphQL queries against LSMS or LERG. These are DISTINCT APIs with different schemas — do not mix their syntax.
 
@@ -14,7 +15,7 @@ LERG (service='lerg'): Static telecom reference. Uses FilterInput with operators
             .record(z.unknown())
             .optional()
             .describe("Optional GraphQL variables"),
-    }, async ({ service, query, variables }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ service, query, variables }) => {
         const path = service === "lsms"
             ? "/v1/telique/lsms/gql"
             : "/v1/telique/lerg/gql";

package/dist/tools/lerg.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { formatResponse } from "../utils/formatting.js";
+import { READ_ONLY_ANNOTATIONS } from "../annotations.js";
 const LERG_TABLES = [
     "lerg_1",
     "lerg_1_con",
@@ -35,7 +36,7 @@ export function registerLergTools(server, client) {
             .string()
             .optional()
             .describe("Specific table name (e.g. lerg_1, lerg_6, lerg_7_sha). Omit to list all tables."),
-    }, async ({ table_name }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ table_name }) => {
         if (table_name) {
             const result = await client.get(`/v1/telique/lerg/tables/${table_name}`);
             return formatResponse(result);
@@ -64,7 +65,7 @@ export function registerLergTools(server, client) {
             .min(0)
             .default(0)
             .describe("Pagination offset (default 0)"),
-    }, async ({ table_name, fields, query, limit, offset }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ table_name, fields, query, limit, offset }) => {
         // Encode & as %26 so multi-filters stay in the path segment
         const encodedQuery = query.replace(/&/g, "%26");
         const result = await client.get(`/v1/telique/lerg/${table_name}/${fields}/${encodedQuery}`, { limit, offset });
@@ -127,7 +128,7 @@ export function registerLergTools(server, client) {
             .min(0)
             .default(0)
             .describe("Pagination offset (default 0)"),
-    }, async ({ table, fields, filters, join, limit, offset }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ table, fields, filters, join, limit, offset }) => {
         const body = {
             table,
             filters,
@@ -177,7 +178,7 @@ export function registerLergTools(server, client) {
             .min(0)
             .default(0)
             .describe("Pagination offset (default 0)"),
-    }, async ({ npa, nxx, switch_clli, tandem, name, limit, offset }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ npa, nxx, switch_clli, tandem, name, limit, offset }) => {
         const params = {
             limit,
             offset,

package/dist/tools/lrn.js

@@ -1,12 +1,13 @@
 import { z } from "zod";
 import { formatResponse, errorResult } from "../utils/formatting.js";
+import { READ_ONLY_ANNOTATIONS } from "../annotations.js";
 export function registerLrnTools(server, client) {
     server.tool("lrn_lookup", "Look up the Local Routing Number (LRN) for a phone number. Returns the LRN, SPID (Service Provider ID), LNP type, and activation timestamp. LRN identifies the switch that serves a ported phone number. This queries live LSMS/NPAC porting data.", {
         phone_number: z
             .string()
             .regex(/^\d{10}$/)
             .describe("10-digit US phone number"),
-    }, async ({ phone_number }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ phone_number }) => {
         const result = await client.get(`/v1/telique/lrn/${phone_number}`, {
             format: "json",
         });
@@ -26,7 +27,7 @@ export function registerLrnTools(server, client) {
         value: z
             .string()
             .describe("The LRN, SPID, or phone number to query by (depends on query_type)"),
-    }, async ({ query_type, value }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ query_type, value }) => {
         const routeMap = {
             phones_by_lrn: { resource: "phone_number", param: "lrn" },
             phones_by_spid: { resource: "phone_number", param: "spid" },
@@ -47,7 +48,7 @@ export function registerLrnTools(server, client) {
             .string()
             .regex(/^\d{10}$/)
             .describe("10-digit US phone number to check"),
-    }, async ({ phone_number }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ phone_number }) => {
         const result = await client.get(`/v1/telique/dno/${phone_number}`, {
             format: "json",
         });

package/dist/tools/routelink.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
 import { formatResponse, errorResult } from "../utils/formatting.js";
+import { READ_ONLY_ANNOTATIONS } from "../annotations.js";
 export function registerRoutelinkTools(server, client) {
     server.tool("routelink_lookup", "Look up toll-free number routing. Resolves a CRN (toll-free number) to its carrier (CIC), Responsible Organization (ROR), or both. CIC lookup interprets the CPR decision tree using the caller's ANI and LATA to determine which carrier handles the call.", {
         crn: z
@@ -19,7 +20,7 @@ export function registerRoutelinkTools(server, client) {
             .regex(/^\d{3}$/)
             .optional()
             .describe("3-digit LATA code (required for cic and cicror lookups)"),
-    }, async ({ crn, lookup_type, ani, lata }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ crn, lookup_type, ani, lata }) => {
         if ((lookup_type === "cic" || lookup_type === "cicror") &&
             (!ani || !lata)) {
             return errorResult("ani and lata are required for cic and cicror lookups");
@@ -55,7 +56,7 @@ export function registerRoutelinkTools(server, client) {
             .min(0)
             .default(0)
             .describe("Pagination offset (default 0)"),
-    }, async ({ ror, resource_type, limit, offset }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ ror, resource_type, limit, offset }) => {
         const result = await client.get(`/v1/telique/ror/${ror}/${resource_type}`, { format: "json", limit, offset });
         return formatResponse(result);
     });
@@ -68,7 +69,7 @@ export function registerRoutelinkTools(server, client) {
             .boolean()
             .default(true)
             .describe("Recursively resolve and inline template decision trees (default true)"),
-    }, async ({ crn, expand }) => {
+    }, READ_ONLY_ANNOTATIONS, async ({ crn, expand }) => {
         // NOTE: /v1/telique/cpr/* path pending frontend URL map addition.
         // Falls back to /cpr/ which routes to routelink via default backend.
         const result = await client.get(`/v1/telique/cpr/${crn}`, {

package/dist/tools/status.js

@@ -1,7 +1,8 @@
 import { VERSION } from "../version.js";
 import { formatResponse } from "../utils/formatting.js";
+import { READ_ONLY_ANNOTATIONS } from "../annotations.js";
 export function registerStatusTools(server, client) {
-    server.tool("telique_status", "Returns the Telique MCP server version, authentication mode, and API connectivity status. Use this when asked about the server version or connection status.", {}, async () => {
+    server.tool("telique_status", "Returns the Telique MCP server version, authentication mode, and API connectivity status. Use this when asked about the server version or connection status.", {}, READ_ONLY_ANNOTATIONS, async () => {
         let apiReachable = false;
         try {
             const result = await client.get("/health");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "telique-mcp",
-  "version": "1.0.25",
+  "version": "1.0.26",
   "description": "MCP server for Telique telecom APIs (RouteLink, LRN, CNAM, LERG)",
   "type": "module",
   "main": "dist/index.js",