hive-intelligence 1.1.2 → 1.1.4

package/README.md

@@ -1,493 +1,467 @@
-<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)
+[![npm version](https://img.shields.io/npm/v/hive-intelligence.svg)](https://www.npmjs.com/package/hive-intelligence)
+[![Node.js 20+](https://img.shields.io/badge/node-%3E%3D20-339933.svg)](https://nodejs.org/)
+[![License: Proprietary](https://img.shields.io/badge/license-Proprietary-red.svg)](./LICENSE)
+[![MCP compatible](https://img.shields.io/badge/MCP-compatible-111827.svg)](https://modelcontextprotocol.io/)
 
-</div>
+Crypto intelligence for AI agents, shipped as a hosted MCP server, local
+`stdio` MCP runtime, CLI, and REST API.
 
-> ⚡ **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)
+Hive gives Claude Code, Cursor, VS Code, OpenAI Responses API, Gemini CLI,
+Codex, and supported custom agents one compact way to discover and call live
+crypto data. Agents route through task toolsets, inspect schemas before
+execution, keep calls bounded, and return provider provenance plus runtime
+status instead of browsing a wall of raw endpoints.
 
----
-
-## What is Hive Intelligence?
-
-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.
+```bash
+npx -y -p hive-intelligence@latest hive init --all --browser
+```
+
+Use the hosted MCP when you want Hive to run auth, rate limits, provider
+infrastructure, and runtime status. Use local `stdio` when you want desktop
+client setup, self-hosting, or provider-key experiments.
+
+## What You Get
+
+- 369 tools across market data, wallets, DeFi, DEX, NFTs, token and
+  contract data, security risk, network infrastructure, search, Solana, and
+  prediction markets, including Hive-native stateful monitoring tools.
+- A compact root MCP endpoint with 13 discovery/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, prediction markets, and stateful monitoring.
+- CLI commands for auth, client setup, tool discovery, schema inspection,
+  direct execution, diagnostics, aliases, polling, and config generation.
+- Runtime resources for providers, categories, full tool catalog, task
+  toolsets, canaries, skills, and status metadata.
+- Bundled agent skills that teach assistants the right Hive workflow:
+  discovery -> schema lookup -> bounded execution -> provenance-aware answer.
 
-Stop stitching CoinGecko + DefiLlama + Moralis + GoPlus + half a dozen others. Point your agent at Hive once, get every crypto answer it needs.
+## Quickstart
 
-**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 hosted MCP or REST API
 
-Nine production data providers, normalized into one tool surface:
+Create a key:
 
-```
-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 |
-
-## Quickstart
-
-The fastest way to use Hive is `npx`. No install required.
+Log in and configure your local AI 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 auth login
+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.
-
-### What you get
-
-```
-hive-intelligence    →  MCP stdio server. Plug into Claude Desktop, Cursor, VS Code, etc.
-hive                  →  CLI. Run any tool from your terminal or scripts.
-```
-
-`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)
+Make a first successful call:
 
 ```bash
-npm install -g hive-intelligence
+npx -y -p hive-intelligence@latest hive market price --ids bitcoin --vs usd --json
 ```
 
-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):
+Expected output shape:
 
 ```json
 {
-  "mcpServers": {
-    "hive": {
-      "command": "npx",
-      "args": ["-y", "hive-intelligence"],
-      "env": { "HIVE_API_KEY": "hive_live_..." }
+  "ok": true,
+  "data": {
+    "bitcoin": {
+      "usd": 0
     }
+  },
+  "meta": {
+    "provider": "CoinGecko",
+    "duration_ms": 0
   }
 }
 ```
 
-### Cursor
+Use `--json` for scripts and agents. Use `--pretty` for human-readable output.
 
-`~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project):
+## Connect Hosted MCP
 
-```json
-{
-  "mcpServers": {
-    "hive": {
-      "command": "npx",
-      "args": ["-y", "hive-intelligence"],
-      "env": { "HIVE_API_KEY": "hive_live_..." }
-    }
-  }
-}
-```
+One-click install, then replace `YOUR_HIVE_API_KEY` with your key from
+[hiveintelligence.xyz](https://hiveintelligence.xyz) (the deep link cannot carry
+your secret):
 
-### VS Code (GitHub Copilot Chat)
+[![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=hive&config=eyJ1cmwiOiJodHRwczovL21jcC5oaXZlaW50ZWxsaWdlbmNlLnh5ei9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgWU9VUl9ISVZFX0FQSV9LRVkifX0%3D)
+[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=hive&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.hiveintelligence.xyz%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20YOUR_HIVE_API_KEY%22%7D%7D)
 
-`.vscode/mcp.json`:
+Hosted MCP URL:
 
-```json
-{
-  "servers": {
-    "hive": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "hive-intelligence"],
-      "env": { "HIVE_API_KEY": "hive_live_..." }
-    }
-  }
-}
+```text
+https://mcp.hiveintelligence.xyz/mcp
 ```
 
-### Claude Code
+Claude Code:
 
 ```bash
-claude mcp add hive -e HIVE_API_KEY=hive_live_... -- npx -y hive-intelligence
+claude mcp add --transport http --header "Authorization: Bearer YOUR_HIVE_API_KEY" hive https://mcp.hiveintelligence.xyz/mcp
 ```
 
-### Windsurf
-
-`~/.codeium/windsurf/mcp_config.json`:
+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"
+      }
     }
   }
 }
 ```
 
-### Gemini CLI
+## Client Compatibility
+
+| Client | Hosted HTTP MCP | Custom auth headers | Local stdio | Recommended setup |
+| --- | --- | --- | --- | --- |
+| Claude Code | Yes | Yes | Yes | `hive init --all --browser` or `claude mcp add ...` |
+| Cursor | Yes | Yes | Yes | `hive config cursor` or `hive init --all --browser` |
+| VS Code | Yes | Yes | Yes | `hive config vscode` or `hive init --all --browser` |
+| Windsurf | Yes | Yes | Yes | `hive init --all --browser` |
+| Gemini CLI | Yes | Yes | Yes | `hive init --all --browser` |
+| Codex | Yes | Yes | Yes | `hive init --all --browser` |
+| OpenAI Responses API | Yes | Yes | No | Use a server-side remote MCP `tools` entry |
+| ChatGPT developer-mode apps | Beta / auth-dependent | Requires OAuth-compatible auth | No | Use Responses API or an OAuth-compatible proxy until Hive exposes OAuth/CIMD |
+| Claude.ai custom connectors/directory | Not yet | No static bearer-token flow | No | Requires OAuth-compatible auth; Hive does not implement OAuth/CIMD yet |
 
-`~/.gemini/settings.json`:
+Header-based API key auth works today for clients or API surfaces that support
+custom headers or authorization tokens. Claude.ai custom connectors, directory
+submissions, and direct ChatGPT app connectors require OAuth-compatible auth, so
+they are planned separately from this API-key MCP path.
+
+## Run Local stdio MCP
+
+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"
+      }
     }
   }
 }
 ```
 
