hive-intelligence 0.3.0 → 0.3.1

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 +188 -69
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,112 +1,231 @@
1
- # Hive Intelligence MCP Server
1
+ # Hive Intelligence
2
2
 
3
- A Model Context Protocol (MCP) server providing comprehensive cryptocurrency, Web3, and financial market analytics through intelligent tool orchestration.
3
+ MCP server and CLI for cryptocurrency, Web3, and financial market analytics. Access **351 tools** across **14 categories** from your AI assistant or terminal.
4
4
 
5
- ## Overview
5
+ ## Install
6
6
 
7
- Hive Intelligence MCP Server enables AI assistants to access a wide range of cryptocurrency, DeFi, Web3, equities, forex, and macroeconomic analytics through a unified MCP interface. The server provides both dynamic and category-specific access to **351 specialized tools** across **14 analytics categories**, powered by data from CoinGecko, LunarCrush, DefiLlama, GeckoTerminal, Codex, DeBank, GoPlus, GoldRush, CCXT, Finnhub, FRED, and more.
7
+ ```bash
8
+ npm install -g hive-intelligence
9
+ ```
8
10
 
9
- ### Analytics Categories
11
+ This gives you two commands:
10
12
 
11
- | # | Category | Tools | Description |
12
- |---|----------|-------|-------------|
13
- | 1 | **Market Data & Price** | 83 | Real-time/historical prices, OHLCV, market caps, stablecoins, CEX trading data, derivatives, funding rates, options |
14
- | 2 | **On-Chain DEX & Pool** | 44 | DEX pools, liquidity, trending pairs, OHLCV, trader stats, volume analytics, cross-chain bridges |
15
- | 3 | **Portfolio & Wallet** | 38 | Wallet balances, transaction history, DeFi positions, multi-chain portfolio tracking, Bitcoin wallets |
16
- | 4 | **Token & Contract** | 27 | Token metadata, holder distributions, contract analysis, treasury tracking, transaction forensics |
17
- | 5 | **DeFi Protocol** | 23 | TVL data, protocol fees, yield farming, chain metrics, treasuries, raises, emissions |
18
- | 6 | **NFT Analytics** | 37 | Collection data, market charts, liquidity pools, holder analysis, cross-chain NFT tracking |
19
- | 7 | **Security & Risk** | 20 | Token security, honeypot detection, phishing detection, rugpull analysis, approval auditing |
20
- | 8 | **Network & Infrastructure** | 24 | Network health, gas prices, block data, event logs, chain statuses, address resolution |
21
- | 9 | **Search & Discovery** | 10 | Coin search, trending analysis, categories, token discovery, exchange listings |
22
- | 10 | **Social & Sentiment** | 17 | Social analytics, influencer tracking, news aggregation, Galaxy Score, AltRank |
23
- | 11 | **Stocks & Equities** | 8 | Real-time quotes, historical candles, company profiles, analyst recommendations |
24
- | 12 | **Forex & Commodities** | 4 | Forex rates, currency pair candles, commodity prices (gold, silver, platinum) |
25
- | 13 | **Economic Indicators** | 13 | GDP, CPI, fed rate, treasury yields, unemployment, S&P 500, FRED time series |
26
- | 14 | **Alternative Data** | 5 | Insider trading, sentiment scores, earnings calendar, IPO calendar |
27
-
28
- ### Data Providers
29
-
30
- - **CoinGecko** - Market data, coin metadata, exchanges, NFTs, derivatives
31
- - **LunarCrush** - Social sentiment, Galaxy Score, AltRank, influencer tracking
32
- - **DefiLlama** - TVL, protocol fees, yields, stablecoins, bridges, treasuries, hacks
33
- - **GeckoTerminal** - On-chain DEX pools, OHLCV, trades, trending pairs
34
- - **Codex** - Token pairs, liquidity, trader analytics, chart data, wallet filtering
35
- - **DeBank** - EVM wallet portfolios, DeFi positions, protocol analytics, token info
36
- - **GoPlus** - Token/NFT security, honeypot detection, phishing, rugpull analysis
37
- - **GoldRush (Covalent)** - 100+ chain coverage, token balances, transactions, NFTs, Bitcoin
38
- - **CCXT** - CEX trading data, order books, OHLCV, funding rates, derivatives
39
- - **Finnhub** - Stock quotes, company profiles, forex, commodities, insider trading
40
- - **FRED** - 800,000+ economic time series, GDP, CPI, interest rates
41
-
42
- ## Installation
13
+ | Command | Purpose |
14
+ |---------|---------|
15
+ | `hive-intelligence` | MCP stdio server for AI clients (Claude Desktop, Cursor, VS Code, etc.) |
16
+ | `hive` | CLI tool for terminal usage |
43
17
 
