---
name: hive-tool-discovery
description: "Use this skill only when the exact Hive MCP tool, task toolset, provider, endpoint name, schema, or argument shape is unknown and hive-query routing was not enough. Discover first with Hive resources and search_tools, then inspect schema before any invoke_api_endpoint call."
license: MIT
metadata:
  package: "@hiveintelligence/agent-skills"
  category: "discovery"
  requires_network: "true"
version: 1.0.0
---

# Tool Discovery

Use search_tools, hive://toolsets, schema lookup, and invoke_api_endpoint correctly.

## Trigger

Use this skill only when the exact Hive MCP tool, task toolset, provider, endpoint name, schema, or argument shape is unknown and hive-query routing was not enough. Discover first with Hive resources and search_tools, then inspect schema before any invoke_api_endpoint call.

## Use when

- unknown tool
- schema
- discovery
- search tools
- invoke endpoint
- category tool

## Source

Canonical source path: `agent-skills/packs/hive-tool-discovery/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. Read `hive://toolsets` or call `search_tools` to confirm the task.
2. Ask for any missing required identifier before execution.
3. Call `get_api_endpoint_schema` before invoking an exact endpoint.
4. Call `invoke_api_endpoint` with schema-valid arguments.
5. Report freshness, source, warnings, and runtime status.

## 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`.