-### Remote MCP (HTTP)
+Running `hive` with no subcommand starts the `stdio` MCP server. `hive-mcp`
+remains available as a backward-compatible binary alias.
 
-For clients that support Streamable HTTP transport (skips the local Node process entirely):
+## Staying Current
 
-```
-URL:     https://mcp.hiveintelligence.xyz/mcp
-Headers: Authorization: Bearer hive_live_...
-```
-
-Full setup guides: [hiveintelligence.xyz/install](https://hiveintelligence.xyz/install)
+The hosted MCP (`https://mcp.hiveintelligence.xyz/mcp`) is managed by Hive.
+Local `stdio` installs are pinned to whatever your client last fetched, so:
 
-## Example prompts
+- Keep `hive-intelligence@latest` in your client config (as shown above) so each
+  host restart re-resolves the newest version.
+- Run `hive upgrade` to update a global install and clear the npx cache, then
+  restart your MCP client to load it:
 
-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.
-
-**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?
-```
-
-**DeFi**
-
-```
-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?
-```
-
-**Wallets and portfolios**
-
-```
-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.
+```bash
+npx -y -p hive-intelligence@latest hive upgrade
 ```
 
-**Token security**
+`hive` checks npm for newer versions once a day and surfaces the result through
+`hive doctor` and the MCP server instructions, so your agent can prompt you when
+an update is available. Set `HIVE_NO_UPDATE_CHECK=1` to disable the check.
 
-```
-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>
-```
+## Use The CLI
 
-**On-chain DEX**
+Search the catalog:
 
-```
-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.
+```bash
+npx -y -p hive-intelligence@latest hive tools search "token risk"
 ```
 
-**NFT analytics**
+Inspect a schema before execution:
 
-```
-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.
+```bash
+npx -y -p hive-intelligence@latest hive tools info get_price
 ```
 
-**Prediction markets**
+Call a tool from the terminal:
 
-```
-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.
+```bash
+npx -y -p hive-intelligence@latest hive market price --ids bitcoin --vs usd --json
 ```
 
-**Network infrastructure**
+Check setup and provider status:
 
+```bash
+npx -y -p hive-intelligence@latest hive doctor
+npx -y -p hive-intelligence@latest hive status
 ```
-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
 
-376+ tools across 10 categories. Every tool is callable directly via `hive tools call <name>` or through the MCP `tools/call` method.
+Generate client config:
 
-| # | 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 |
-
-Live category endpoints (for clients that want a smaller scoped tool surface):
-
-```
-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
+```bash
+npx -y -p hive-intelligence@latest hive config claude-code
+npx -y -p hive-intelligence@latest hive config cursor
+npx -y -p hive-intelligence@latest hive config vscode
 ```
 
-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).
+## How Agents Should Use Hive
 
