Documentation
Get started with hive-rank in under a minute.
Install with one command (auto-detects all platforms):
Auto-detects Claude Code, OpenCode, and Codex CLI. Configures MCP server, hooks, and slash commands for each platform.
Platform Setup
Claude Code
Full experience — MCP tools, data capture hooks, and 23 slash commands.
npx hive-rank claude mcp add --transport http hive-rank https://mcp.hive-rank.com/mcp OpenCode
Query tools only — no capture hooks, no slash commands.
npx hive-rank ~/.config/opencode/opencode.json:{
"mcp": {
"hive-rank": {
"type": "remote",
"url": "https://mcp.hive-rank.com/mcp",
"enabled": true
}
}
} Codex CLI
Query tools only — no capture hooks, no slash commands.
npx hive-rank ~/.codex/config.toml:[features] experimental_use_rmcp_client = true [mcp_servers.hive_rank] url = "https://mcp.hive-rank.com/mcp"
Platform Comparison
| Feature | Claude Code | OpenCode | Codex CLI |
|---|---|---|---|
| MCP query tools | Yes | Yes | Yes |
| Data capture | Yes | No | No |
| Slash commands | 23 | No | No |
| Auto-install | Yes | Yes | Yes |
Hive Tools
10 tools — 8 work anonymously, 2 require a workspace token.
hive_rankings Aggregated rankings from the network for a query hive_trending Trending queries across the network hive_domain Network intelligence for a domain hive_score Domain authority score (0-100) from network data hive_stats Network-wide statistics hive_contributors Contributor activity stats hive_search Full-text search across network queries hive_contribute Submit anonymized search data to the network hive_whoami Verify which workspace your token belongs to — tier, scopes, credit balance · requires token hive_my_monitors Your workspace monitors with a 30-day probe rollup · requires token Usage Examples
Just ask your agent in natural language. It will call the right tool automatically.
"Check how my site ranks for best project management tools"
Returns aggregated ranking positions from real AI agent searches across the network.
"What's the hive score for github.com?"
Returns a 0-100 authority score computed from network-wide search data.
"What SEO queries are trending right now?"
Returns the most active queries across all network contributors.
Authentication & Tokens
All read tools work anonymously. A personal access token unlocks workspace tools
(hive_whoami, hive_my_monitors)
and mints credits to your workspace when your sessions contribute data.
- Create a token at app.hive-rank.com/dashboard/settings/tokens — the plaintext is shown once.
- Wire it in:
npx hive-rank auth— paste the token when prompted. It's stored at~/.hive-rank/auth.json(mode 600) and attached to the MCP connection and capture hooks automatically. - Verify: ask your agent to run
hive_whoami— it returns your workspace, tier, scopes, and credit balance. - Revoke any time from the dashboard; the local file can be deleted with
rm ~/.hive-rank/auth.json.
Privacy
The hive is designed with privacy as a core principle.