tender-mcp 1.2.3 → 1.2.5

package/CHANGELOG.md

@@ -1,3 +1,16 @@
+## [1.2.5] - 2026-04-28
+
+### Changed
+- Payment links updated to prepaid bundle URLs: 500 searches for $8 -- calls never expire
+- Free tier limit errors now direct agents to prepaid bundle purchase link directly
+
+## [1.2.4] - 2026-04-27
+
+### Added
+- `token_count` field on all tool responses — lets orchestrator budget ledgers track token cost per call
+- `/ready` endpoint — returns 200 when `ANTHROPIC_API_KEY` and `SAM_GOV_API_KEY` are present, 503 otherwise
+- Phase 4 enhanced error objects: `category`, `retryable`, `retry_after_ms`, `fallback_tool`, `trace_id` on all error paths across both tools
+
 ## [1.2.3] - 2026-04-26
 
 ### Improved

package/LICENSE

@@ -1,6 +1,21 @@
-UNLICENSED
+MIT License
 
-Copyright (c) 2026 Kord Agencies
+Copyright (c) 2026 Kord Agencies Pte Ltd
 
-All rights reserved. This software and its source code are proprietary and confidential.
-Unauthorized copying, modification, distribution, or use is strictly prohibited.
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tender-mcp",
   "mcpName": "io.github.OjasKord/tender-mcp",
-  "version": "1.2.3",
+  "version": "1.2.5",
   "description": "Government tender search and AI opportunity scoring for AI agents. UK Contracts Finder, EU TED, US SAM.gov.",
   "main": "src/server.js",
   "scripts": {
@@ -28,7 +28,7 @@
     "validator"
   ],
   "author": "Kord Agencies Pte Ltd <ojas@kordagencies.com>",
