tender-mcp 1.2.1 → 1.2.2

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [1.2.2] - 2026-04-26
+### Changed
+- VERSION constant introduced as single source of truth (was behind package.json)
+- Added `agent_action` to all error responses (PROVIDE_REQUIRED_FIELD, RETRY_IN_2_MIN)
+- Added stdio transport for Claude Desktop / npm usage
+- Fixed em-dash in analysis_type and AI scoring error strings (ASCII --)
+
 ## [1.2.0] - 2026-04-21
 ### Changed
 - Consolidated from 5 tools to 2: search_tenders and get_tender_intelligence

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tender-mcp",
   "mcpName": "io.github.OjasKord/tender-mcp",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "Government tender search and AI opportunity scoring for AI agents. UK Contracts Finder, EU TED, US SAM.gov.",
   "main": "src/server.js",
   "scripts": {

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.1",
+  "version": "1.2.2",
   "websiteUrl": "https://kordagencies.com",
   "repository": {
     "url": "https://github.com/OjasKord/tender-mcp",
@@ -13,7 +13,7 @@
     {
       "registryType": "npm",
       "identifier": "tender-mcp",
-      "version": "1.2.1",
+      "version": "1.2.2",
       "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,7 @@ const https = require('https');
 const crypto = require('crypto');
 const fs = require('fs');
 
-const VERSION = '1.2.0';
+const VERSION = '1.2.2';
 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 || '';
@@ -257,7 +257,7 @@ function normaliseSAMTender(o) {
 const tools = [
   {
     name: 'search_tenders',
-    description: 'Call this tool any time your agent needs to find and evaluate government contract opportunities. Use when helping a company identify new revenue from public sector clients, when an agent needs to find bid opportunities, or when researching government procurement in a specific sector. Searches UK Contracts Finder, EU TED, and US SAM.gov simultaneously. Returns normalised results with AI fit scoring already applied — each tender includes a score 0-100, BID/INVESTIGATE/SKIP recommendation, and specific reasons. One call returns everything the agent needs to act. AI-powered analysis — NOT a simple keyword search. Data sourced directly from official government portals. LEGAL NOTICE: Always verify deadlines with the contracting authority before bidding. We do not log your query content. Full terms: kordagencies.com/terms.html. Free tier: first 10 searches/month, no API key needed.',
+    description: 'Call this tool when your agent needs to find and evaluate government contract opportunities for a company. Use when identifying new public sector revenue, researching procurement in a specific sector, or qualifying bid opportunities before committing resources. Searches UK Contracts Finder, EU TED, and US SAM.gov simultaneously. Returns normalised results with AI fit scoring already applied -- each tender includes a score 0-100, BID / INVESTIGATE / SKIP recommendation, and specific reasons so your agent can act immediately without further analysis. One call, three markets, machine-ready verdicts. AI-powered -- NOT a simple keyword search. Data sourced directly from official government portals. LEGAL NOTICE: Always verify deadlines with the contracting authority before bidding. We do not log your query content. Full terms: kordagencies.com/terms.html. Free tier: first 10 searches/month, no API key needed.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -273,7 +273,7 @@ const tools = [
   },
   {
     name: 'get_tender_intelligence',
-    description: 'Call this tool for ongoing procurement intelligence beyond one-off search. Two modes: DAILY_DIGEST returns all new tenders posted in the last 24 hours matching your keywords — use as a daily monitoring tool so no new opportunity is missed before competitors see it. AWARD_HISTORY returns past contract winners for a keyword — use for competitive intelligence before bidding, to find teaming partners, or to understand which companies dominate a sector. Both modes search UK, EU, and US simultaneously. AI-powered analysis — NOT a simple database lookup. LEGAL NOTICE: Award data may be incomplete as not all authorities publish award notices. We do not log your query content. Full terms: kordagencies.com/terms.html. Paid API key required — upgrade at kordagencies.com.',
+    description: 'Call this tool when your agent needs continuous procurement intelligence rather than a one-off search. DAILY_DIGEST mode: returns all new tenders posted in the last 24 hours matching your keywords -- use this on a daily schedule so your agent never misses an opportunity before competitors see it. AWARD_HISTORY mode: returns past contract winners for a keyword -- use before bidding to understand who dominates a sector, find teaming partners, or set realistic win probability. A company that bids without award history is bidding blind. Both modes search UK, EU, and US simultaneously. AI-powered -- NOT a simple database lookup. LEGAL NOTICE: Award data may be incomplete as not all authorities publish award notices. We do not log your query content. Full terms: kordagencies.com/terms.html. Paid API key required -- upgrade at kordagencies.com.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -296,7 +296,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', _disclaimer: LEGAL_DISCLAIMER };
+    if (!keyword) return { error: 'keyword is required', agent_action: 'PROVIDE_REQUIRED_FIELD', _disclaimer: LEGAL_DISCLAIMER };
 
     const fetchLimit = Math.min(limit || 10, 25);
     const daysOld = days_old || 30;
@@ -352,10 +352,10 @@ async function executeTool(name, args, tier) {
           threshold_used: threshold,
           top_opportunities: aiResult.top_opportunities || [],
           market_insight: aiResult.market_insight || null,
-          analysis_type: 'AI-powered fit scoring — NOT a simple keyword match'
+          analysis_type: 'AI-powered fit scoring -- NOT a simple keyword match'
         };
       } catch(e) {
-        scoringMeta = { error: 'AI scoring unavailable — results returned unscored. Manual review recommended.' };
+        scoringMeta = { error: 'AI scoring unavailable -- results returned unscored. Manual review recommended.', agent_action: 'RETRY_IN_2_MIN' };
       }
     }
 
@@ -384,12 +384,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', _disclaimer: LEGAL_DISCLAIMER };
+    if (!mode) return { error: 'mode is required: DAILY_DIGEST or AWARD_HISTORY', agent_action: 'PROVIDE_REQUIRED_FIELD', _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', _disclaimer: LEGAL_DISCLAIMER };
+        return { error: 'keywords array is required for DAILY_DIGEST mode', agent_action: 'PROVIDE_REQUIRED_FIELD', _disclaimer: LEGAL_DISCLAIMER };
       }
 
       // Free tier preview: run one keyword, return count only — no full results
@@ -456,7 +456,7 @@ async function executeTool(name, args, tier) {
 
     // ── AWARD_HISTORY ──
     if (mode === 'AWARD_HISTORY') {
-      if (!keyword) return { error: 'keyword is required for AWARD_HISTORY mode', _disclaimer: LEGAL_DISCLAIMER };
+      if (!keyword) return { error: 'keyword is required for AWARD_HISTORY mode', agent_action: 'PROVIDE_REQUIRED_FIELD', _disclaimer: LEGAL_DISCLAIMER };
       const maxResults = Math.min(limit || 10, 25);
 
       // Free tier preview: run search, return winner count + one sample name only
@@ -524,10 +524,10 @@ async function executeTool(name, args, tier) {
       };
     }
 
-    return { error: 'Invalid mode. Use DAILY_DIGEST or AWARD_HISTORY.', _disclaimer: LEGAL_DISCLAIMER };
+    return { error: 'Invalid mode. Use DAILY_DIGEST or AWARD_HISTORY.', agent_action: 'PROVIDE_REQUIRED_FIELD', _disclaimer: LEGAL_DISCLAIMER };
   }
 
-  return { error: 'Unknown tool: ' + name };
+  return { error: 'Unknown tool: ' + name, agent_action: 'RETRY_IN_2_MIN' };
 }
 
 // ─── ACCESS CONTROL ───────────────────────────────────────────────────────────
@@ -687,7 +687,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, 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. Upgrade available at kordagencies.com', upgrade_url: 'https://kordagencies.com', _disclaimer: LEGAL_DISCLAIMER }) }] } }));
             return;
           }
 
@@ -744,6 +744,49 @@ const server = http.createServer(async (req, res) => {
   res.writeHead(404, cors); res.end(JSON.stringify({ error: 'Not found' }));
 });
 
+function setupStdio() {
+  if (process.stdin.isTTY) return;
+  let buf = '';
+  process.stdin.setEncoding('utf8');
+  process.stdin.on('data', chunk => {
+    buf += chunk;
+    let nl;
+    while ((nl = buf.indexOf('\n')) !== -1) {
+      const line = buf.slice(0, nl).trim();
+      buf = buf.slice(nl + 1);
+      if (!line) continue;
+      let req;
+      try { req = JSON.parse(line); } catch(e) { process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } }) + '\n'); continue; }
+      let resp;
+      if (req.method === 'initialize') {
+        resp = { jsonrpc: '2.0', id: req.id, result: { protocolVersion: '2024-11-05', capabilities: { tools: {}, resources: {}, prompts: {} }, serverInfo: { name: 'tender-mcp', version: VERSION, description: 'Government tender search and AI fit scoring. UK, EU, US. 2 tools. Free tier: 10 searches/month.' } } };
+      } else if (req.method === 'notifications/initialized') {
+        continue;
+      } else if (req.method === 'tools/list') {
+        resp = { jsonrpc: '2.0', id: req.id, result: { tools } };
+      } else if (req.method === 'resources/list') {
+        resp = { jsonrpc: '2.0', id: req.id, result: { resources: [] } };
+      } else if (req.method === 'prompts/list') {
+        resp = { jsonrpc: '2.0', id: req.id, result: { prompts: [] } };
+      } else if (req.method === 'tools/call') {
+        const { name, arguments: toolArgs } = req.params || {};
+        executeTool(name, toolArgs || {}, 'pro').then(result => {
+          process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id: req.id, result: { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] } }) + '\n');
+        }).catch(err => {
+          process.stdout.write(JSON.stringify({ jsonrpc: '2.0', id: req.id, error: { code: -32603, message: err.message } }) + '\n');
+        });
+        continue;
+      } else {
+        resp = { jsonrpc: '2.0', id: req.id, error: { code: -32601, message: 'Method not found: ' + req.method } };
+      }
+      process.stdout.write(JSON.stringify(resp) + '\n');
+    }
+  });
+  process.stdin.resume();
+}
+
+setupStdio();
+
 server.listen(PORT, () => {
   loadStats();
   console.log('Tender MCP v' + VERSION + ' running on port ' + PORT);