44
- ```bash
45
- # Install dependencies
46
- npm install
18
+ ## MCP Server Setup
47
19
 
48
- # Build the server
49
- npm run build
20
+ ### Claude Desktop
50
21
 
51
- # Start the server
52
- npm start
53
- ```
22
+ Add to your config file:
54
23
 
55
- ### MCP Client Configuration
56
-
57
- Add to your MCP client configuration:
24
+ - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
25
+ - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
58
26
 
59
27
  ```json
60
28
  {
61
29
  "mcpServers": {
62
30
  "hive": {
63
31
  "command": "npx",
64
- "args": ["-y", "mcp-hive"]
32
+ "args": ["-y", "hive-intelligence"]
65
33
  }
66
34
  }
67
35
  }
68
36
  ```
69
37
 
70
- ## Usage
38
+ ### Cursor
71
39
 
72
- ### Claude Desktop Configuration
40
+ Add to `.cursor/mcp.json`:
73
41
 
74
- Add to your Claude Desktop configuration file:
42
+ ```json
43
+ {
44
+ "mcpServers": {
45
+ "hive": {
46
+ "command": "npx",
47
+ "args": ["-y", "hive-intelligence"]
48
+ }
49
+ }
50
+ }
51
+ ```
52
+
53
+ ### VS Code
75
54
 
76
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
77
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
55
+ Add to `.vscode/mcp.json`:
78
56
 
79
57
  ```json
80
58
  {
81
- "mcpServers": {
82
- "hive-mcp": {
59
+ "servers": {
60
+ "hive": {
61
+ "type": "stdio",
83
62
  "command": "npx",
84
- "args": ["-y", "mcp-hive"]
63
+ "args": ["-y", "hive-intelligence"]
85
64
  }
86
65
  }
87
66
  }
88
67
  ```
89
68
 
90
- ## Development
69
+ ### Claude Code
70
+
71
+ ```bash
72
+ claude mcp add hive-intelligence -- npx -y hive-intelligence
73
+ ```
74
+
75
+ ### Remote MCP Server
91
76
 
92
- ### Building
77
+ For clients that support HTTP transport:
78
+
79
+ ```
80
+ https://mcp.hiveintelligence.xyz/mcp
81
+ ```
82
+
83
+ More details: https://hiveintelligence.xyz/crypto-mcp
84
+
85
+ ## CLI Usage
86
+
87
+ The `hive` CLI is a lightweight client that talks to the Hive API. No API keys needed to get started.
93
88
 
94
89
  ```bash
95
- # Development build
96
- npm run build
90
+ # Get Bitcoin price
91
+ hive market price --ids bitcoin --vs usd
92
+
93
+ # Top coins by market cap
94
+ hive market top --vs usd --limit 10
95
+
96
+ # DeFi protocol TVL
97
+ hive defi tvl --protocol aave
98
+
99
+ # Stock quote
100
+ hive stocks quote --symbol AAPL
101
+
102
+ # Search across all tools
103
+ hive tools search "price"
104
+
105
+ # Run any tool by name
106
+ hive tools call get_price --args '{"ids": "ethereum", "vs_currencies": "usd"}'
107
+ ```
108
+
109
+ ### CLI Commands
110
+
111
+ | Domain | Description |
112
+ |--------|-------------|
113
+ | `market` | Crypto prices, charts, rankings, stablecoins, gas |
114
+ | `defi` | DeFi protocol TVL, fees, yields, bridges |
115
+ | `portfolio` | Wallet balances, DeFi positions, NFTs |
116
+ | `security` | Token security scans, approvals, simulations |
117
+ | `stocks` | Stock quotes, candles, financials, analyst ratings |
118
+ | `macro` | GDP, CPI, rates, employment, economic calendar |
119
+ | `social` | Sentiment, influencers, trending topics |
120
+ | `exchange` | CEX tickers, orderbooks, trades, funding rates |
121
+ | `dex` | DEX pools, trending pairs, trades, volume |
122
+ | `wallet` | On-chain balances, transfers, transactions |
123
+ | `nft` | NFT collections, markets, trends |
124
+ | `network` | Chains, gas prices, blocks |
125
+ | `search` | Search tokens and pools |
126
+ | `altdata` | Insider trades, earnings, IPOs |
127
+
128
+ ### CLI Options
97
129
 
