@with-thesis/mcp 0.1.0 → 0.1.1

package/README.md

@@ -1,16 +1,27 @@
 # @with-thesis/mcp
 
-API-key-based MCP server for thesis sports data.
+Connect thesis sports data to Claude Desktop, Cursor, and other MCP clients with your thesis API key.
 
-## Install
+## What You Need
 
-Run it locally over stdio with an API key:
+- A thesis API key
+- `npx` available on your machine
+
+Get an API key at [withthesis.dev](https://withthesis.dev).
+
+## Quick Start
+
+Run the MCP server locally over stdio:
 
 ```sh
 THESIS_API_KEY=th_live_xxx npx -y @with-thesis/mcp
 ```
 
-Claude Desktop example:
+The package talks directly to the thesis API at `https://api.withthesis.dev` using your API key.
+
+## Claude Desktop
+
+Add this to your Claude Desktop MCP config:
 
 ```json
 {
@@ -26,7 +37,9 @@ Claude Desktop example:
 }
 ```
 
-Cursor example:
+## Cursor
+
+Add this to your Cursor MCP config:
 
 ```json
 {
@@ -42,23 +55,51 @@ Cursor example:
 }
 ```
 
-The MCP layer stays thin and forwards requests to the thesis API using the caller's API key.
+## Included Tools
+
+- `get_games`
+- `get_game`
+- `get_boxscore`
+- `get_odds`
+- `get_line_movement`
+- `get_bookmakers`
+
+## Environment Variables
+
+- `THESIS_API_KEY`: required
+- `THESIS_API_URL`: optional, defaults to `https://api.withthesis.dev`
+
+## Troubleshooting
+
+If the client cannot start the server:
+
+- make sure `npx` is installed and available
+- make sure `THESIS_API_KEY` is set
+- make sure your API key is the raw key from thesis, not the hashed value in the database
 
-## Hosted HTTP model
+If the client connects but tool calls fail:
 
-Customers connect to a hosted endpoint such as:
+- verify the API key still works against thesis directly
+- check whether your key is free or pro if you expect higher limits
+- if you use a custom `THESIS_API_URL`, make sure it points at a working thesis API instance
+
+## Advanced
+
+The published package is for local stdio MCP clients.
+
+If you want a hosted HTTP MCP endpoint, the thesis server can also be deployed separately and expose an endpoint such as:
 
 ```txt
 https://mcp.withthesis.dev/mcp
 ```
 
-Auth is bearer-token based today:
+HTTP auth is bearer-token based:
 
 - `Authorization: Bearer th_live_xxx`
 - `X-Thesis-API-Key: th_live_xxx`
 - `X-API-Key: th_live_xxx`
 
-## Local development
+## Development
 
 From the repo root:
 
@@ -91,13 +132,4 @@ Environment variables:
 - `PORT` or `MCP_PORT`: optional, defaults to `4100`
 - `MCP_RATE_LIMIT_REQUESTS_PER_MIN`: optional coarse per-instance front-door rate limit, defaults to `300`
 
-The hosted MCP service forwards requests to the main Thesis API. The MCP rate limiter is only a coarse front-door guard and does not replace the API's real auth, quota, or billing enforcement.
-
-## Implemented tools
-
-- `get_games`
-- `get_game`
-- `get_boxscore`
-- `get_odds`
-- `get_line_movement`
-- `get_bookmakers`
+The hosted MCP service forwards requests to the main thesis API. The MCP rate limiter is only a coarse front-door guard and does not replace the API's real auth, quota, or billing enforcement.

package/package.json

@@ -1,14 +1,9 @@
 {
   "name": "@with-thesis/mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "thesis MCP server for API-key-based AI client access.",
   "homepage": "https://withthesis.dev",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/tensorix-labs/thesis.git",
-    "directory": "packages/mcp"
-  },
   "publishConfig": {
     "access": "public"
   },