hive-intelligence 1.1.2 → 1.1.3

package/README.md

@@ -1,493 +1,346 @@
-<div align="center">
-
 # Hive Intelligence
 
-**Institutional-grade crypto market infrastructure for AI agents.**
-
-One MCP server. [376+ live tools](https://mcp.hiveintelligence.xyz/api/v1/tools). 10 categories. 9 data providers — [CoinGecko, DefiLlama, Moralis, GoldRush, Codex, GoPlus, Helius, Tenderly, and CCXT](#powered-by) normalized into a single agent-ready surface, so your agent gets prices, DeFi, wallets, security, and DEX flows in one request instead of nine APIs. Built for Claude, Cursor, ChatGPT, and any agent that speaks Model Context Protocol.
-
-[![npm version](https://img.shields.io/npm/v/hive-intelligence.svg?color=blue&label=npm)](https://www.npmjs.com/package/hive-intelligence)
-[![npm downloads](https://img.shields.io/npm/dw/hive-intelligence.svg?color=blue&label=downloads%2Fweek)](https://www.npmjs.com/package/hive-intelligence)
-[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
-[![MCP](https://img.shields.io/badge/MCP-compatible-orange.svg)](https://modelcontextprotocol.io)
-[![Docs](https://img.shields.io/badge/docs-hiveintelligence.xyz-purple.svg)](https://hiveintelligence.xyz)
-
-[**Quick Start**](#quickstart) · [**Example prompts**](#example-prompts) · [**Tool catalog**](#tool-catalog) · [**FAQ**](#faq) · [**Get an API key**](https://hiveintelligence.xyz/dashboard/keys)
+Crypto intelligence for AI agents, shipped as an MCP server and CLI.
 
-</div>
+`hive-intelligence` gives Claude Code, Cursor, VS Code, ChatGPT Desktop,
+Gemini CLI, Codex, and custom agents one way to discover and call live crypto
+data. Agents get a compact MCP surface, schema lookup, bounded execution,
+provider provenance, and runtime status instead of a wall of raw endpoints.
 
-> ⚡ **New here?** [Try the Free Demo](https://hiveintelligence.xyz/dashboard/keys) (10K credits/month, no card required) · [See install guides](https://hiveintelligence.xyz/install) · [Run a test prompt](#example-prompts)
+```bash
+npx -y -p hive-intelligence@latest hive init --all --browser
+```
 
----
+Use the hosted MCP when you want Hive to run the server, auth, rate limits, and
+provider infrastructure. Use local `stdio` when you want a desktop/self-hosted
+MCP process or provider-key experiments.
 
-## What is Hive Intelligence?
+## What You Get
 
-Hive Intelligence is a managed MCP server that gives AI agents structured, runtime access to live cryptocurrency market data, DeFi activity, wallet positions, token security signals, DEX flows, NFT analytics, prediction markets, and on-chain network data. One API key, one tool surface, nine upstream providers normalized into a single agent-ready schema.
+- 351 provider tools across market data, wallets, DeFi, DEX, NFTs, token and
+  contract data, security risk, network infrastructure, search, Solana, and
+  prediction markets.
+- A compact root MCP endpoint with 13 discovery and execution tools, so agents
+  can route before they call.
+- Task toolsets for market research, token diligence, wallet investigation,
+  security checks, DEX pool analysis, DeFi research, NFT research, Solana
+  analysis, network infrastructure, and prediction markets.
+- A CLI for auth, client setup, tool discovery, schema inspection, direct tool
+  calls, diagnostics, aliases, and polling.
+- Runtime resources for providers, categories, full tool catalog, task
+  toolsets, canaries, skills, and status metadata.
+- Shipped agent skills that teach assistants how to use Hive through discovery,
+  schema lookup, bounded execution, and provenance-aware reporting.
 
-Stop stitching CoinGecko + DefiLlama + Moralis + GoPlus + half a dozen others. Point your agent at Hive once, get every crypto answer it needs.
+## Install Fast
 
-**Used by:** AI agents in Claude Desktop, Cursor, ChatGPT Desktop, Claude Code, Windsurf, VS Code (Copilot Chat), Gemini CLI, and any client that speaks MCP or REST.
+Requirements:
 
-## Powered by
+- Node.js 20+
+- npm
+- A Hive API key for the hosted MCP or hosted REST API
 
-Nine production data providers, normalized into one tool surface:
+Create a key in the Hive dashboard:
 
-```
-CoinGecko · DefiLlama · Moralis · GoldRush · Codex · GoPlus · Helius · Tenderly · CCXT
+```text
+https://www.hiveintelligence.xyz/login?next=/dashboard/keys
 ```
 
-| Provider | Coverage |
-|----------|----------|
-| **CoinGecko** | Market data, prices, OHLCV, exchanges, NFT collections |
-| **DefiLlama** | TVL, yield pools, protocol metrics, bridges, treasuries |
-| **Moralis** | Wallet analytics, NFT data, token transfers, EVM coverage |
-| **GoldRush** (Covalent) | Multi-chain wallet activity, transaction history, 100+ chains |
-| **Codex** (Defined.fi) | DEX pair OHLCV, prediction markets (Polymarket) |
-| **GoPlus** | Token security, honeypot detection, contract risk, malicious-address reputation |
-| **Helius** | Solana RPC, DAS, compressed NFTs, priority fees |
-| **Tenderly** | EVM transaction simulation, contract decode, debugging |
-| **CCXT** | Centralized exchange data, order books, derivatives, funding rates |
+Then configure your client:
 
-## Quickstart
+```bash
+npx -y -p hive-intelligence@latest hive auth login
+npx -y -p hive-intelligence@latest hive config claude-code
+```
 
-The fastest way to use Hive is `npx`. No install required.
+For one-command setup across detected local clients:
 
 ```bash
-HIVE_API_KEY=hive_live_... npx -y -p hive-intelligence hive market price --ids bitcoin --vs usd
+npx -y -p hive-intelligence@latest hive init --all --browser
 ```
 
-Get an API key at [hiveintelligence.xyz/dashboard/keys](https://hiveintelligence.xyz/dashboard/keys). The free **Demo** plan ships with 10,000 monthly credits and access to every tool — no credit card required.
+## Connect Hosted MCP
 
-### What you get
+Hosted MCP URL:
 
-```
-hive-intelligence    →  MCP stdio server. Plug into Claude Desktop, Cursor, VS Code, etc.
-hive                  →  CLI. Run any tool from your terminal or scripts.
+```text
+https://mcp.hiveintelligence.xyz/mcp
 ```
 
-`hive-intelligence` is a stdio transport. Running it directly opens a JSON-RPC channel and waits for an MCP client. It is **not** an interactive command. For terminal use, use the `hive` CLI.
-
-### Install globally (optional)
+Claude Code:
 
 ```bash
-npm install -g hive-intelligence
+claude mcp add --transport http --header "Authorization: Bearer YOUR_HIVE_API_KEY" hive https://mcp.hiveintelligence.xyz/mcp
 ```
 
-After this, both `hive-intelligence` and `hive` are on your `PATH`.
-
-## Connect to your AI client
-
-Drop Hive into any MCP-compatible client. Replace `hive_live_...` with your API key.
-
-### Claude Desktop
-
-`~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+Generic MCP JSON for clients that support remote HTTP and custom headers:
 
 ```json
 {
   "mcpServers": {
     "hive": {
-      "command": "npx",
-      "args": ["-y", "hive-intelligence"],
-      "env": { "HIVE_API_KEY": "hive_live_..." }
+      "url": "https://mcp.hiveintelligence.xyz/mcp",
+      "headers": {
+        "Authorization": "Bearer YOUR_HIVE_API_KEY"
+      }
     }
   }
 }
 ```
 
-### Cursor
+Header-based API key auth works for MCP clients that support custom headers,
+including Claude Code, Cursor, VS Code, Windsurf, Gemini CLI, Codex, and
+ChatGPT Desktop. Claude.ai custom connectors and directory submissions require
+OAuth-compatible auth; Hive does not implement OAuth/CIMD yet.
+
+## Run Local stdio MCP
 
-`~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project):
+Use local `stdio` when you want a self-hosted MCP process, local desktop config,
+or your own upstream provider keys.
 
 ```json
 {
   "mcpServers": {
-    "hive": {
+    "hive-local": {
       "command": "npx",
-      "args": ["-y", "hive-intelligence"],
-      "env": { "HIVE_API_KEY": "hive_live_..." }
+      "args": ["-y", "-p", "hive-intelligence@latest", "hive"],
+      "env": {
+        "COINGECKO_PRO_API_KEY": "optional",
+        "ALCHEMY_API_KEY": "optional",
+        "HELIUS_API_KEY": "optional",
+        "MORALIS_API_KEY": "optional"
+      }
     }
   }
 }
 ```
 
-### VS Code (GitHub Copilot Chat)
+Running `hive` with no subcommand starts the `stdio` MCP server. `hive-mcp`
+remains available as a backward-compatible binary alias.
 
-`.vscode/mcp.json`:
+## Use The CLI
 
-```json
-{
-  "servers": {
-    "hive": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "hive-intelligence"],
-      "env": { "HIVE_API_KEY": "hive_live_..." }
-    }
-  }
-}
-```
-
-### Claude Code
+Search the catalog:
 
 ```bash
-claude mcp add hive -e HIVE_API_KEY=hive_live_... -- npx -y hive-intelligence
+npx -y -p hive-intelligence@latest hive tools search "token risk"
 ```
 
-### Windsurf
+Inspect a schema before execution:
 
-`~/.codeium/windsurf/mcp_config.json`:
-
-```json
-{
-  "mcpServers": {
-    "hive": {
-      "command": "npx",
-      "args": ["-y", "hive-intelligence"],
-      "env": { "HIVE_API_KEY": "hive_live_..." }
-    }
-  }
-}
+```bash
+npx -y -p hive-intelligence@latest hive tools info get_price
 ```
 
-### Gemini CLI
-
-`~/.gemini/settings.json`:
+Call a tool from the terminal:
 
-```json
-{
-  "mcpServers": {
-    "hive": {
-      "command": "npx",
-      "args": ["-y", "hive-intelligence"],
-      "env": { "HIVE_API_KEY": "hive_live_..." }
-    }
-  }
-}
+```bash
+npx -y -p hive-intelligence@latest hive market price --ids bitcoin --vs usd --json
 ```
 
-### Remote MCP (HTTP)
+Check setup and provider status:
 
-For clients that support Streamable HTTP transport (skips the local Node process entirely):
-
-```
-URL:     https://mcp.hiveintelligence.xyz/mcp
-Headers: Authorization: Bearer hive_live_...
+```bash
+npx -y -p hive-intelligence@latest hive doctor
+npx -y -p hive-intelligence@latest hive status
 ```
 
-Full setup guides: [hiveintelligence.xyz/install](https://hiveintelligence.xyz/install)
-
-## Example prompts
-
-Once Hive is connected, talk to your AI client in plain English. Every prompt below maps to a real tool call you don't have to write.
+Useful setup commands:
 
-**Market data**
-
-```
-What's the price of BTC, ETH, and SOL right now in USD?
-Show me the top 10 coins by market cap with 24h change.
-What's the OHLCV for ETH/USD over the last 30 days?
-Which coins gained the most this week?
-What are the current funding rates for BTC perps across exchanges?
+```bash
+npx -y -p hive-intelligence@latest hive config claude-desktop
+npx -y -p hive-intelligence@latest hive config cursor
+npx -y -p hive-intelligence@latest hive config vscode
 ```
 
-**DeFi**
+Use `--json` for scripts and agents. Use `--pretty` for human-readable output.
 
-```
-What's the current TVL of Aave?
-List the top 20 yield pools above 10% APY on Ethereum.
-Compare Uniswap and PancakeSwap fee revenue this month.
-Show me protocol TVL rankings for Solana.
-Which bridges have the highest weekly volume?
-```
+## How Agents Should Use Hive
 
-**Wallets and portfolios**
+Hive is designed for retrieval-led agent work:
 
-```
-Show me the portfolio of vitalik.eth across all chains.
-What tokens does this wallet hold? 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045
-Show DeFi positions for this address on Arbitrum.
-What was this wallet's PnL over the last 30 days?
-List recent NFT trades from this wallet.
-```
+1. Discover the task surface with `search_tools`, `hive://toolsets`, or
+   `hive tools search`.
+2. Inspect exact parameters with `get_api_endpoint_schema` or
+   `hive tools info`.
+3. Execute through `invoke_api_endpoint`, category tools, REST, or the CLI.
+4. Preserve provider, freshness, cache, `_hive`, `meta`, and runtime status in
+   the final answer.
+5. Keep reads bounded with `limit`, `page`, `per_page`, or `offset`.
 
-**Token security**
+This flow lets an agent answer questions like:
 
-```
-Is this token a honeypot? 0x...
-Run a rugpull check on $PEPE.
-Show me the top holders of this token and how concentrated they are.
-What approvals does this wallet have? Are any risky?
-Simulate this transaction before I sign it: <tx hash or calldata>
-```
+- "Is this token safe to buy?"
+- "What changed in this wallet over the last week?"
+- "Compare Aave and Curve by TVL, fees, chains, and risk."
+- "Find active prediction markets for the next Fed decision."
+- "Show the best pools for this token and explain liquidity risk."
 
-**On-chain DEX**
-
-```
-What are the trending pairs on Uniswap V3 right now?
-Show me top trades on Solana DEXes in the last hour.
-What's the liquidity profile of this pool? <pool address>
-Find pairs that whales are accumulating today.
-```
+## MCP Contract
 
-**NFT analytics**
+Root endpoint:
 
-```
-What's the floor price of CryptoPunks? Show 24h trend.
-Compare Bored Apes and Pudgy Penguins on volume.
-Show me the trait floor for this collection.
-List recent compressed NFT mints on Solana.
+```text
+https://mcp.hiveintelligence.xyz/mcp
 ```
 
-**Prediction markets**
+Local development endpoint:
 
-```
-What are the most-traded events on Polymarket this week?
-Show me the top traders on Polymarket by P&L.
-What's the implied probability of this market right now?
-Trace this trader's position history.
+```text
+http://localhost:8080/mcp
 ```
 
-**Network infrastructure**
+Root MCP tools:
 
-```
-What are current gas prices on Ethereum, Arbitrum, and Base?
-Show me Solana priority fees right now.
-List supported chains and their RPC status.
-```
-
-## Tool catalog
+- `search_tools`
+- 10 category listing tools, one per crypto domain
+- `get_api_endpoint_schema`
+- `invoke_api_endpoint`
 
-376+ tools across 10 categories. Every tool is callable directly via `hive tools call <name>` or through the MCP `tools/call` method.
+Discovery resources:
 
-| # | Category | Tools | What's inside |
-|---|----------|-------|---------------|
-| 1 | **Market Data and Price** | 70+ | Prices, OHLCV, market caps, derivatives, funding rates, stablecoins, gainers/losers, exchange tickers |
-| 2 | **On-Chain DEX & Pool Analytics** | 58+ | DEX pools, liquidity, trending pairs, swap history, bridges, GoldRush XY=K analytics |
-| 3 | **Portfolio & Wallet** | 49+ | Balances, PnL, DeFi positions, swap history, NFT holdings, multi-chain history |
-| 4 | **Token & Contract Data** | 44+ | Token metadata, holders, top traders, ENS resolution, treasury tracking, transfers |
-| 5 | **DeFi Protocol Analytics** | 21+ | TVL, fees, yield farming, chain metrics, treasuries, emissions |
-| 6 | **NFT Analytics** | 41+ | Collection data, floors, market charts, NFT pools, trait metadata, sales |
-| 7 | **Security & Risk Analysis** | 37+ | Honeypot detection, rugpull checks, approval risk, Tenderly simulation, gas estimation |
-| 8 | **Network & Infrastructure** | 20+ | Chain health, blocks, gas prices, supported networks, event logs |
-| 9 | **Search & Discovery** | 10+ | Cross-provider search, trending coins, categories, token discovery |
-| 10 | **Prediction Markets** | 19+ | Polymarket events, traders, outcome prices, trade history, market stats |
+- `hive://providers`
+- `hive://categories`
+- `hive://tools`
+- `hive://toolsets`
+- `hive://task-canaries`
+- `hive://skills`
+- `hive://status`
 
-Live category endpoints (for clients that want a smaller scoped tool surface):
+Reusable prompts:
 
-```
-https://mcp.hiveintelligence.xyz/hive_market_data/mcp
-https://mcp.hiveintelligence.xyz/hive_onchain_dex/mcp
-https://mcp.hiveintelligence.xyz/hive_portfolio_wallet/mcp
-https://mcp.hiveintelligence.xyz/hive_token_contract/mcp
-https://mcp.hiveintelligence.xyz/hive_defi_protocol/mcp
-https://mcp.hiveintelligence.xyz/hive_nft_analytics/mcp
-https://mcp.hiveintelligence.xyz/hive_security_risk/mcp
-https://mcp.hiveintelligence.xyz/hive_network_infrastructure/mcp
-https://mcp.hiveintelligence.xyz/hive_search_discovery/mcp
-https://mcp.hiveintelligence.xyz/hive_prediction_markets/mcp
-```
+- `analyze_token`
+- `compare_protocols`
+- `portfolio_audit`
 
-Full live tool list: `https://mcp.hiveintelligence.xyz/api/v1/tools` (requires API key) or [hiveintelligence.xyz/tools/live-catalog](https://hiveintelligence.xyz/tools/live-catalog).
+Category-scoped MCP endpoints remain available for clients that need direct
+tool lists:
 
-## Why Hive over a single-provider MCP?
+- `/hive_market_data/mcp`
+- `/hive_onchain_dex/mcp`
+- `/hive_portfolio_wallet/mcp`
+- `/hive_token_contract/mcp`
+- `/hive_defi_protocol/mcp`
+- `/hive_nft_analytics/mcp`
+- `/hive_security_risk/mcp`
+- `/hive_network_infrastructure/mcp`
+- `/hive_search_discovery/mcp`
+- `/hive_prediction_markets/mcp`
 
-| | Hive | CoinGecko MCP | Moralis MCP | DefiLlama MCP | GoPlus only |
-|---|---|---|---|---|---|
-| Providers normalized | **9** | 1 | 1 | 1 | 1 |
-| Categories | **10** | 2 | 3 | 1 | 1 |
-| Total tools | **376+** | ~50 | ~60 | ~15 | ~20 |
-| Market data | ✓ | ✓ | partial | – | – |
-| DeFi TVL + yields | ✓ | – | – | ✓ | – |
-| Wallet portfolio | ✓ | – | ✓ | – | – |
-| Pre-signing security | **✓** | – | – | – | ✓ |
-| DEX pool analytics | ✓ | – | partial | – | – |
-| Prediction markets | **✓** | – | – | – | – |
-| Solana depth (DAS) | ✓ | – | – | – | – |
-| Managed (no ops) | ✓ | ✓ | partial | varies | varies |
+## Providers
 
-Single-provider MCPs win on niche depth. Hive wins when the agent needs **broad crypto context in one request** — prices + DeFi + wallet + security + DEX in a single conversation, without the user (or the agent) figuring out which tool lives in which provider.
+| Provider | Coverage | Env var |
+| --- | --- | --- |
+| Alchemy | EVM wallet, token, NFT, transfer, simulation, gas, and RPC data | `ALCHEMY_API_KEY` |
+| CoinGecko | Prices, OHLC, trending, news | `COINGECKO_PRO_API_KEY` |
+| DeFiLlama | TVL, yields, fees, bridges | Free |
+| CCXT | CEX data, funding rates, perpetuals | Free |
+| GoPlus | Token, wallet, and dApp security | `GOPLUS_APP_KEY` + `GOPLUS_APP_SECRET` |
+| Codex | DEX analytics and Polymarket prediction markets | `CODEX_API_KEY` |
+| Helius | Solana RPC, DAS, priority fees, wallet history | `HELIUS_API_KEY` |
+| Moralis | Wallet, token, NFT, PnL, DeFi positions | `MORALIS_API_KEY` |
+| Tenderly | EVM simulation, tracing, gas estimation | `TENDERLY_API_KEY` |
 
-## CLI
-
-The `hive` CLI is a thin terminal client over the same Hive API. Set `HIVE_API_KEY` (or `hive auth login` once) and you're done.
-
-```bash
-# Crypto prices
-hive market price --ids bitcoin,ethereum,solana --vs usd
+Providers without configured keys remain discoverable and return classified
+runtime status such as `missing_key`, `plan_required`, `rate_limited`,
+`degraded`, or `failing` when execution is unavailable.
 
-# Top 20 coins by market cap
-hive market top --vs usd --limit 20
+## REST API
 
-# DeFi protocol TVL
-hive defi tvl --protocol aave
+Use REST when your app does not speak MCP.
 
-# Token security scan
-hive security scan --token 0x...
+List tools:
 
-# Wallet portfolio across chains
-hive portfolio balance --address 0x...
-
-# Polymarket event stats
-hive prediction markets --event "us-presidential-election-2028"
-
-# Search across all 376+ tools
-hive tools search "funding rate"
-
-# Run any tool by name
-hive tools call get_price --args '{"ids":"bitcoin","vs_currencies":"usd"}'
+```bash
+curl -X GET "https://mcp.hiveintelligence.xyz/api/v1/tools?search=price&limit=20" \
+  -H "Authorization: Bearer $HIVE_API_KEY"
 ```
 
-### CLI domains
-
-| Domain | What's there |
-|--------|--------------|
-| `market` | Crypto prices, charts, rankings, stablecoins, gas |
-| `defi` | DeFi protocol TVL, fees, yields, bridges |
-| `dex` | DEX pools, trending pairs, trades, volume |
-| `portfolio` | Wallet balances, DeFi positions, NFTs |
-| `security` | Token security scans, approvals, simulations |
-| `wallet` | On-chain balances, transfers, transactions |
-| `nft` | NFT collections, markets, trends |
-| `prediction` | Prediction markets, events, traders, outcomes |
-| `exchange` | CEX tickers, orderbooks, trades, funding rates |
-| `network` | Chains, gas prices, blocks |
-| `search` | Search tokens and pools |
-
-Run `hive <domain> --help` to see commands within a domain. Run `hive tools list` for the full 376+ tool catalog.
-
-### CLI flags
+Execute a tool:
 
+```bash
+curl -X POST https://mcp.hiveintelligence.xyz/api/v1/execute \
+  -H "Authorization: Bearer $HIVE_API_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "tool": "get_price",
+    "args": {
+      "ids": "bitcoin",
+      "vs_currencies": "usd"
+    }
+  }'
 ```
---json          Force JSON envelope output
---pretty        Force human-readable output
---fields <list> Comma-separated fields to include
---jq <expr>     Filter JSON output (jq-like syntax)
---csv           Output as CSV
---timeout <ms>  Request timeout (default: 30000)
---no-retry      Disable automatic retry
--q, --quiet     Suppress non-data output
--v, --verbose   Show debug info
-```
 
-### Auth and profiles
+## Develop Locally
+
+Install:
 
 ```bash
-hive auth login            # Save API key once
-hive auth whoami           # Show current profile
-hive auth profiles         # List all profiles
-hive auth switch prod      # Switch profiles
-hive doctor                # Check connectivity
+npm install
 ```
 
-### Shell completion
+Run:
 
 ```bash
-# Bash
-eval "$(hive completion bash)"
-
-# Zsh
-eval "$(hive completion zsh)"
-
-# Fish
-hive completion fish > ~/.config/fish/completions/hive.fish
-
-# Auto-install
-hive completion bash --install
+npm run dev          # stdio MCP
+npm run dev:http     # HTTP MCP and REST API on :8080
 ```
 
-### Aliases
+Verify:
 
 ```bash
-hive alias set btc 'market price --ids bitcoin --vs usd'
-hive btc
+npm run check
 ```
 
-## Pricing
-
-| Plan | Monthly credits | Rate limit | API keys | Price |
-|------|-----------------|------------|----------|-------|
-| **Demo** | 10,000 | 30 req/min | 1 | Free |
-| **Analyst** | 500,000 | 500 req/min | 10 | $129/mo |
-| **Pro** | 2,000,000 | 1,000 req/min | 25 | $499/mo |
-| **Enterprise** | Custom | 3,000 req/min | 100 | Custom |
-
-One credit = one tool call, regardless of upstream provider or response size. Discovery calls (`tools/list`, `GET /api/v1/tools`) are free.
-
-Full pricing: [hiveintelligence.xyz/pricing](https://hiveintelligence.xyz/pricing)
-
-Machine-readable pricing for AI agents: [hiveintelligence.xyz/pricing.md](https://hiveintelligence.xyz/pricing.md)
-
-## Configuration
-
-| Variable | Description |
-|----------|-------------|
-| `HIVE_API_KEY` | **Required.** API key — or run `hive auth login` |
-| `HIVE_API_URL` | Custom base URL (default: `https://mcp.hiveintelligence.xyz`) |
-| `API_EXECUTE_ENDPOINT` | Override execute endpoint (advanced) |
-
-## FAQ
-
-**What is Hive Intelligence?**
-A managed MCP server, REST API, and CLI that gives AI agents structured access to live crypto market data, DeFi activity, wallet positions, token security signals, DEX flows, NFTs, prediction markets, and on-chain network data through one normalized tool surface.
-
-**What does an API key cost?**
-Free Demo plan with 10,000 monthly credits — no credit card required. Paid plans start at $129/month for 500K credits. Get a key at [hiveintelligence.xyz/dashboard/keys](https://hiveintelligence.xyz/dashboard/keys).
-
-**Why doesn't `npx -y hive-intelligence` show subcommands?**
-`hive-intelligence` is the MCP stdio server bin — it opens a JSON-RPC transport and waits for an MCP client. For interactive terminal use, use the `hive` CLI: `npx -y -p hive-intelligence hive --help`.
-
-**Which AI clients support MCP?**
-Claude Desktop, Claude Code, Claude Mobile, ChatGPT Desktop, Cursor, Windsurf, VS Code (via Copilot Chat), Gemini CLI, and any client implementing the [Model Context Protocol](https://modelcontextprotocol.io). Setup guides for each: [hiveintelligence.xyz/install](https://hiveintelligence.xyz/install).
-
-**Can I use the remote HTTP endpoint instead of stdio?**
-Yes. Point your MCP client at `https://mcp.hiveintelligence.xyz/mcp` with `Authorization: Bearer <key>`. Skips the local Node process entirely. Recommended for ChatGPT Desktop, Cursor (cloud), and any HTTP-MCP-aware client.
-
-**What chains are supported?**
-EVM (Ethereum, Arbitrum, Optimism, Base, Polygon, BNB Chain, Avalanche, and 90+ more), Solana with full Helius DAS coverage including compressed NFTs, Bitcoin, and others depending on the provider mix per category.
-
-**Is the source code open?**
-This package (the CLI and stdio MCP server bin) is MIT-licensed and open source. The managed backend that serves `mcp.hiveintelligence.xyz` is operated as a service.
-
-**How does Hive prevent hallucinated answers?**
-Every tool call returns explicit error envelopes with provider attribution and timestamps. Security tools (`get_token_security`, `detect_rugpull`) wrap GoPlus and return structured risk flags. Time-series tools accept point-in-time params (`at`, `block_number`) so agents can answer historical questions without drifting to "latest."
-
-**Hive vs CoinGecko MCP / Moralis MCP / DefiLlama MCP?**
-Hive normalizes nine providers into one tool surface (376+ tools) covering market data, DeFi, wallets, security, DEX, NFTs, prediction markets, and network infrastructure. Single-provider MCPs go deeper inside their provider's data; Hive goes broader so agents can answer cross-domain questions in one request.
-
-## Documentation
-
-- **Quick Start** — [hiveintelligence.xyz/quick-start](https://hiveintelligence.xyz/quick-start)
-- **API Reference** — [hiveintelligence.xyz/api-integration](https://hiveintelligence.xyz/api-integration)
-- **All Install Guides** — [hiveintelligence.xyz/install](https://hiveintelligence.xyz/install)
-- **CLI Reference** — [hiveintelligence.xyz/cli](https://hiveintelligence.xyz/cli)
-- **Tool Catalog** — [hiveintelligence.xyz/tools/live-catalog](https://hiveintelligence.xyz/tools/live-catalog)
-- **Use Cases** — [hiveintelligence.xyz/use-cases](https://hiveintelligence.xyz/use-cases)
-- **What is MCP for crypto?** — [hiveintelligence.xyz/glossary/mcp-crypto](https://hiveintelligence.xyz/glossary/mcp-crypto)
-
-## Development
+Focused checks:
 
 ```bash
-# Install dependencies
-npm install
-
-# Build
 npm run build
-
-# Test with the MCP inspector
-npm run inspector
-
-# Run the MCP server locally
-npm start
-```
-
-## Support
-
-- **GitHub Issues** — [github.com/hive-intel/hive-crypto-mcp/issues](https://github.com/hive-intel/hive-crypto-mcp/issues)
-- **Email** — [support@hiveintelligence.xyz](mailto:support@hiveintelligence.xyz)
-- **Telegram** — [t.me/HiveIntelligence](https://t.me/HiveIntelligence)
-- **Twitter / X** — [@Hive_Intel](https://x.com/Hive_Intel)
-
-## License
-
-MIT © Hive Intelligence
+npm run test:unit
+npm run test:mcp-compliance
+npm run verify:toolsets
+npm run verify:agent-skills
+npm run env:render:check
+```
+
+Use focused checks while iterating. Run `npm run check` before releases and
+after changes to shared MCP behavior, auth, middleware, provider routing, task
+toolsets, generated metadata, or CLI setup paths.
+
+## Package Contents
+
+The `hive-intelligence` npm package includes:
+
+- `hive`, `hive-intelligence`, `hive-mcp`, and `hive-mcp-server` binaries.
+- Built MCP server and CLI files in `build/`.
+- Bundled Hive agent skills in `agent-skills/`.
+- Local `stdio` MCP runtime for desktop clients and self-hosting.
+
+## Architecture Map
+
+- `src/mcpServer.ts` builds root/category MCP servers, tools, resources,
+  prompts, and runtime instructions.
+- `src/server.ts` runs Express, Streamable HTTP MCP, REST routes, auth, rate
+  limits, CORS, security headers, discovery descriptors, and shutdown.
+- `src/toolRegistry.ts` defines the 10 category surfaces.
+- `src/wrapper/allEndpoints.ts` maps provider tools into the public Hive tool
+  catalog.
+- `src/taskToolsets.ts` defines the workflow surface agents should prefer over
+  raw endpoint browsing.
+- `src/agentSkills.ts` and `agent-skills/` ship agent-installable Hive skills.
+- `src/cli.ts` and `src/cli/` expose auth, setup, discovery, execution,
+  diagnostics, config generation, aliases, and watch mode.
+- `packages/mcp-client/` contains the typed client adapter.
+- `tests/` covers unit, integration, E2E, MCP compliance, live, security, and
+  Docker readiness paths.
+
+## Links
+
+- Website: https://www.hiveintelligence.xyz
+- Hosted MCP: https://mcp.hiveintelligence.xyz/mcp
+- Docs overview: https://github.com/sharpe-labs/hive-mcp2/blob/master/docs/DOCUMENTATION.md
+- Tool reference: https://github.com/sharpe-labs/hive-mcp2/blob/master/docs/TOOLS_REFERENCE.md
+- Agent instructions: https://github.com/sharpe-labs/hive-mcp2/blob/master/AGENTS.md
+- Contributing: https://github.com/sharpe-labs/hive-mcp2/blob/master/CONTRIBUTING.md
+- Security: https://github.com/sharpe-labs/hive-mcp2/blob/master/SECURITY.md
+- Changelog: https://github.com/sharpe-labs/hive-mcp2/blob/master/CHANGELOG.md