98
- # Production build with executable permissions
99
- npm run prepare
130
+ ```
131
+ --json Force JSON output
132
+ --pretty Force human-readable output
133
+ --fields <list> Comma-separated fields to include
134
+ --jq <expr> Filter JSON output (jq-like syntax)
135
+ --csv Output as CSV
136
+ --timeout <ms> Request timeout (default: 30000)
137
+ --no-retry Disable automatic retry
138
+ -q, --quiet Suppress non-data output
139
+ -v, --verbose Show debug info
100
140
  ```
101
141
 
102
- ### Testing
142
+ ### Authentication and Profiles
103
143
 
104
144
  ```bash
105
- # Use MCP inspector for testing
145
+ # Log in with API key
146
+ hive auth login
147
+
148
+ # Check connectivity
149
+ hive doctor
150
+
151
+ # Show current profile
152
+ hive auth whoami
153
+
154
+ # Manage multiple profiles
155
+ hive auth profiles
156
+ hive auth switch production
157
+ ```
158
+
159
+ ### Shell Completion
160
+
161
+ ```bash
162
+ # Bash
163
+ eval "$(hive completion bash)"
164
+
165
+ # Zsh
166
+ eval "$(hive completion zsh)"
167
+
168
+ # Fish
169
+ hive completion fish > ~/.config/fish/completions/hive.fish
170
+
171
+ # Auto-install
172
+ hive completion bash --install
173
+ ```
174
+
175
+ ### Aliases
176
+
177
+ ```bash
178
+ hive alias set btc 'market price --ids bitcoin --vs usd'
179
+ hive btc
180
+ ```
181
+
182
+ ## Analytics Categories (351 Tools)
183
+
184
+ | # | Category | Tools | Description |
185
+ |---|----------|-------|-------------|
186
+ | 1 | Market Data & Price | 83 | Real-time/historical prices, OHLCV, market caps, stablecoins, derivatives, funding rates |
187
+ | 2 | On-Chain DEX & Pool | 44 | DEX pools, liquidity, trending pairs, trader stats, volume, bridges |
188
+ | 3 | Portfolio & Wallet | 38 | Wallet balances, transaction history, DeFi positions, multi-chain tracking |
189
+ | 4 | Token & Contract | 27 | Token metadata, holder distributions, contract analysis, treasury tracking |
190
+ | 5 | DeFi Protocol | 23 | TVL data, protocol fees, yield farming, chain metrics, treasuries |
191
+ | 6 | NFT Analytics | 37 | Collection data, market charts, liquidity pools, holder analysis |
192
+ | 7 | Security & Risk | 20 | Token security, honeypot detection, phishing, rugpull analysis |
193
+ | 8 | Network & Infrastructure | 24 | Network health, gas prices, block data, chain statuses |
194
+ | 9 | Search & Discovery | 10 | Coin search, trending analysis, categories, token discovery |
195
+ | 10 | Social & Sentiment | 17 | Social analytics, influencer tracking, news, Galaxy Score, AltRank |
196
+ | 11 | Stocks & Equities | 8 | Real-time quotes, candles, company profiles, recommendations |
197
+ | 12 | Forex & Commodities | 4 | Forex rates, commodity prices (gold, silver, platinum) |
198
+ | 13 | Economic Indicators | 13 | GDP, CPI, fed rate, treasury yields, unemployment, S&P 500 |
199
+ | 14 | Alternative Data | 5 | Insider trading, sentiment scores, earnings/IPO calendar |
200
+
201
+ ## Data Providers
202
+
203
+ CoinGecko, LunarCrush, DefiLlama, GeckoTerminal, Codex, DeBank, GoPlus, GoldRush (Covalent), CCXT, Finnhub, FRED
204
+
205
+ ## Environment Variables
206
+
207
+ | Variable | Description |
208
+ |----------|-------------|
209
+ | `HIVE_API_KEY` | API key (or use `hive auth login`) |
210
+ | `HIVE_API_URL` | Custom server URL (default: `https://mcp.hiveintelligence.xyz`) |
211
+ | `API_EXECUTE_ENDPOINT` | Override MCP server backend URL |
212
+
213
+ ## Development
214
+
215
+ ```bash
216
+ # Install dependencies
217
+ npm install
218
+
219
+ # Build
220
+ npm run build
221
+
222
+ # Test with MCP inspector
106
223
  npm run inspector
224
+
225
+ # Start MCP server locally
226
+ npm start
107
227
  ```
108
- ---
109
228
 
110
- ## Remote MCP Server
111
- Checkout the guide to use Hive's remote MCP server:
112
- https://hiveintelligence.xyz/crypto-mcp
229
+ ## License
230
+
231
+ MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "hive-intelligence",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "MCP server and CLI for Hive Intelligence — crypto, DeFi, stocks, forex, and macro data",
5
5
  "type": "module",
6
6
  "scripts": {