@with-thesis/mcp 0.1.1 → 0.1.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +1 -82
  2. package/dist/index.js +21318 -27
  3. package/dist/stdio.js +21320 -27
  4. package/package.json +2 -1
package/README.md CHANGED
@@ -2,23 +2,12 @@
2
2
 
3
3
  Connect thesis sports data to Claude Desktop, Cursor, and other MCP clients with your thesis API key.
4
4
 
5
- ## What You Need
6
-
7
- - A thesis API key
8
- - `npx` available on your machine
9
-
10
- Get an API key at [withthesis.dev](https://withthesis.dev).
11
-
12
- ## Quick Start
13
-
14
- Run the MCP server locally over stdio:
5
+ Get an API key at [withthesis.dev](https://withthesis.dev), then run:
15
6
 
16
7
  ```sh
17
8
  THESIS_API_KEY=th_live_xxx npx -y @with-thesis/mcp
18
9
  ```
19
10
 
20
- The package talks directly to the thesis API at `https://api.withthesis.dev` using your API key.
21
-
22
11
  ## Claude Desktop
23
12
 
24
13
  Add this to your Claude Desktop MCP config:
@@ -63,73 +52,3 @@ Add this to your Cursor MCP config:
63
52
  - `get_odds`
64
53
  - `get_line_movement`
65
54
  - `get_bookmakers`
66
-
67
- ## Environment Variables
68
-
69
- - `THESIS_API_KEY`: required
70
- - `THESIS_API_URL`: optional, defaults to `https://api.withthesis.dev`
71
-
72
- ## Troubleshooting
73
-
74
- If the client cannot start the server:
75
-
76
- - make sure `npx` is installed and available
77
- - make sure `THESIS_API_KEY` is set
78
- - make sure your API key is the raw key from thesis, not the hashed value in the database
79
-
80
- If the client connects but tool calls fail:
81
-
82
- - verify the API key still works against thesis directly
83
- - check whether your key is free or pro if you expect higher limits
84
- - if you use a custom `THESIS_API_URL`, make sure it points at a working thesis API instance
85
-
86
- ## Advanced
87
-
88
- The published package is for local stdio MCP clients.
89
-
90
- If you want a hosted HTTP MCP endpoint, the thesis server can also be deployed separately and expose an endpoint such as:
91
-
92
- ```txt
93
- https://mcp.withthesis.dev/mcp
94
- ```
95
-
96
- HTTP auth is bearer-token based:
97
-
98
- - `Authorization: Bearer th_live_xxx`
99
- - `X-Thesis-API-Key: th_live_xxx`
100
- - `X-API-Key: th_live_xxx`
101
-
102
- ## Development
103
-
104
- From the repo root:
105
-
106
- ```sh
107
- bun run api:dev
108
- ```
109
-
110
- Remote HTTP dev server:
111
-
112
- ```sh
113
- THESIS_API_URL=http://localhost:4000 \
114
- THESIS_API_KEY=th_live_xxx \
115
- MCP_ALLOW_ENV_AUTH_FALLBACK=true \
116
- bun run mcp:dev:http
117
- ```
118
-
119
- Local stdio dev server:
120
-
121
- ```sh
122
- THESIS_API_URL=http://localhost:4000 \
123
- THESIS_API_KEY=th_live_xxx \
124
- bun run mcp:dev:stdio
125
- ```
126
-
127
- Environment variables:
128
-
129
- - `THESIS_API_URL`: optional, defaults to `https://api.withthesis.dev`
130
- - `THESIS_API_KEY`: required for stdio
131
- - `MCP_ALLOW_ENV_AUTH_FALLBACK`: optional, only for local HTTP dev when you want the server to use `THESIS_API_KEY` without an incoming auth header
132
- - `PORT` or `MCP_PORT`: optional, defaults to `4100`
133
- - `MCP_RATE_LIMIT_REQUESTS_PER_MIN`: optional coarse per-instance front-door rate limit, defaults to `300`
134
-
135
- 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.