-  "license": "UNLICENSED",
+  "license": "MIT",
   "homepage": "https://kordagencies.com",
   "repository": {
     "type": "git",

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.OjasKord/tender-mcp",
   "title": "Tender MCP",
   "description": "Government tender search for AI agents. UK, EU and US procurement opportunities.",
-  "version": "1.2.3",
+  "version": "1.2.4",
   "websiteUrl": "https://kordagencies.com",
   "repository": {
     "url": "https://github.com/OjasKord/tender-mcp",
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "tender-mcp",
-      "version": "1.2.3",
+      "version": "1.2.4",
       "transport": { "type": "stdio" },
       "environmentVariables": [
         { "name": "ANTHROPIC_API_KEY", "description": "Anthropic API key for AI-powered tender scoring", "isRequired": true, "isSecret": true }

package/src/server.js

@@ -3,7 +3,9 @@ const https = require('https');
 const crypto = require('crypto');
 const fs = require('fs');
 
-const VERSION = '1.2.3';
+const VERSION = '1.2.5';
+const PRO_UPGRADE_URL = 'https://buy.stripe.com/9B600i5k1bPv2xC6Fqebu0n';
+const ENTERPRISE_UPGRADE_URL = 'https://buy.stripe.com/7sY7sKaEldXDegk0h2ebu0o';
 const PERSIST_FILE = '/tmp/tender_stats.json';
 const RESEND_API_KEY = process.env.RESEND_API_KEY || '';
 const ANTHROPIC_API_KEY = process.env.ANTHROPIC_API_KEY || '';
@@ -296,7 +298,7 @@ async function executeTool(name, args, tier) {
   // ── TOOL 1: search_tenders ──────────────────────────────────────────────────
   if (name === 'search_tenders') {
     const { keyword, company_profile, sources = ['uk', 'eu', 'us'], limit, days_old, min_score } = args;
-    if (!keyword) return { error: 'keyword is required', agent_action: 'PROVIDE_REQUIRED_FIELD', _disclaimer: LEGAL_DISCLAIMER };
+    if (!keyword) return { error: 'keyword is required', agent_action: 'PROVIDE_REQUIRED_FIELD', category: 'invalid_input', retryable: false, retry_after_ms: null, fallback_tool: 'search_tenders', trace_id: Math.random().toString(36).slice(2, 10), _disclaimer: LEGAL_DISCLAIMER };
 
     const fetchLimit = Math.min(limit || 10, 25);
     const daysOld = days_old || 30;
@@ -375,7 +377,7 @@ async function executeTool(name, args, tier) {
       message: 'Pro plan unlocks daily monitoring and award history for these keywords.',
       daily_digest: 'Get all new tenders matching "' + keyword + '" automatically every 24 hours — never miss an opportunity before competitors.',
       award_history: 'See which companies have won similar contracts and at what values — critical for bid pricing strategy.',
-      upgrade_url: 'https://kordagencies.com'
+      upgrade_url: PRO_UPGRADE_URL
     };
 
     return result;
@@ -384,12 +386,12 @@ async function executeTool(name, args, tier) {
   // ── TOOL 2: get_tender_intelligence ────────────────────────────────────────
   if (name === 'get_tender_intelligence') {
     const { mode, keywords, keyword, sources = ['uk', 'eu', 'us'], limit } = args;
-    if (!mode) return { error: 'mode is required: DAILY_DIGEST or AWARD_HISTORY', agent_action: 'PROVIDE_REQUIRED_FIELD', _disclaimer: LEGAL_DISCLAIMER };
+    if (!mode) return { error: 'mode is required: DAILY_DIGEST or AWARD_HISTORY', agent_action: 'PROVIDE_REQUIRED_FIELD', category: 'invalid_input', retryable: false, retry_after_ms: null, fallback_tool: 'get_tender_intelligence', trace_id: Math.random().toString(36).slice(2, 10), _disclaimer: LEGAL_DISCLAIMER };
 
     // ── DAILY_DIGEST ──
     if (mode === 'DAILY_DIGEST') {
       if (!keywords || !Array.isArray(keywords) || keywords.length === 0) {
-        return { error: 'keywords array is required for DAILY_DIGEST mode', agent_action: 'PROVIDE_REQUIRED_FIELD', _disclaimer: LEGAL_DISCLAIMER };
+        return { error: 'keywords array is required for DAILY_DIGEST mode', agent_action: 'PROVIDE_REQUIRED_FIELD', category: 'invalid_input', retryable: false, retry_after_ms: null, fallback_tool: 'get_tender_intelligence', trace_id: Math.random().toString(36).slice(2, 10), _disclaimer: LEGAL_DISCLAIMER };
       }
 
       // Free tier preview: run one keyword, return count only — no full results
@@ -412,7 +414,7 @@ async function executeTool(name, args, tier) {
           keyword_previewed: previewKeyword,
           new_tenders_found_today: previewCount,
           message: previewCount > 0
-            ? previewCount + ' new tenders matching "' + previewKeyword + '" were posted in the last 24 hours. Pro plan required to access them — upgrade at kordagencies.com before competitors do.'
+            ? previewCount + ' new tenders matching "' + previewKeyword + '" were posted in the last 24 hours. Get 500 searches for $8 at ' + PRO_UPGRADE_URL + ' -- calls never expire.'
             : 'No new tenders matching "' + previewKeyword + '" today. Pro plan monitors all your keywords daily and alerts you the moment new opportunities appear.',
           what_you_get_on_pro: [
             'All new tenders matching up to 5 keywords checked daily',
@@ -420,7 +422,7 @@ async function executeTool(name, args, tier) {
             'Results from UK, EU, and US simultaneously',
             '500 searches/month'
           ],
-          upgrade_url: 'https://kordagencies.com',
+          upgrade_url: PRO_UPGRADE_URL,
           checked_at: checkedAt,
           _disclaimer: LEGAL_DISCLAIMER
         };
@@ -456,7 +458,7 @@ async function executeTool(name, args, tier) {
 
     // ── AWARD_HISTORY ──
     if (mode === 'AWARD_HISTORY') {
-      if (!keyword) return { error: 'keyword is required for AWARD_HISTORY mode', agent_action: 'PROVIDE_REQUIRED_FIELD', _disclaimer: LEGAL_DISCLAIMER };
+      if (!keyword) return { error: 'keyword is required for AWARD_HISTORY mode', agent_action: 'PROVIDE_REQUIRED_FIELD', category: 'invalid_input', retryable: false, retry_after_ms: null, fallback_tool: 'get_tender_intelligence', trace_id: Math.random().toString(36).slice(2, 10), _disclaimer: LEGAL_DISCLAIMER };
       const maxResults = Math.min(limit || 10, 25);
 
       // Free tier preview: run search, return winner count + one sample name only
@@ -494,7 +496,7 @@ async function executeTool(name, args, tier) {
             'Frequency analysis — who dominates your target sector',
             'Identify teaming partners or threats before bidding'
           ],
-          upgrade_url: 'https://kordagencies.com',
+          upgrade_url: PRO_UPGRADE_URL,
           checked_at: checkedAt,
           _disclaimer: LEGAL_DISCLAIMER
         };
@@ -524,10 +526,10 @@ async function executeTool(name, args, tier) {
       };
     }
 
-    return { error: 'Invalid mode. Use DAILY_DIGEST or AWARD_HISTORY.', agent_action: 'PROVIDE_REQUIRED_FIELD', _disclaimer: LEGAL_DISCLAIMER };
+    return { error: 'Invalid mode. Use DAILY_DIGEST or AWARD_HISTORY.', agent_action: 'PROVIDE_REQUIRED_FIELD', category: 'invalid_input', retryable: false, retry_after_ms: null, fallback_tool: 'get_tender_intelligence', trace_id: Math.random().toString(36).slice(2, 10), _disclaimer: LEGAL_DISCLAIMER };
   }
 
-  return { error: 'Unknown tool: ' + name, agent_action: 'RETRY_IN_2_MIN' };
+  return { error: 'Unknown tool: ' + name, agent_action: 'RETRY_IN_2_MIN', category: 'unknown_tool', retryable: false, retry_after_ms: null, fallback_tool: null, trace_id: Math.random().toString(36).slice(2, 10) };
 }
 
 // ─── ACCESS CONTROL ───────────────────────────────────────────────────────────
@@ -549,8 +551,8 @@ function checkAccess(req, toolName) {
   if (calls >= FREE_TIER_LIMIT) {
     return {
       allowed: false,
-      reason: 'Free tier limit of ' + FREE_TIER_LIMIT + ' searches/month reached. You have seen it work — upgrade to Pro ($199/month) at kordagencies.com for 500 searches/month.',
-      upgrade_url: 'https://kordagencies.com',
+      reason: 'Free tier limit reached. Get 500 searches for $8 at ' + PRO_UPGRADE_URL + ' -- calls never expire.',
+      upgrade_url: PRO_UPGRADE_URL,
       tier: 'free_limit_reached'
     };
   }
@@ -559,7 +561,7 @@ function checkAccess(req, toolName) {
   const remaining = FREE_TIER_LIMIT - calls - 1;
   return {
     allowed: true, tier: 'free', remaining,
-    warning: remaining <= 2 ? remaining + ' free search' + (remaining === 1 ? '' : 'es') + ' remaining this month. Upgrade at kordagencies.com to avoid interruption.' : null
+    warning: remaining <= 2 ? remaining + ' free search' + (remaining === 1 ? '' : 'es') + ' remaining this month. Get 500 searches for $8 at ' + PRO_UPGRADE_URL + ' -- calls never expire.' : null
   };
 }
 
@@ -614,9 +616,17 @@ const server = http.createServer(async (req, res) => {
     return;
   }
 
+  if (req.url === '/ready' && (req.method === 'GET' || req.method === 'HEAD')) {
+    const checks = { anthropic: !!ANTHROPIC_API_KEY, sam_gov: !!SAM_GOV_API_KEY };
+    const ready = checks.anthropic && checks.sam_gov;
+    res.writeHead(ready ? 200 : 503, { ...cors, 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ status: ready ? 'ready' : 'not_ready', version: VERSION, checks }));
+    return;
+  }
+
   if (req.url === '/.well-known/mcp/server-card.json') {
     res.writeHead(200, { ...cors, 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({ name: 'tender-mcp', version: VERSION, description: 'Government tender search + AI fit scoring. UK, EU, US. Free tier: 10 searches/month.', tools: tools.map(t => ({ name: t.name, description: t.description.slice(0, 100) })), transport: 'stdio', homepage: 'https://kordagencies.com', author: 'ojas1' }));
+    res.end(JSON.stringify({ name: 'tender-mcp', version: VERSION, description: 'Government tender search + AI fit scoring. UK, EU, US. Free tier: 10 searches/month.', tools: tools.map(t => ({ name: t.name, description: t.description.slice(0, 100) })), transport: 'streamable-http', homepage: 'https://kordagencies.com', author: 'ojas1', token_footprint_min: 300, token_footprint_max: 800, token_footprint_avg: 550, idempotent_tools: ['search_tenders', 'get_tender_intelligence'], circuit_breaker: false, health_endpoint: '/health', ready_endpoint: '/ready' }));
     return;
   }
 
@@ -687,7 +697,7 @@ const server = http.createServer(async (req, res) => {
 
           if (!access.allowed) {
             res.writeHead(200, { ...cors, 'Content-Type': 'application/json' });
-            res.end(JSON.stringify({ jsonrpc: '2.0', id: request.id, result: { content: [{ type: 'text', text: JSON.stringify({ error: access.reason, agent_action: access.tier === 'invalid' ? 'PROVIDE_REQUIRED_FIELD' : 'Inform user free tier quota is exhausted. Upgrade available at kordagencies.com', upgrade_url: 'https://kordagencies.com', _disclaimer: LEGAL_DISCLAIMER }) }] } }));
+            res.end(JSON.stringify({ jsonrpc: '2.0', id: request.id, result: { content: [{ type: 'text', text: JSON.stringify({ error: access.reason, agent_action: access.tier === 'invalid' ? 'PROVIDE_REQUIRED_FIELD' : 'Inform user free tier quota is exhausted. Get 500 searches for $8 at ' + PRO_UPGRADE_URL + ' -- calls never expire.', upgrade_url: PRO_UPGRADE_URL, _disclaimer: LEGAL_DISCLAIMER }) }] } }));
             return;
           }
 
@@ -706,15 +716,15 @@ const server = http.createServer(async (req, res) => {
             const hidden = total - shown.length;
             result.tenders = shown;
             if (hidden > 0) {
-              result._free_tier = 'Showing 3 of ' + total + ' results (' + hidden + ' hidden). ' + (access.remaining || 0) + ' free searches remaining this month. Upgrade to Pro ($199/month) at kordagencies.com for full results.';
+              result._free_tier = 'Showing 3 of ' + total + ' results (' + hidden + ' hidden). ' + (access.remaining || 0) + ' free searches remaining this month. Get 500 searches for $8 at ' + PRO_UPGRADE_URL + ' -- calls never expire.';
             }
             // Gate reasons on scoring for free tier
             if (result.scoring && result.scoring.market_insight) {
-              result.scoring.market_insight = '[Upgrade to Pro for market insights — kordagencies.com]';
+              result.scoring.market_insight = '[Get 500 searches for $8 at ' + PRO_UPGRADE_URL + ' for market insights]';
             }
             if (result.tenders) {
               result.tenders = result.tenders.map(t => {
-                if (t.reasons) { const { reasons, ...rest } = t; return { ...rest, _reasons: '[Upgrade to Pro for full scoring reasons — kordagencies.com]' }; }
+                if (t.reasons) { const { reasons, ...rest } = t; return { ...rest, _reasons: '[Get 500 searches for $8 at ' + PRO_UPGRADE_URL + ' for full scoring reasons]' }; }
                 return t;
               });
             }
@@ -737,7 +747,7 @@ const server = http.createServer(async (req, res) => {
 
   if (req.method === 'GET' && req.url === '/') {
     res.writeHead(200, { ...cors, 'Content-Type': 'application/json' });
-    res.end(JSON.stringify({ name: 'tender-mcp', version: VERSION, status: 'ok', tools: 2, free_tier: '10 searches/month, no API key required', description: 'Government tender search + AI fit scoring. UK, EU, US.', upgrade: 'https://kordagencies.com' }));
+    res.end(JSON.stringify({ name: 'tender-mcp', version: VERSION, status: 'ok', tools: 2, free_tier: '10 searches/month, no API key required', description: 'Government tender search + AI fit scoring. UK, EU, US.', upgrade: PRO_UPGRADE_URL }));
     return;
   }