@verifik/mcp 0.1.2 → 0.1.3

package/lib/filters.js

@@ -1,5 +1,95 @@
 "use strict";
 
+/** Canonical catalog country names (as stored on AppFeature.country). */
+const CATALOG_COUNTRY_NAMES = [
+	"Argentina",
+	"Bolivia",
+	"Brazil",
+	"Canada",
+	"Chile",
+	"Colombia",
+	"Costa Rica",
+	"Ecuador",
+	"El Salvador",
+	"Guatemala",
+	"Honduras",
+	"India",
+	"Mexico",
+	"Panama",
+	"Paraguay",
+	"Peru",
+	"República Dominicana",
+	"Spain",
+	"United States",
+	"Uruguay",
+	"Venezuela",
+	"world",
+];
+
+/** ISO 3166-1 alpha-2 codes accepted as aliases for catalog country names. */
+const COUNTRY_ISO_ALIASES = {
+	AR: "Argentina",
+	BO: "Bolivia",
+	BR: "Brazil",
+	CA: "Canada",
+	CL: "Chile",
+	CO: "Colombia",
+	CR: "Costa Rica",
+	DO: "República Dominicana",
+	EC: "Ecuador",
+	ES: "Spain",
+	GT: "Guatemala",
+	HN: "Honduras",
+	IN: "India",
+	MX: "Mexico",
+	PA: "Panama",
+	PE: "Peru",
+	PY: "Paraguay",
+	SV: "El Salvador",
+	US: "United States",
+	UY: "Uruguay",
+	VE: "Venezuela",
+};
+
+/**
+ * Normalize a country label for case- and accent-insensitive comparison.
+ * @param {string} value
+ */
+const normalizeCountryKey = (value) =>
+	String(value || "")
+		.normalize("NFD")
+		.replace(/[\u0300-\u036f]/g, "")
+		.toLowerCase()
+		.trim();
+
+/**
+ * Resolve one filter token (catalog name or ISO code) to a normalized country key.
+ * @param {string} filterValue
+ */
+const resolveFilterCountryKey = (filterValue) => {
+	const trimmed = String(filterValue || "").trim();
+	if (!trimmed) return null;
+
+	const upper = trimmed.toUpperCase();
+	if (upper === "WORLD") return "world";
+
+	const isoAlias = COUNTRY_ISO_ALIASES[upper];
+	if (isoAlias) return normalizeCountryKey(isoAlias);
+
+	return normalizeCountryKey(trimmed);
+};
+
+/**
+ * @param {string} featureCountry
+ * @param {string[]} countryFilter
+ */
+const matchesCountryFilter = (featureCountry, countryFilter) => {
+	if (!countryFilter.length) return true;
+
+	const featureKey = normalizeCountryKey(featureCountry);
+	return countryFilter.some((filter) => resolveFilterCountryKey(filter) === featureKey);
+};
+
 /**
  * @param {import("./types").AppFeature} feature
  * @param {import("./types").McpConfig} config
@@ -7,12 +97,20 @@
  */
 const isEligibleFeature = (feature, config, grantedFeatureCodes = null) => {
 	if (!feature?.code || !feature?.url) return false;
+	if (feature.legacy) return false;
 	if (config.smartCheckOnly && !feature.smartCheckEnabled) return false;
 	if (config.codeAllowlist.length && !config.codeAllowlist.includes(feature.code)) return false;
-	if (config.countryFilter.length && !config.countryFilter.includes(feature.country)) return false;
+	if (!matchesCountryFilter(feature.country, config.countryFilter)) return false;
 	if (config.baseCategoryFilter.length && !config.baseCategoryFilter.includes(feature.baseCategory)) return false;
 
-	if (feature.requiresClientFeature && grantedFeatureCodes && !grantedFeatureCodes.has(feature.code)) {
+	if (feature.clientHasAccess === false) return false;
+
+	if (
+		feature.clientHasAccess !== true &&
+		feature.requiresClientFeature &&
+		grantedFeatureCodes &&
+		!grantedFeatureCodes.has(feature.code)
+	) {
 		return false;
 	}
 
@@ -47,6 +145,11 @@ const toFeatureSummary = (feature) => ({
 });
 
 module.exports = {
+	CATALOG_COUNTRY_NAMES,
+	COUNTRY_ISO_ALIASES,
+	normalizeCountryKey,
+	resolveFilterCountryKey,
+	matchesCountryFilter,
 	isEligibleFeature,
 	filterFeatures,
 	toFeatureSummary,

package/lib/meta-tools.js

@@ -1,6 +1,6 @@
 "use strict";
 
-const { toFeatureSummary } = require("./filters");
+const { toFeatureSummary, matchesCountryFilter } = require("./filters");
 const { buildInputSchema } = require("./tool-schema");
 
 const LIST_CATALOG_TOOL = "verifik_list_catalog";
@@ -16,7 +16,8 @@ const META_TOOL_DEFINITIONS = [
 			properties: {
 				country: {
 					type: "string",
-					description: "Optional comma-separated country filter (e.g. Colombia,world).",
+					description:
+						"Optional comma-separated country filter. Accepts catalog country names (e.g. Colombia), ISO codes (e.g. CO), or world. Matching is case- and accent-insensitive.",
 				},
 				baseCategory: {
 					type: "string",
@@ -67,7 +68,7 @@ const handleListCatalog = async (catalogCache, args = {}) => {
 
 	const features = state.features.filter((feature) => {
 		if (smartCheckOnly === true && !feature.smartCheckEnabled) return false;
-		if (countryFilter.length && !countryFilter.includes(feature.country)) return false;
+		if (!matchesCountryFilter(feature.country, countryFilter)) return false;
 		if (baseCategoryFilter.length && !baseCategoryFilter.includes(feature.baseCategory)) return false;
 		if (codeFilter.length && !codeFilter.includes(feature.code)) return false;
 		return true;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@verifik/mcp",
-	"version": "0.1.2",
+	"version": "0.1.3",
 	"description": "Use Verifik identity verification, document checks, and background-screening APIs from Cursor, Claude Desktop, or any MCP client — across Latin America and worldwide.",
 	"main": "server.js",
 	"bin": {
@@ -16,7 +16,8 @@
 	"scripts": {
 		"start": "node server.js",
 		"test": "node --test tests/*.test.js",
-		"test:sandbox": "node --test tests/*.test.js"
+		"test:sandbox": "node --test tests/*.test.js",
+		"generate:endpoints-doc": "node scripts/generate-endpoints-doc.mjs"
 	},
 	"engines": {
 		"node": ">=18"