@with-thesis/mcp 0.1.4 → 0.1.6

package/README.md

@@ -46,6 +46,10 @@ Add this to your Cursor MCP config:
 
 ## Included Tools
 
+- `get_sports`
+- `get_teams`
+- `get_team`
+- `get_team_games`
 - `get_games`
 - `get_game`
 - `get_boxscore`

package/dist/index.js

@@ -15348,12 +15348,16 @@ function setHeaders(ctx, headersToSet) {
 }
 
 // src/lib/config.ts
-var MCP_VERSION = "0.1.4";
+var MCP_VERSION = "0.1.5";
 var DEFAULT_API_URL = "https://api.withthesis.dev";
 var DEFAULT_MCP_PORT = 4100;
 var DEFAULT_MCP_RATE_LIMIT_REQUESTS_PER_MIN = 300;
+function trimEnv(value) {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : null;
+}
 function resolveApiBaseUrl() {
-  return process.env.THESIS_API_URL?.trim() || DEFAULT_API_URL;
+  return trimEnv(process.env.THESIS_API_URL) || DEFAULT_API_URL;
 }
 function resolveHttpPort() {
   return Number(process.env.PORT) || Number(process.env.MCP_PORT) || DEFAULT_MCP_PORT;
@@ -23136,7 +23140,7 @@ var SportSchema = _enum(["nba"]).default("nba");
 function registerBookmakerTools(server, api2) {
   server.registerTool("get_bookmakers", {
     title: "Get Bookmakers",
-    description: "List Thesis bookmakers with sharp, opener, and active filters.",
+    description: "List bookmakers with sharp, opener, and active filters.",
     inputSchema: {
       sport: SportSchema.describe("Sport code. Only nba is currently supported."),
       sharp: boolean2().optional().describe("Filter to sharp bookmakers only."),
@@ -23166,7 +23170,7 @@ var SportSchema2 = _enum(["nba"]).default("nba");
 function registerBoxscoreTools(server, api2) {
   server.registerTool("get_boxscore", {
     title: "Get Box Score",
-    description: "Get the full team-level box score for a single Thesis game.",
+    description: "Get the full team-level box score for a single game.",
     inputSchema: {
       sport: SportSchema2.describe("Sport code. Only nba is currently supported."),
       game_id: string2().describe("Game ID such as 20260308_1310_NBA_BOS_CLE.")
@@ -23193,7 +23197,7 @@ var PaginationOffsetSchema = number2().int().min(0).optional();
 function registerGameTools(server, api2) {
   server.registerTool("get_games", {
     title: "Get Games",
-    description: "Get Thesis games by date, date range, team, status, or season.",
+    description: "List games by date, date range, team, status, or season.",
     inputSchema: {
       sport: SportSchema3.describe("Sport code. Only nba is currently supported."),
       date: string2().optional().describe("Game date in YYYY-MM-DD format."),
@@ -23228,7 +23232,7 @@ function registerGameTools(server, api2) {
   });
   server.registerTool("get_game", {
     title: "Get Game",
-    description: "Get a single Thesis game with scores, officials, and partial box score details.",
+    description: "Get a single game with scores, officials, and partial box score details.",
     inputSchema: {
       sport: SportSchema3.describe("Sport code. Only nba is currently supported."),
       game_id: string2().describe("Game ID such as 20260308_1310_NBA_BOS_CLE.")
@@ -23255,10 +23259,10 @@ var PaginationOffsetSchema2 = number2().int().min(0).optional();
 function registerOddsTools(server, api2) {
   server.registerTool("get_odds", {
     title: "Get Odds",
-    description: "Get current Thesis odds snapshots by game, date, bookmaker, sharp books, opener books, or line type.",
+    description: "Get current odds snapshots by game, date, bookmaker, sharp books, opener books, or line type.",
     inputSchema: {
       sport: SportSchema4.describe("Sport code. Only nba is currently supported."),
-      game_id: string2().optional().describe("Filter to a specific Thesis game ID."),
+      game_id: string2().optional().describe("Filter to a specific game ID."),
       date: string2().optional().describe("Game date in YYYY-MM-DD format."),
       bookmaker: string2().optional().describe("Comma-separated bookmaker codes such as circa,dk."),
       sharp: boolean2().optional().describe("Filter to sharp bookmakers only."),
@@ -23290,7 +23294,7 @@ function registerOddsTools(server, api2) {
   });
   server.registerTool("get_line_movement", {
     title: "Get Line Movement",
-    description: "Get Thesis odds history and line movement for a single game.",
+    description: "Get odds history and line movement for a single game.",
     inputSchema: {
       sport: SportSchema4.describe("Sport code. Only nba is currently supported."),
       game_id: string2().describe("Game ID such as 20260308_1310_NBA_BOS_CLE."),
@@ -23314,6 +23318,136 @@ function registerOddsTools(server, api2) {
   });
 }
 
+// src/tools/sports.ts
+function registerSportTools(server, api2) {
+  server.registerTool("get_sports", {
+    title: "Get Sports",
+    description: "List supported sports, API-key access, and canonical endpoint templates.",
+    inputSchema: {},
+    annotations: {
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  }, async () => {
+    try {
+      const payload = await api2.get("/v1/sports");
+      return successToolResult(payload);
+    } catch (error2) {
+      return errorToolResult(error2);
+    }
+  });
+}
+
+// src/tools/teams.ts
+var SportSchema5 = _enum(["nba"]).default("nba");
+var GameStatusSchema2 = _enum(["scheduled", "live", "final"]);
+var PaginationLimitSchema3 = number2().int().min(1).max(100).optional();
+var PaginationOffsetSchema3 = number2().int().min(0).optional();
+function registerTeamTools(server, api2) {
+  server.registerTool("get_teams", {
+    title: "Get Teams",
+    description: "List teams for a sport with optional active, conference, and search filters.",
+    inputSchema: {
+      sport: SportSchema5.describe("Sport code. Only nba is currently supported."),
+      active: boolean2().optional().describe("Filter to active teams only when true, inactive only when false."),
+      conference: string2().optional().describe("Optional conference filter such as Eastern or Western."),
+      search: string2().optional().describe("Case-insensitive search across team code, city, and name."),
+      include_assets: boolean2().optional().describe("Include team asset metadata such as logos when true."),
+      limit: PaginationLimitSchema3.describe("Number of teams to return. Max 100."),
+      offset: PaginationOffsetSchema3.describe("Pagination offset.")
+    },
+    annotations: {
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  }, async ({ sport, active, conference, search, include_assets, limit, offset }) => {
+    try {
+      const payload = await api2.get(`/v1/${sport}/teams`, {
+        active,
+        conference,
+        search,
+        include: include_assets ? "assets" : undefined,
+        limit,
+        offset
+      });
+      return successToolResult(payload);
+    } catch (error2) {
+      return errorToolResult(error2);
+    }
+  });
+  server.registerTool("get_team", {
+    title: "Get Team",
+    description: "Get a single team by its canonical team code such as BOS or LAL.",
+    inputSchema: {
+      sport: SportSchema5.describe("Sport code. Only nba is currently supported."),
+      team_code: string2().describe("Canonical team code such as BOS, LAL, or CLE."),
+      include_assets: boolean2().optional().describe("Include team asset metadata such as logos when true.")
+    },
+    annotations: {
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  }, async ({ sport, team_code, include_assets }) => {
+    try {
+      const normalizedCode = team_code.trim().toUpperCase();
+      const payload = await api2.get(`/v1/${sport}/teams/${normalizedCode}`, {
+        include: include_assets ? "assets" : undefined
+      });
+      return successToolResult(payload);
+    } catch (error2) {
+      return errorToolResult(error2);
+    }
+  });
+  server.registerTool("get_team_games", {
+    title: "Get Team Games",
+    description: "Get a normalized team-centric game log with requested-team scores, opponents, results, and optional box score data.",
+    inputSchema: {
+      sport: SportSchema5.describe("Sport code. Only nba is currently supported."),
+      team_code: string2().describe("Canonical team code such as BOS, LAL, or CLE."),
+      date: string2().optional().describe("Exact game date in YYYY-MM-DD format."),
+      date_from: string2().optional().describe("Start date in YYYY-MM-DD format."),
+      date_to: string2().optional().describe("End date in YYYY-MM-DD format."),
+      status: GameStatusSchema2.optional().describe("scheduled, live, or final"),
+      season: string2().optional().describe("Season string such as 2025-26."),
+      include_boxscore: boolean2().optional().describe("Include the requested team box score row for each game when true."),
+      limit: PaginationLimitSchema3.describe("Number of games to return. Max 100."),
+      offset: PaginationOffsetSchema3.describe("Pagination offset.")
+    },
+    annotations: {
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  }, async ({
+    sport,
+    team_code,
+    date: date5,
+    date_from,
+    date_to,
+    status,
+    season,
+    include_boxscore,
+    limit,
+    offset
+  }) => {
+    try {
+      const normalizedCode = team_code.trim().toUpperCase();
+      const payload = await api2.get(`/v1/${sport}/teams/${normalizedCode}/games`, {
+        date: date5,
+        date_from,
+        date_to,
+        status,
+        season,
+        include: include_boxscore ? "boxscore" : undefined,
+        limit,
+        offset
+      });
+      return successToolResult(payload);
+    } catch (error2) {
+      return errorToolResult(error2);
+    }
+  });
+}
+
 // src/server.ts
 function createThesisMcpServer(options) {
   const server = new McpServer({
@@ -23331,6 +23465,8 @@ function createThesisMcpServer(options) {
   registerBoxscoreTools(server, api2);
   registerOddsTools(server, api2);
   registerBookmakerTools(server, api2);
+  registerSportTools(server, api2);
+  registerTeamTools(server, api2);
   return server;
 }
 

package/dist/stdio.js

@@ -12459,10 +12459,30 @@ function requireStdioApiKey() {
 }
 
 // src/lib/config.ts
-var MCP_VERSION = "0.1.4";
+var MCP_VERSION = "0.1.5";
 var DEFAULT_API_URL = "https://api.withthesis.dev";
-function resolveApiBaseUrl() {
-  return process.env.THESIS_API_URL?.trim() || DEFAULT_API_URL;
+function trimEnv(value) {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : null;
+}
+function isLocalhostUrl(value) {
+  try {
+    const url = new URL(value);
+    return url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "::1";
+  } catch {
+    return false;
+  }
+}
+function resolveStdioApiBaseUrl() {
+  const explicitMcpUrl = trimEnv(process.env.THESIS_MCP_API_URL);
+  if (explicitMcpUrl) {
+    return explicitMcpUrl;
+  }
+  const inheritedApiUrl = trimEnv(process.env.THESIS_API_URL);
+  if (inheritedApiUrl && isLocalhostUrl(inheritedApiUrl)) {
+    return inheritedApiUrl;
+  }
+  return DEFAULT_API_URL;
 }
 
 // ../../node_modules/.bun/zod@4.3.6/node_modules/zod/v3/helpers/util.js
@@ -20038,7 +20058,7 @@ var SportSchema = _enum(["nba"]).default("nba");
 function registerBookmakerTools(server, api2) {
   server.registerTool("get_bookmakers", {
     title: "Get Bookmakers",
-    description: "List Thesis bookmakers with sharp, opener, and active filters.",
+    description: "List bookmakers with sharp, opener, and active filters.",
     inputSchema: {
       sport: SportSchema.describe("Sport code. Only nba is currently supported."),
       sharp: boolean2().optional().describe("Filter to sharp bookmakers only."),
@@ -20068,7 +20088,7 @@ var SportSchema2 = _enum(["nba"]).default("nba");
 function registerBoxscoreTools(server, api2) {
   server.registerTool("get_boxscore", {
     title: "Get Box Score",
-    description: "Get the full team-level box score for a single Thesis game.",
+    description: "Get the full team-level box score for a single game.",
     inputSchema: {
       sport: SportSchema2.describe("Sport code. Only nba is currently supported."),
       game_id: string2().describe("Game ID such as 20260308_1310_NBA_BOS_CLE.")
@@ -20095,7 +20115,7 @@ var PaginationOffsetSchema = number2().int().min(0).optional();
 function registerGameTools(server, api2) {
   server.registerTool("get_games", {
     title: "Get Games",
-    description: "Get Thesis games by date, date range, team, status, or season.",
+    description: "List games by date, date range, team, status, or season.",
     inputSchema: {
       sport: SportSchema3.describe("Sport code. Only nba is currently supported."),
       date: string2().optional().describe("Game date in YYYY-MM-DD format."),
@@ -20130,7 +20150,7 @@ function registerGameTools(server, api2) {
   });
   server.registerTool("get_game", {
     title: "Get Game",
-    description: "Get a single Thesis game with scores, officials, and partial box score details.",
+    description: "Get a single game with scores, officials, and partial box score details.",
     inputSchema: {
       sport: SportSchema3.describe("Sport code. Only nba is currently supported."),
       game_id: string2().describe("Game ID such as 20260308_1310_NBA_BOS_CLE.")
@@ -20157,10 +20177,10 @@ var PaginationOffsetSchema2 = number2().int().min(0).optional();
 function registerOddsTools(server, api2) {
   server.registerTool("get_odds", {
     title: "Get Odds",
-    description: "Get current Thesis odds snapshots by game, date, bookmaker, sharp books, opener books, or line type.",
+    description: "Get current odds snapshots by game, date, bookmaker, sharp books, opener books, or line type.",
     inputSchema: {
       sport: SportSchema4.describe("Sport code. Only nba is currently supported."),
-      game_id: string2().optional().describe("Filter to a specific Thesis game ID."),
+      game_id: string2().optional().describe("Filter to a specific game ID."),
       date: string2().optional().describe("Game date in YYYY-MM-DD format."),
       bookmaker: string2().optional().describe("Comma-separated bookmaker codes such as circa,dk."),
       sharp: boolean2().optional().describe("Filter to sharp bookmakers only."),
@@ -20192,7 +20212,7 @@ function registerOddsTools(server, api2) {
   });
   server.registerTool("get_line_movement", {
     title: "Get Line Movement",
-    description: "Get Thesis odds history and line movement for a single game.",
+    description: "Get odds history and line movement for a single game.",
     inputSchema: {
       sport: SportSchema4.describe("Sport code. Only nba is currently supported."),
       game_id: string2().describe("Game ID such as 20260308_1310_NBA_BOS_CLE."),
@@ -20216,6 +20236,136 @@ function registerOddsTools(server, api2) {
   });
 }
 
+// src/tools/sports.ts
+function registerSportTools(server, api2) {
+  server.registerTool("get_sports", {
+    title: "Get Sports",
+    description: "List supported sports, API-key access, and canonical endpoint templates.",
+    inputSchema: {},
+    annotations: {
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  }, async () => {
+    try {
+      const payload = await api2.get("/v1/sports");
+      return successToolResult(payload);
+    } catch (error2) {
+      return errorToolResult(error2);
+    }
+  });
+}
+
+// src/tools/teams.ts
+var SportSchema5 = _enum(["nba"]).default("nba");
+var GameStatusSchema2 = _enum(["scheduled", "live", "final"]);
+var PaginationLimitSchema3 = number2().int().min(1).max(100).optional();
+var PaginationOffsetSchema3 = number2().int().min(0).optional();
+function registerTeamTools(server, api2) {
+  server.registerTool("get_teams", {
+    title: "Get Teams",
+    description: "List teams for a sport with optional active, conference, and search filters.",
+    inputSchema: {
+      sport: SportSchema5.describe("Sport code. Only nba is currently supported."),
+      active: boolean2().optional().describe("Filter to active teams only when true, inactive only when false."),
+      conference: string2().optional().describe("Optional conference filter such as Eastern or Western."),
+      search: string2().optional().describe("Case-insensitive search across team code, city, and name."),
+      include_assets: boolean2().optional().describe("Include team asset metadata such as logos when true."),
+      limit: PaginationLimitSchema3.describe("Number of teams to return. Max 100."),
+      offset: PaginationOffsetSchema3.describe("Pagination offset.")
+    },
+    annotations: {
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  }, async ({ sport, active, conference, search, include_assets, limit, offset }) => {
+    try {
+      const payload = await api2.get(`/v1/${sport}/teams`, {
+        active,
+        conference,
+        search,
+        include: include_assets ? "assets" : undefined,
+        limit,
+        offset
+      });
+      return successToolResult(payload);
+    } catch (error2) {
+      return errorToolResult(error2);
+    }
+  });
+  server.registerTool("get_team", {
+    title: "Get Team",
+    description: "Get a single team by its canonical team code such as BOS or LAL.",
+    inputSchema: {
+      sport: SportSchema5.describe("Sport code. Only nba is currently supported."),
+      team_code: string2().describe("Canonical team code such as BOS, LAL, or CLE."),
+      include_assets: boolean2().optional().describe("Include team asset metadata such as logos when true.")
+    },
+    annotations: {
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  }, async ({ sport, team_code, include_assets }) => {
+    try {
+      const normalizedCode = team_code.trim().toUpperCase();
+      const payload = await api2.get(`/v1/${sport}/teams/${normalizedCode}`, {
+        include: include_assets ? "assets" : undefined
+      });
+      return successToolResult(payload);
+    } catch (error2) {
+      return errorToolResult(error2);
+    }
+  });
+  server.registerTool("get_team_games", {
+    title: "Get Team Games",
+    description: "Get a normalized team-centric game log with requested-team scores, opponents, results, and optional box score data.",
+    inputSchema: {
+      sport: SportSchema5.describe("Sport code. Only nba is currently supported."),
+      team_code: string2().describe("Canonical team code such as BOS, LAL, or CLE."),
+      date: string2().optional().describe("Exact game date in YYYY-MM-DD format."),
+      date_from: string2().optional().describe("Start date in YYYY-MM-DD format."),
+      date_to: string2().optional().describe("End date in YYYY-MM-DD format."),
+      status: GameStatusSchema2.optional().describe("scheduled, live, or final"),
+      season: string2().optional().describe("Season string such as 2025-26."),
+      include_boxscore: boolean2().optional().describe("Include the requested team box score row for each game when true."),
+      limit: PaginationLimitSchema3.describe("Number of games to return. Max 100."),
+      offset: PaginationOffsetSchema3.describe("Pagination offset.")
+    },
+    annotations: {
+      readOnlyHint: true,
+      openWorldHint: true
+    }
+  }, async ({
+    sport,
+    team_code,
+    date: date4,
+    date_from,
+    date_to,
+    status,
+    season,
+    include_boxscore,
+    limit,
+    offset
+  }) => {
+    try {
+      const normalizedCode = team_code.trim().toUpperCase();
+      const payload = await api2.get(`/v1/${sport}/teams/${normalizedCode}/games`, {
+        date: date4,
+        date_from,
+        date_to,
+        status,
+        season,
+        include: include_boxscore ? "boxscore" : undefined,
+        limit,
+        offset
+      });
+      return successToolResult(payload);
+    } catch (error2) {
+      return errorToolResult(error2);
+    }
+  });
+}
+
 // src/server.ts
 function createThesisMcpServer(options) {
   const server = new McpServer({
@@ -20233,6 +20383,8 @@ function createThesisMcpServer(options) {
   registerBoxscoreTools(server, api2);
   registerOddsTools(server, api2);
   registerBookmakerTools(server, api2);
+  registerSportTools(server, api2);
+  registerTeamTools(server, api2);
   return server;
 }
 
@@ -20240,7 +20392,7 @@ function createThesisMcpServer(options) {
 async function startStdioServer() {
   const apiKey = requireStdioApiKey();
   const server = createThesisMcpServer({
-    apiBaseUrl: resolveApiBaseUrl(),
+    apiBaseUrl: resolveStdioApiBaseUrl(),
     apiKey,
     clientName: "local-stdio"
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@with-thesis/mcp",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "description": "thesis MCP server for API-key-based AI client access.",
   "homepage": "https://withthesis.dev",