livetennisapi-mcp 1.0.0 → 1.0.2

package/CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+All notable changes are documented here.
+This project adheres to [Semantic Versioning](https://semver.org/).
+
+## [1.0.2] — 2026-07-19
+
+### Added
+- Listed in the [official MCP Registry](https://registry.modelcontextprotocol.io)
+  as `io.github.livetennisapi/livetennisapi-mcp`, so MCP clients can discover the
+  server programmatically. Adds `server.json` and the `mcpName` ownership marker,
+  published from CI via GitHub OIDC.
+
+### Fixed
+- `check_api_status` reported a PRO or ULTRA key as BASIC whenever the events
+  probe hit a match with no recorded events: `NotFound` was treated as "not
+  entitled" when it actually proves the call was allowed. Only `UpgradeRequired`
+  now stops the tier ladder.
+- Guarded against a non-JSON response body decoding to `undefined` and being
+  dereferenced in `get_match`, `get_match_score`, `get_match_odds`,
+  `get_match_analysis` and `get_player`.
+
+### Changed
+- `CHANGELOG.md` is now included in the published tarball.
+
+## [1.0.1] — 2026-07-19
+
+### Changed
+- Published from CI via npm Trusted Publishing (OIDC), so this release carries a
+  signed provenance attestation. 1.0.0 did not: npm requires a package to exist
+  before OIDC can be configured, so it had to be published manually.
+
+### Added
+- `test/protocol.mjs` — drives the built server over stdio and asserts the
+  handshake, all 12 tools, and that the missing-key path degrades to a helpful
+  message rather than an error.
+- Release workflow, security policy, contributing guide, issue templates.
+
+## [1.0.0] — 2026-07-19
+
+First release.
+
+### Added
+- 12 read-only MCP tools over the Live Tennis API: live and upcoming matches,
+  match detail and score, player search and profile, fixtures, recent results,
+  match events, odds, model analysis, and an API status check.
+- Tier-aware responses: a `403 upgrade_required` becomes a plain-English
+  explanation naming the required plan, returned as a normal result rather than
+  an error.
+- `check_api_status` probes upward to report which plan the configured key is on.
+
+### Notes
+- Published without a provenance attestation. npm requires a package to exist
+  before OIDC trusted publishing can be configured, so 1.0.0 had to be published
+  manually. Later releases are published from CI with provenance.

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   formatScore
 } from "livetennisapi";
 import { z } from "zod";
-var VERSION = "1.0.0";
+var VERSION = "1.0.2";
 var apiKey = (process.env.LIVETENNISAPI_KEY ?? "").trim();
 var client = new LiveTennisAPI({
   apiKey,
@@ -99,6 +99,7 @@ server.tool(
   { match_id: z.number().int().describe("Match id, from get_live_matches or search") },
   ({ match_id }) => guard(async () => {
     const match = await client.getMatch(match_id);
+    if (!match) return "No data returned for that match id.";
     let out = summarise(match);
     if (match.market) {
       out += `
@@ -130,6 +131,7 @@ server.tool(
   { match_id: z.number().int() },
   ({ match_id }) => guard(async () => {
     const score = await client.getMatchScore(match_id);
+    if (!score) return "No score available for that match yet.";
     const parts = [`Score: ${formatScore(score)}`];
     if (score.sets) parts.push(`Sets: ${score.sets.join("-")}`);
     if (score.server) parts.push(`Serving: player ${score.server}`);
@@ -161,6 +163,7 @@ server.tool(
   { player_id: z.number().int().describe("Player id, from search_players") },
   ({ player_id }) => guard(async () => {
     const p = await client.getPlayer(player_id);
+    if (!p) return "No data returned for that player id.";
     const rows = [
       `${p.name ?? "Unknown"} [${p.id}]`,
       p.country ? `Country: ${p.country}` : null,
@@ -211,6 +214,7 @@ server.tool(
   { match_id: z.number().int(), limit: z.number().int().min(1).max(200).default(10) },
   ({ match_id, limit }) => guard(async () => {
     const market = await client.getMarketPrices(match_id, { limit });
+    if (!market) return "No market data for that match.";
     const lines = [`Market: ${market.question ?? "-"}`];
     if (market.status) lines.push(`Status: ${market.status}`);
     if (market.volume != null) lines.push(`24h volume: ${market.volume}`);
@@ -230,7 +234,7 @@ server.tool(
   { match_id: z.number().int() },
   ({ match_id }) => guard(async () => {
     const analysis = await client.getMatchAnalysis(match_id);
-    if (!analysis.thesis && !analysis.profile) return "No model analysis exists for this match yet.";
+    if (!analysis || !analysis.thesis && !analysis.profile) return "No model analysis exists for this match yet.";
     const lines = [];
     if (analysis.profile) {
       const p = analysis.profile;
@@ -281,11 +285,18 @@ No API key is configured, so only this check will work. Set LIVETENNISAPI_KEY in
         try {
           await client.listMatchEvents(id, { limit: 1 });
           tier = "PRO";
-          await client.getMatchAnalysis(id);
-          tier = "ULTRA";
         } catch (err) {
-          if (!(err instanceof UpgradeRequired) && !(err instanceof NotFound)) throw err;
-          if (err instanceof NotFound && tier === "PRO") tier = "ULTRA";
+          if (err instanceof NotFound) tier = "PRO";
+          else if (!(err instanceof UpgradeRequired)) throw err;
+        }
+        if (tier === "PRO") {
+          try {
+            await client.getMatchAnalysis(id);
+            tier = "ULTRA";
+          } catch (err) {
+            if (err instanceof NotFound) tier = "ULTRA";
+            else if (!(err instanceof UpgradeRequired)) throw err;
+          }
         }
       }
       return text(

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "livetennisapi-mcp",
-  "version": "1.0.0",
+  "mcpName": "io.github.livetennisapi/livetennisapi-mcp",
+  "version": "1.0.2",
   "description": "MCP server for the Live Tennis API \u2014 give Claude, Cursor and other LLM agents real-time tennis scores, players, odds and model win-probability.",
   "keywords": [
     "mcp",
@@ -36,7 +37,8 @@
   "files": [
     "dist",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "CHANGELOG.md"
   ],
   "engines": {
     "node": ">=18"