Get Started
CLI and Agent Skills Setup
Hive's local CLI setup is separate from MCP client registration. Use the CLI to store local credentials, inspect health, and print client-specific setup output; use the per-client install guides to add Hive MCP to Claude, Cursor, VS Code, Windsurf, Codex, Gemini, or OpenAI Responses API.
Run the CLI setup wizard
The published npm package is hive-intelligence and currently requires Node 20 or higher. Its CLI binary is hive, so one-off npx commands should use -p:
npx -y -p hive-intelligence@latest hive init --all --browserThe current published CLI (hive-intelligence 1.1.4) supports:
hive init
hive init --all
hive init --browser
hive init --skip-skills
hive init --skip-verify
hive init --minimal
hive init --dry-run
hive init --api-url https://mcp.hiveintelligence.xyzhive init --all --browser is the full local setup path: it opens the browser auth flow where available, configures local CLI credentials, and installs supported local agent resources. For a smaller setup, use hive init --minimal. For MCP client registration details, choose the client you want from the install index.
Print client-specific config output
After the CLI is available, print the config shape for the client you are configuring:
hive config claude-desktop
hive config cursor
hive config vscode
hive config claude-code
hive config http https://mcp.hiveintelligence.xyz/mcpThose commands print instructions or JSON for the target client. Compare the output with the dedicated client guide before applying it, because each client handles HTTP transport, headers, and config file scope differently.
Client setup guides
- Claude Desktop - use Claude's Custom Connectors UI for remote MCP; stdio config is the fallback.
- Claude Code - use
claude mcp addwith HTTP or stdio. - Cursor - add Hive in Cursor MCP settings or config.
- VS Code - use Copilot Chat MCP server config.
- Windsurf - add Hive to
mcp_config.json. - OpenAI Responses API - use server-side remote MCP or REST; ChatGPT app UI setup may require an OAuth-compatible proxy.
- Codex CLI - add Hive to Codex MCP config.
- Gemini CLI - add Hive to Gemini settings.
What are Hive agent skills?
A skill is a Markdown instruction pack an AI agent can read before using a service. Hive's skill pack teaches agents how to install Hive, pick the right task toolset, inspect schemas, call tools safely, and report current crypto data without guessing from stale training data.
Hive publishes skills in four places:
| Source | Use it for |
|---|---|
npx skills add hive-intel/hive-skills | Install all public Hive skills into a supported agent environment |
npx skills add hive-intel/hive-skills --skill hive-token-diligence --yes | Install one focused Hive workflow skill |
hive://skills | Runtime skill metadata during an MCP session |
/skills/index.json | Public JSON mirror for crawlers and non-MCP agents |
/skills/*.md | Human-readable Markdown mirrors |
/agent-onboarding/SKILL.md | Agent install-path decision tree |
Runtime MCP clients should prefer hive://skills because it comes from the live server session.
The public installable mirror is github.com/hive-intel/hive-skills. To inspect it before installing, run:
npx skills add hive-intel/hive-skills --listVerify local CLI setup
hive doctor
hive statushive doctor checks Node, network access, and Hive server connectivity. hive status confirms the active CLI profile and authentication state.
You can also verify the live REST catalog directly:
curl -X GET "https://mcp.hiveintelligence.xyz/api/v1/tools?limit=5" \
-H "Authorization: Bearer YOUR_HIVE_API_KEY"Remove local setup
Use the current uninstall command to remove Hive MCP entries and copied skill packs:
hive uninstall --all
hive uninstall --dry-runThen clear local CLI credentials:
hive auth logoutIf you installed the package globally, remove the binary with your package manager:
npm uninstall -g hive-intelligenceRelated
- CLI Reference - every Hive CLI command
- Agent Skills - all 17 public skill mirrors
- All install guides - per-client MCP setup
- API Keys - manage keys in the dashboard
- Crypto MCP Server - what the MCP endpoint exposes