---
name: hive-build
description: "Use this skill when the user is integrating Hive into application code, backend services, agents, cron jobs, source-controlled adapters, or production systems — wiring Hive into a Next.js API route, a Python or Go cron job, a Rust or Java service, or a LangChain/CrewAI agent — rather than asking a one-off chat query."
license: MIT
metadata:
  package: "@hiveintelligence/agent-skills"
  category: "build"
  requires_network: "true"
version: 1.0.0
---

# Build With Hive

Use Hive from application code through REST, MCP clients, or the published TypeScript adapter.

## Trigger

Use this skill when the user is integrating Hive into application code, backend services, agents, cron jobs, source-controlled adapters, or production systems — wiring Hive into a Next.js API route, a Python or Go cron job, a Rust or Java service, or a LangChain/CrewAI agent — rather than asking a one-off chat query.

## Use when

- integrate api
- backend
- sdk
- production app

## Source

Canonical source path: `agent-skills/packs/hive-build/SKILL.md`

## Task toolsets

- `search_discovery` — Route ambiguous requests to exact task toolsets, categories, tools, schemas, and entity identifiers. Required identifiers: natural-language query.

## Procedure

1. Keep `HIVE_API_KEY` server-side. Browser apps should call a backend route you control.
2. For public registry installs and non-TypeScript stacks, call the REST discovery and execution endpoints directly.
3. For TypeScript backends, run `npm install hive-mcp-client` and use the adapter for schema lookup, endpoint invocation, retries, and metadata reads.
4. Discover tools at runtime with `search_tools`, `hive://toolsets`, authenticated `/api/v1/tools`, or `getHiveEndpointSchema`; do not hardcode stale schemas.
5. Preserve provider, freshness, warning, and runtime-status metadata in the application's own response shape.

## Notes

- `hive-mcp-client@0.1.5` is published on npm; install it with `npm install hive-mcp-client`.
- REST remains the documented production fallback for registry-based installs, non-TypeScript services, and constrained runtimes.

## Runtime status handling

Hive uses `ok`, `missing_key`, `plan_required`, `rate_limited`, `degraded`, `failing`.
A non-`ok` state means the tool exists but the runtime cannot complete that call
right now. Do not hide or remove the tool.

## Source of truth

The executable MCP skill pack ships with the Hive MCP package. This public file
is a website mirror for agent discovery. Runtime metadata is available at
`https://mcp.hiveintelligence.xyz/mcp` via `hive://skills`. Installable skills are mirrored at
https://github.com/hive-intel/hive-skills; install the full pack with
`npx skills add hive-intel/hive-skills`.