@gotza02/sequential-thinking 10000.1.4 → 10000.1.5

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 (2) hide show
  1. package/README.md +128 -6
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -17,11 +17,16 @@ Forces the AI to think before acting using a strict block-based flow:
17
17
  - **Auto-Backup:** Automatically creates `.bak` backups before modifying any file via `deep_code_edit`.
18
18
  - **Destructive Action Protection:** Prevents accidental data loss during code refactoring.
19
19
 
20
- ### ⚽ Sports Intelligence (Upgraded)
21
- - **Dual-Source Deep Dive:** Simultaneously scrapes news (BBC, Sky) and stats (Understat, FBref) for comprehensive coverage.
22
- - **Smart xG Extraction:** "Smart Extractor" technology specifically for Understat to get accurate Expected Goals data.
23
- - **Handicap Odds:** Dedicated search protocols for Asian Handicap and betting market analysis.
24
- - **Fallback Protection:** Intelligent warning system when API keys are missing.
20
+ ### ⚽ Sports Intelligence (v10000.1.4+)
21
+ - **API Data Integration:** Direct API access for H2H, form, and odds (API-Football, Football-Data, SportsDB)
22
+ - **Smart Query Optimization:** Skips web search when API has data, assesses data quality (0-100 score)
23
+ - **Structured Output:** JSON analysis with probability ranges, value bets, and confidence scores
24
+ - **Uncertainty Quantification:** Probability ranges (e.g., 45% ± 10%) based on data quality
25
+ - **Value Detection:** Auto-detect value bets with Kelly Criterion stake recommendations
26
+ - **Adaptive Caching:** Dynamic TTL based on match timing (odds: 1-15 min, stats: 24 hours)
27
+ - **Dual-Source Deep Dive:** Simultaneously scrapes news (BBC, Sky) and stats (Understat, FBref)
28
+ - **Smart xG Extraction:** "Smart Extractor" for accurate Expected Goals data
29
+ - **Fallback Protection:** Intelligent warning system when API keys are missing
25
30
 
26
31
  ### 🌐 Web Search Integration
27
32
  - Built-in support for **Exa**, **Brave**, **Google Search**, and **DuckDuckGo** (New!).
@@ -49,4 +54,121 @@ Forces the AI to think before acting using a strict block-based flow:
49
54
 