-## Why Hive over a single-provider MCP?
+Hive is designed for retrieval-led agent work:
 
-| | 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 |
+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`.
 
-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.
+This flow lets an agent answer questions like:
 
-## CLI
+- "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."
+- "Remember this wallet monitor and report when important activity changes."
 
-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.
+## MCP Contract
 
-```bash
-# Crypto prices
-hive market price --ids bitcoin,ethereum,solana --vs usd
+Root endpoint:
 
-# Top 20 coins by market cap
-hive market top --vs usd --limit 20
+```text
+https://mcp.hiveintelligence.xyz/mcp
+```
 
-# DeFi protocol TVL
-hive defi tvl --protocol aave
+Local development endpoint:
 
-# Token security scan
-hive security scan --token 0x...
+```text
+http://localhost:8080/mcp
+```
 
-# Wallet portfolio across chains
-hive portfolio balance --address 0x...
+Root MCP tools:
 
-# Polymarket event stats
-hive prediction markets --event "us-presidential-election-2028"
+- `search_tools`
+- 10 category listing tools, one per crypto domain
+- `get_api_endpoint_schema`
+- `invoke_api_endpoint`
 
-# Search across all 376+ tools
-hive tools search "funding rate"
+## Stateful Monitoring And B2B State
 
-# Run any tool by name
-hive tools call get_price --args '{"ids":"bitcoin","vs_currencies":"usd"}'
-```
+Hive's stateful monitor tools let authenticated agents store durable crypto
+intelligence intent in Hive instead of relying on chat memory. Direct users get
+one default state subject per Hive account. B2B partners can use one Hive API
+key from a trusted backend adapter while isolating downstream customers by
+signed tenant/end-user subject headers.
 
-### CLI domains
+The stateful surface includes monitor CRUD, stored run reads, observations,
+alerts, latest snapshots, memory facts, generated reports, and B2B subject admin
+tools. The scheduled worker runs wallet, token, protocol, market,
+prediction-market, watchlist digest, token discovery risk, and risk watch
+workflows. See
+[`docs/DOCUMENTATION.md`](docs/DOCUMENTATION.md#stateful-monitoring) for the
+full monitor, subject-signing, worker, table, and smoke-test contract.
+For partner products, use
+[`docs/B2B_PARTNER_ADOPTION.md`](docs/B2B_PARTNER_ADOPTION.md) as the
+implementation checklist.
 
-| 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 |
+TypeScript B2B adapters should use `hive-mcp-client/b2b` instead
+of hand-building subject headers or raw monitor calls. If npm returns 404,
+publish the client package with
+[`docs/MCP_CLIENT_RELEASE.md`](docs/MCP_CLIENT_RELEASE.md) before partners
+depend on it:
 
-Run `hive <domain> --help` to see commands within a domain. Run `hive tools list` for the full 376+ tool catalog.
+```ts
+import { createHiveB2BAdapter } from "hive-mcp-client/b2b";
 
-### CLI flags
+const hive = await createHiveB2BAdapter({
+  apiKey: process.env.HIVE_API_KEY!,
+  subjectSigningSecret: process.env.HIVE_SUBJECT_SIGNING_SECRET!,
+});
 
-```
---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
+await hive.createWatchlistDigestMonitor(
+  { tenantId: workspaceId, endUserId: userId },
+  {
+    name: "Daily portfolio brief",
+    target: { wallets, tokens },
+    cadence: "daily",
+  },
+);
 ```
 
-### Auth and profiles
+Verify a B2B key and signed-subject isolation with:
 
 ```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
+curl https://mcp.hiveintelligence.xyz/api/v1/b2b/readiness \
+  -H "Authorization: Bearer $HIVE_API_KEY"
 ```
 
-### Shell completion
-
 ```bash
-# Bash
-eval "$(hive completion bash)"
+HIVE_API_KEY="hive_live_..." \
+HIVE_SUBJECT_SIGNING_SECRET="hive_subject_..." \
+npm run smoke:b2b-partner
+```
 
-# Zsh
-eval "$(hive completion zsh)"
+Discovery resources:
 
-# Fish
-hive completion fish > ~/.config/fish/completions/hive.fish
+- `hive://providers`
+- `hive://categories`
+- `hive://tools`
+- `hive://toolsets`
+- `hive://task-canaries`
+- `hive://skills`
+- `hive://status`
 
-# Auto-install
-hive completion bash --install
-```
+Reusable prompts:
 
-### Aliases
+- `analyze_token`
+- `compare_protocols`
+- `portfolio_audit`
 
-```bash
-hive alias set btc 'market price --ids bitcoin --vs usd'
-hive btc
-```
+Category-scoped MCP endpoints remain available for clients that need direct
+tool lists:
 
-## Pricing
+- `/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`
 
-| 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 |
+## Providers
 
-One credit = one tool call, regardless of upstream provider or response size. Discovery calls (`tools/list`, `GET /api/v1/tools`) are free.
+| 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` |
 
-Full pricing: [hiveintelligence.xyz/pricing](https://hiveintelligence.xyz/pricing)
+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.
 
-Machine-readable pricing for AI agents: [hiveintelligence.xyz/pricing.md](https://hiveintelligence.xyz/pricing.md)
+## REST API
 
-## Configuration
+Use REST when your app does not speak MCP.
 
-| 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) |
+List tools:
 
-## FAQ
+```bash
+curl -X GET "https://mcp.hiveintelligence.xyz/api/v1/tools?search=price&limit=20" \
+  -H "Authorization: Bearer $HIVE_API_KEY"
+```
 
-**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.
+Execute a tool:
 
-**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).
+```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"
+    }
+  }'
+```
 
-**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`.
+## Troubleshooting
 
-**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).
+| Symptom | What to check |
+| --- | --- |
+| `API key required` | Run `hive auth login`, pass `--api-key`, or set the hosted MCP `Authorization: Bearer ...` header. |
+| `Unsupported engine` or install failure | Use Node.js 20 or newer. |
+| Hosted MCP works in one client but not another | Confirm the client supports custom headers. Claude.ai custom connectors need OAuth-compatible auth, which Hive does not implement yet. |
+| A provider tool returns `missing_key` | The tool is discoverable, but that provider needs an env var such as `ALCHEMY_API_KEY`, `HELIUS_API_KEY`, or `MORALIS_API_KEY`. |
+| A provider returns `rate_limited`, `degraded`, or `failing` | Check `hive status`, `hive doctor`, or `hive://status` for runtime status and retry guidance. |
+| `npx` install/cache errors | Retry with a clean cache: `NPM_CONFIG_CACHE=$(mktemp -d) npx -y -p hive-intelligence@latest hive --help`. |
 
-**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.
+## Develop Locally
 
-**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.
+Install:
 
-**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.
+```bash
+npm install
+```
 
-**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."
+Run:
 
-**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.
+```bash
+npm run dev          # stdio MCP
+npm run dev:http     # HTTP MCP and REST API on :8080
+```
 
-## Documentation
+Verify:
 
-- **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)
+```bash
+npm run check
+```
 
-## Development
+Focused checks:
 
 ```bash
-# Install dependencies
-npm install
-
-# Build
 npm run build
+npm run test:unit
+npm run test:mcp-compliance
+npm run verify:toolsets
+npm run verify:agent-skills
+npm run env:render:check
+```
 
-# Test with the MCP inspector
-npm run inspector
+## Package Contents
 
-# Run the MCP server locally
-npm start
-```
+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.
+
+## Contributor Context
 
-## Support
+Core implementation areas:
 
-- **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)
+- `src/mcpServer.ts` builds the MCP servers, tools, resources, prompts, and
+  runtime instructions.
+- `src/server.ts` runs Express, Streamable HTTP MCP, REST routes, auth,
+  middleware, discovery descriptors, and shutdown.
+- `src/taskToolsets.ts` defines the workflow surface agents should prefer over
+  raw endpoint browsing.
+- `src/cli.ts` and `src/cli/` expose auth, setup, discovery, execution,
+  diagnostics, config generation, aliases, and watch mode.
+- `agent-skills/` ships agent-installable Hive skills.
 
-## License
+## Links
 
-MIT © Hive Intelligence
+- Website: https://www.hiveintelligence.xyz
+- Hosted MCP: https://mcp.hiveintelligence.xyz/mcp
+- Public SDK and issues: https://github.com/hive-intel/hive-sdk
+- Public tool catalog: https://mcp.hiveintelligence.xyz/api/v1/tools
+- Install guides: https://www.hiveintelligence.xyz/install
+- Quick start: https://www.hiveintelligence.xyz/quick-start