50
55
  ```bash
51
56
  npx -y @gotza02/sequential-thinking
52
- ```
57
+ ```
58
+
59
+ ## 🔧 Claude Code Configuration
60
+
61
+ Add to your `~/.claude/CLAUDE.md` or project-specific `.claude/CLAUDE.md`:
62
+
63
+ ```json
64
+ {
65
+ "mcpServers": {
66
+ "sequential-thinking": {
67
+ "command": "npx",
68
+ "args": ["-y", "@gotza02/sequential-thinking"],
69
+ "env": {
70
+ "BRAVE_API_KEY": "your_brave_key",
71
+ "EXA_API_KEY": "your_exa_key",
72
+ "API_FOOTBALL_KEY": "your_api_football_key"
73
+ }
74
+ }
75
+ }
76
+ }
77
+ ```
78
+
79
+ ## 🛠️ Available MCP Tools
80
+
81
+ ### 🧠 Thinking & Analysis Tools
82
+ | Tool | Description |
83
+ |------|-------------|
84
+ | `sequentialthinking` | Structured problem-solving with Analysis → Planning → Execution → Observation → Reflection |
85
+ | `analyze_football_match_v2` | Comprehensive football match analysis with API + web search |
86
+ | `analyze_football_match_structured` | JSON output match analysis with probabilities & value bets |
87
+ | `get_live_scores` | Live football scores with caching |
88
+ | `get_match_details` | Detailed match information by ID |
89
+
90
+ ### ⚽ Sports Analysis Tools
91
+ | Tool | Description |
92
+ |------|-------------|
93
+ | `get_team_stats` | Team statistics and performance metrics |
94
+ | `compare_teams` | Head-to-head team comparison |
95
+ | `get_player_stats` | Player statistics and form |
96
+ | `odds_comparison` | Compare betting odds across markets |
97
+ | `value_bet_calculator` | Calculate Kelly Criterion & value bets |
98
+ | `track_prediction` | Log sports predictions for ROI tracking |
99
+ | `resolve_prediction` | Update prediction results |
100
+ | `analyze_roi` | Analyze betting performance statistics |
101
+
102
+ ### 🔍 Search & Research Tools
103
+ | Tool | Description |
104
+ |------|-------------|
105
+ | `brave_web_search` | Web search via Brave Search API |
106
+ | `exa_web_search` | Neural web search via Exa API |
107
+ | `duckduckgo_search` | Anonymous web search (no API key) |
108
+ | `web_read` | Read and extract content from URLs |
109
+
110
+ ### 💻 Code Management Tools
111
+ | Tool | Description |
112
+ |------|-------------|
113
+ | `deep_code_edit` | Structural code editing with auto-backup |
114
+ | `add_code_snippet` | Store reusable code patterns |
115
+ | `search_code` | Semantic code search |
116
+ | `get_project_graph` | Analyze codebase structure |
117
+
118
+ ### 📝 Knowledge & Notes Tools
119
+ | Tool | Description |
120
+ |------|-------------|
121
+ | `add_note` | Create and store notes |
122
+ | `search_notes` | Search through stored notes |
123
+ | `create_knowledge_node` | Add node to knowledge graph |
124
+ | `query_knowledge_graph` | Query relationships in knowledge graph |
125
+
126
+ ### 👤 Human Interface Tools
127
+ | Tool | Description |
128
+ |------|-------------|
129
+ | `ask_human` | Request human input/clarification |
130
+ | `request_workflow_approval` | Get approval for multi-step workflows |
131
+
132
+ ## 🤖 System Instructions for Claude Code
133
+
134
+ Add this to your Claude Code settings for optimal use:
135
+
136
+ ```markdown
137
+ SYSTEM INSTRUCTION: SmartAgent Elite Controller
138
+
139
+ You are an AI assistant with access to the Sequential Thinking MCP server.
140
+
141
+ CRITICAL DIRECTIVES:
142
+ 1. ALWAYS use sequentialthinking tool for complex tasks
143
+ 2. Use web search for up-to-date information (never hallucinate)
144
+ 3. For sports analysis:
145
+ - Use analyze_football_match_v2 for detailed text analysis
146
+ - Use analyze_football_match_structured for JSON/probability data
147
+ - Check value_bet_calculator for betting recommendations
148
+ 4. Use deep_code_edit for structural code changes (creates backups)
149
+ 5. Track predictions with track_prediction for ROI analysis
150
+
151
+ TOOL PRIORITY:
152
+ - Information needed → web_search (Brave/Exa/DuckDuckGo)
153
+ - Problem solving → sequentialthinking
154
+ - Sports data → analyze_football_match_* tools
155
+ - Code editing → deep_code_edit
156
+ - Human input → ask_human
157
+
158
+ SAFETY PROTOCOLS:
159
+ - Auto-backup enabled for all file edits
160
+ - Destructive actions require human approval
161
+ - Rate limiting active on all external APIs
162
+ ```
163
+
164
+ ## 🔐 Required Environment Variables
165
+
166
+ | Variable | Purpose | Required For |
167
+ |----------|---------|--------------|
168
+ | `BRAVE_API_KEY` | Brave Search API | Web search |
169
+ | `EXA_API_KEY` | Exa Neural Search | Advanced web search |
170
+ | `API_FOOTBALL_KEY` | API-Football | Sports data (RapidAPI) |
171
+ | `FOOTBALL_DATA_KEY` | Football-Data.org | Alternative sports API |
172
+ | `SPORTS_DB_KEY` | TheSportsDB | Backup sports API |
173
+
174
+ **Note:** DuckDuckGo search works without API keys as a fallback.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@gotza02/sequential-thinking",
3
- "version": "10000.1.4",
3
+ "version": "10000.1.5",
4
4
  "publishConfig": {
5
5
  "access": "public"
6
6
  },