Hive Intelligence MCP

{'type': 'object', 'properties': {'chain': {'type': 'string', 'maxLength': 40, 'description': 'Chain name or EVM chain id, for example "eth", "bsc", "8453", or "solana". Defaults to eth for 0x addresses; Solana is auto-detected.'}, 'address': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Required. Token contract address (0x… for EVM, base58 for Solana).'}, 'response_format': {'enum': ['concise', 'detailed', 'json', 'markdown'], 'type': 'string', 'description': 'concise (default) returns the trimmed essentials; detailed returns the full provider payload. json and markdown, the platform-wide values every other tool advertises, are accepted and treated as concise.'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['source_receipt'], 'properties': {'note': {'type': 'string'}, 'chain': {'type': 'string'}, 'address': {'type': 'string'}, 'risk_flags': {'type': 'object', 'description': "Raw provider risk datapoints; '1' means flagged. A missing key means the provider did not report that signal, not that it passed.", 'additionalProperties': True}, 'token_name': {'type': 'string'}, 'holder_count': {}, 'source_receipt': {'type': 'object', 'required': ['provider', 'runtime_status', 'fetched_at'], 'properties': {'provider': {'type': 'string'}, 'fetched_at': {'type': 'string', 'format': 'date-time'}, 'runtime_status': {'enum': ['ok', 'invalid_input', 'missing_key', 'plan_required', 'rate_limited', 'degraded', 'failing'], 'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'endpoint': {'type': 'string', 'description': 'The name of the endpoint to get the schema for.'}, 'endpoint_name': {'type': 'string', 'description': "Alias for 'endpoint', accepted for symmetry with invoke_api_endpoint. Provide one of the two."}, 'response_format': {'enum': ['json', 'markdown'], 'type': 'string', 'description': "Output format: 'json' for structured data (default) or 'markdown' for human-readable text."}}, 'additionalProperties': True}

{'type': 'object', 'required': ['_hive'], 'properties': {'name': {'type': 'string'}, '_hive': {'type': 'object', 'required': ['receipt_id', 'receipt_version', 'server_version', 'build_sha', 'digest_algorithm', 'input_digest', 'result_digest', 'provider', 'tool', 'category', 'runtime_status', 'fetched_at', 'observed_at', 'cache_age_ms', 'duration_ms', 'cache_status', 'source', 'origin_source', 'truncated', 'warnings'], 'properties': {'tool': {'type': 'string'}, 'cause': {'type': 'string', 'description': 'Errors only: what actually happened, written for the model.'}, 'source': {'enum': ['live', 'cached', 'fallback', 'unavailable'], 'type': 'string'}, 'doc_url': {'type': 'string', 'description': 'Docs anchor for the error code (errors only).'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'provider': {'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'build_sha': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'sanitized': {'type': 'boolean', 'description': 'Present and true when instruction-shaped provider text was neutralized before reaching agent context.'}, 'truncated': {'type': 'boolean'}, 'fetched_at': {'type': 'string', 'format': 'date-time'}, 'receipt_id': {'type': 'string', 'format': 'uuid', 'description': 'Unique runtime receipt for this Hive tool call. Include it when reporting or debugging the evidence.'}, 'credit_cost': {'enum': [0, 1], 'type': 'integer', 'description': 'Static credit price of this tool: 0 for discovery tools and free writes, 1 for everything else. Present when the calling lane bills.'}, 'duration_ms': {'type': 'number'}, 'next_action': {'type': 'string', 'description': 'Errors only: the one useful next step. Follow it instead of retrying the same call unchanged.'}, 'observed_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}], 'description': "When Hive first observed this response. On a cache hit this is the original cache-population time; it is not necessarily the upstream datum's event time."}, 'cache_age_ms': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}], 'description': "Milliseconds since Hive first observed the response. Zero means newly retrieved from the provider, not that the provider's underlying datum is current."}, 'cache_status': {'enum': ['miss', 'hit', 'bypass', 'unknown'], 'type': 'string'}, 'credits_used': {'type': 'integer', 'minimum': 0, 'description': 'Credits actually debited for this call: 0 when validation or a gate stopped it, credit_cost once the provider was reached.'}, 'input_digest': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': 'SHA-256 self-check of canonical JSON arguments. It is not a server signature.'}, 'fallback_used': {'type': 'boolean', 'description': 'Present and true when a task-route fallback tool produced this response after the primary returned failing/missing_key. provider/tool name the actual executed source.'}, 'origin_source': {'anyOf': [{'enum': ['live', 'fallback'], 'type': 'string'}, {'type': 'null'}], 'description': 'Original upstream tier. Preserved as fallback when a fallback-tier response is later served from cache.'}, 'result_digest': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': 'SHA-256 self-check of the canonical returned payload after Hive result normalization and before the top-level _hive receipt is attached.'}, 'runtime_status': {'enum': ['ok', 'invalid_input', 'missing_key', 'plan_required', 'rate_limited', 'degraded', 'failing'], 'type': 'string'}, 'server_version': {'type': 'string'}, 'receipt_version': {'type': 'string', 'const': '1.0'}, 'digest_algorithm': {'type': 'string', 'const': 'sha256'}, 'credits_remaining': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}], 'description': 'Balance after this call: keyed credits, or keyless calls left today. null for unlimited plans; absent when the lane has no notion.'}}, 'additionalProperties': False}, 'title': {'type': 'string'}, 'category': {'type': 'string'}, 'provider': {'type': 'string'}, 'toolsets': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'kind': {'type': 'string'}, 'label': {'type': 'string'}}}}, 'operation': {'enum': ['read', 'write'], 'type': 'string'}, 'annotations': {'type': 'object', 'additionalProperties': True}, 'callPattern': {'type': 'string'}, 'description': {'type': 'string'}, 'inputSchema': {'type': 'object', 'additionalProperties': True}, 'outputSchema': {'type': 'object', 'additionalProperties': True}, 'runtimeStatuses': {'type': 'array', 'items': {'type': 'string'}}, 'runtimeStatusSemantics': {'type': 'object', 'additionalProperties': True}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'chain': {'type': 'string', 'maxLength': 40, 'description': 'Chain name for the contract-address variant, for example "eth", "base", "bsc", or "solana".'}, 'token': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'CoinGecko coin id or ticker symbol, for example "bitcoin" or "BTC". Omit when passing chain + address.'}, 'address': {'type': 'string', 'maxLength': 100, 'description': 'Token contract address; requires chain.'}, 'vs_currency': {'type': 'string', 'maxLength': 20, 'description': 'Quote currency. Default "usd".'}, 'response_format': {'enum': ['concise', 'detailed', 'json', 'markdown'], 'type': 'string', 'description': 'concise (default) returns the trimmed essentials; detailed returns the full provider payload. json and markdown, the platform-wide values every other tool advertises, are accepted and treated as concise.'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['source_receipt'], 'properties': {'price': {'type': 'number'}, 'token': {'type': 'string'}, 'market_cap': {'type': 'number'}, 'vs_currency': {'type': 'string'}, 'source_receipt': {'type': 'object', 'required': ['provider', 'runtime_status', 'fetched_at'], 'properties': {'provider': {'type': 'string'}, 'fetched_at': {'type': 'string', 'format': 'date-time'}, 'runtime_status': {'enum': ['ok', 'invalid_input', 'missing_key', 'plan_required', 'rate_limited', 'degraded', 'failing'], 'type': 'string'}}, 'additionalProperties': True}, 'change_24h_percent': {'type': 'number'}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'chain': {'type': 'string', 'maxLength': 40, 'description': 'Chain name, for example "eth", "base", "arbitrum", or "solana". Defaults to eth for 0x addresses; Solana is auto-detected.'}, 'address': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Required. Wallet address (0x… for EVM, base58 for Solana).'}, 'response_format': {'enum': ['concise', 'detailed', 'json', 'markdown'], 'type': 'string', 'description': 'concise (default) returns the trimmed essentials; detailed returns the full provider payload. json and markdown, the platform-wide values every other tool advertises, are accepted and treated as concise.'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['source_receipt'], 'properties': {'note': {'type': 'string'}, 'chain': {'type': 'string'}, 'tokens': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}, 'description': 'Holdings; truncated in concise mode when note is present.'}, 'address': {'type': 'string'}, 'token_count': {'type': 'number', 'description': 'Total holdings found, which may exceed tokens.length.'}, 'source_receipt': {'type': 'object', 'required': ['provider', 'runtime_status', 'fetched_at'], 'properties': {'provider': {'type': 'string'}, 'fetched_at': {'type': 'string', 'format': 'date-time'}, 'runtime_status': {'enum': ['ok', 'invalid_input', 'missing_key', 'plan_required', 'rate_limited', 'degraded', 'failing'], 'type': 'string'}}, 'additionalProperties': True}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'args': {'type': 'object', 'description': 'The arguments to pass to the endpoint. This must match the schema returned by the `get_api_endpoint_schema` tool. You may also pass arguments as flat top-level keys alongside endpoint_name.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'endpoint': {'type': 'string', 'description': "Alias for 'endpoint_name', accepted by both root invokers. Provide one of the two."}, 'endpoint_name': {'type': 'string', 'description': 'The name of the endpoint to invoke.'}, 'response_format': {'enum': ['json', 'markdown'], 'type': 'string', 'description': "Output format: 'json' for structured data (default) or 'markdown' for human-readable text."}}, 'additionalProperties': {}}

{'type': 'object', 'required': ['_hive'], 'properties': {'data': {'description': 'Provider data payload when the response uses a data wrapper.'}, '_hive': {'type': 'object', 'required': ['receipt_id', 'receipt_version', 'server_version', 'build_sha', 'digest_algorithm', 'input_digest', 'result_digest', 'provider', 'tool', 'category', 'runtime_status', 'fetched_at', 'observed_at', 'cache_age_ms', 'duration_ms', 'cache_status', 'source', 'origin_source', 'truncated', 'warnings'], 'properties': {'tool': {'type': 'string'}, 'cause': {'type': 'string', 'description': 'Errors only: what actually happened, written for the model.'}, 'source': {'enum': ['live', 'cached', 'fallback', 'unavailable'], 'type': 'string'}, 'doc_url': {'type': 'string', 'description': 'Docs anchor for the error code (errors only).'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'provider': {'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'build_sha': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'sanitized': {'type': 'boolean', 'description': 'Present and true when instruction-shaped provider text was neutralized before reaching agent context.'}, 'truncated': {'type': 'boolean'}, 'fetched_at': {'type': 'string', 'format': 'date-time'}, 'receipt_id': {'type': 'string', 'format': 'uuid', 'description': 'Unique runtime receipt for this Hive tool call. Include it when reporting or debugging the evidence.'}, 'credit_cost': {'enum': [0, 1], 'type': 'integer', 'description': 'Static credit price of this tool: 0 for discovery tools and free writes, 1 for everything else. Present when the calling lane bills.'}, 'duration_ms': {'type': 'number'}, 'next_action': {'type': 'string', 'description': 'Errors only: the one useful next step. Follow it instead of retrying the same call unchanged.'}, 'observed_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}], 'description': "When Hive first observed this response. On a cache hit this is the original cache-population time; it is not necessarily the upstream datum's event time."}, 'cache_age_ms': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}], 'description': "Milliseconds since Hive first observed the response. Zero means newly retrieved from the provider, not that the provider's underlying datum is current."}, 'cache_status': {'enum': ['miss', 'hit', 'bypass', 'unknown'], 'type': 'string'}, 'credits_used': {'type': 'integer', 'minimum': 0, 'description': 'Credits actually debited for this call: 0 when validation or a gate stopped it, credit_cost once the provider was reached.'}, 'input_digest': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': 'SHA-256 self-check of canonical JSON arguments. It is not a server signature.'}, 'fallback_used': {'type': 'boolean', 'description': 'Present and true when a task-route fallback tool produced this response after the primary returned failing/missing_key. provider/tool name the actual executed source.'}, 'origin_source': {'anyOf': [{'enum': ['live', 'fallback'], 'type': 'string'}, {'type': 'null'}], 'description': 'Original upstream tier. Preserved as fallback when a fallback-tier response is later served from cache.'}, 'result_digest': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': 'SHA-256 self-check of the canonical returned payload after Hive result normalization and before the top-level _hive receipt is attached.'}, 'runtime_status': {'enum': ['ok', 'invalid_input', 'missing_key', 'plan_required', 'rate_limited', 'degraded', 'failing'], 'type': 'string'}, 'server_version': {'type': 'string'}, 'receipt_version': {'type': 'string', 'const': '1.0'}, 'digest_algorithm': {'type': 'string', 'const': 'sha256'}, 'credits_remaining': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}], 'description': 'Balance after this call: keyed credits, or keyless calls left today. null for unlimited plans; absent when the lane has no notion.'}}, 'additionalProperties': False}, '_type': {'type': 'string'}, 'error': {'type': 'string'}, 'items': {'type': 'array', 'items': {}, 'description': 'Array result when a provider returns a top-level list.'}, 'result': {'description': 'Provider result payload when the response uses a result wrapper.'}, 'status': {'description': 'Provider-reported status. Type varies by provider (string, boolean, or number), so no type constraint is applied.'}, 'message': {'type': 'string'}, '_degraded': {'type': 'string'}, '_metadata': {'type': 'object', 'additionalProperties': True}, '_provider': {'type': 'string'}, '_truncated': {'type': 'boolean'}, '_pagination': {'type': 'object', 'properties': {'has_more': {'type': 'boolean'}, 'returned': {'type': 'number'}, 'total_available': {'type': 'number'}}, 'additionalProperties': True}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'args': {'type': 'object', 'description': 'The arguments to pass to the endpoint. This must match the schema returned by the `get_api_endpoint_schema` tool. You may also pass arguments as flat top-level keys alongside endpoint_name.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'endpoint': {'type': 'string', 'description': "Alias for 'endpoint_name', accepted by both root invokers. Provide one of the two."}, 'endpoint_name': {'type': 'string', 'description': 'The name of the endpoint to invoke.'}, 'response_format': {'enum': ['json', 'markdown'], 'type': 'string', 'description': "Output format: 'json' for structured data (default) or 'markdown' for human-readable text."}}, 'additionalProperties': {}}

{'type': 'object', 'required': ['_hive'], 'properties': {'data': {'description': 'Provider data payload when the response uses a data wrapper.'}, '_hive': {'type': 'object', 'required': ['receipt_id', 'receipt_version', 'server_version', 'build_sha', 'digest_algorithm', 'input_digest', 'result_digest', 'provider', 'tool', 'category', 'runtime_status', 'fetched_at', 'observed_at', 'cache_age_ms', 'duration_ms', 'cache_status', 'source', 'origin_source', 'truncated', 'warnings'], 'properties': {'tool': {'type': 'string'}, 'cause': {'type': 'string', 'description': 'Errors only: what actually happened, written for the model.'}, 'source': {'enum': ['live', 'cached', 'fallback', 'unavailable'], 'type': 'string'}, 'doc_url': {'type': 'string', 'description': 'Docs anchor for the error code (errors only).'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'provider': {'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'build_sha': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'sanitized': {'type': 'boolean', 'description': 'Present and true when instruction-shaped provider text was neutralized before reaching agent context.'}, 'truncated': {'type': 'boolean'}, 'fetched_at': {'type': 'string', 'format': 'date-time'}, 'receipt_id': {'type': 'string', 'format': 'uuid', 'description': 'Unique runtime receipt for this Hive tool call. Include it when reporting or debugging the evidence.'}, 'credit_cost': {'enum': [0, 1], 'type': 'integer', 'description': 'Static credit price of this tool: 0 for discovery tools and free writes, 1 for everything else. Present when the calling lane bills.'}, 'duration_ms': {'type': 'number'}, 'next_action': {'type': 'string', 'description': 'Errors only: the one useful next step. Follow it instead of retrying the same call unchanged.'}, 'observed_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}], 'description': "When Hive first observed this response. On a cache hit this is the original cache-population time; it is not necessarily the upstream datum's event time."}, 'cache_age_ms': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}], 'description': "Milliseconds since Hive first observed the response. Zero means newly retrieved from the provider, not that the provider's underlying datum is current."}, 'cache_status': {'enum': ['miss', 'hit', 'bypass', 'unknown'], 'type': 'string'}, 'credits_used': {'type': 'integer', 'minimum': 0, 'description': 'Credits actually debited for this call: 0 when validation or a gate stopped it, credit_cost once the provider was reached.'}, 'input_digest': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': 'SHA-256 self-check of canonical JSON arguments. It is not a server signature.'}, 'fallback_used': {'type': 'boolean', 'description': 'Present and true when a task-route fallback tool produced this response after the primary returned failing/missing_key. provider/tool name the actual executed source.'}, 'origin_source': {'anyOf': [{'enum': ['live', 'fallback'], 'type': 'string'}, {'type': 'null'}], 'description': 'Original upstream tier. Preserved as fallback when a fallback-tier response is later served from cache.'}, 'result_digest': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': 'SHA-256 self-check of the canonical returned payload after Hive result normalization and before the top-level _hive receipt is attached.'}, 'runtime_status': {'enum': ['ok', 'invalid_input', 'missing_key', 'plan_required', 'rate_limited', 'degraded', 'failing'], 'type': 'string'}, 'server_version': {'type': 'string'}, 'receipt_version': {'type': 'string', 'const': '1.0'}, 'digest_algorithm': {'type': 'string', 'const': 'sha256'}, 'credits_remaining': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}], 'description': 'Balance after this call: keyed credits, or keyless calls left today. null for unlimited plans; absent when the lane has no notion.'}}, 'additionalProperties': False}, '_type': {'type': 'string'}, 'error': {'type': 'string'}, 'items': {'type': 'array', 'items': {}, 'description': 'Array result when a provider returns a top-level list.'}, 'result': {'description': 'Provider result payload when the response uses a result wrapper.'}, 'status': {'description': 'Provider-reported status. Type varies by provider (string, boolean, or number), so no type constraint is applied.'}, 'message': {'type': 'string'}, '_degraded': {'type': 'string'}, '_metadata': {'type': 'object', 'additionalProperties': True}, '_provider': {'type': 'string'}, '_truncated': {'type': 'boolean'}, '_pagination': {'type': 'object', 'properties': {'has_more': {'type': 'boolean'}, 'returned': {'type': 'number'}, 'total_available': {'type': 'number'}}, 'additionalProperties': True}}, 'additionalProperties': True}

{'type': 'object', 'properties': {'limit': {'type': 'integer', 'maximum': 50, 'minimum': 1, 'description': 'Maximum tools to return. Default 20.'}, 'query': {'type': 'string', 'maxLength': 512, 'description': 'Search text matched against tool name, title, category, provider, and summary.'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from the previous response.'}, 'detail': {'enum': ['compact', 'standard', 'full'], 'type': 'string', 'description': 'Toolset detail level. Defaults to compact. Use full only when the task output schema is needed.'}, 'category': {'type': 'string', 'maxLength': 128, 'description': 'Optional category filter, for example Portfolio & Wallet.'}, 'provider': {'type': 'string', 'maxLength': 128, 'description': 'Optional provider filter such as CoinGecko, Moralis, Tenderly, Helius, GoPlus, CCXT, Alchemy, DeFiLlama, Hyperliquid, or Open Data Fetch.'}, 'route_id': {'type': 'string', 'maxLength': 100, 'description': "Optional exact task-shaped route id. Use the matched route's ordered calls and conditional fallbacks instead of choosing from the coverage catalog."}, 'toolset_id': {'type': 'string', 'maxLength': 100, 'description': 'Optional exact canonical task toolset id. Use this after an initial compact result to inspect one workflow.'}, 'toolset_limit': {'type': 'integer', 'maximum': 5, 'minimum': 1, 'description': 'Maximum matching task toolsets to return. Default 3, max 5.'}, 'evidence_phase': {'type': 'string', 'maxLength': 100, 'description': 'Optional exact workflow evidence phase. Supported values: activity, alerts, approvals, assets, authenticity, balances, blocks, bridges, derivatives, discovery, enrichment, evidence, fees, funding, gas, history, holders, identity, infrastructure, liquidity, logs, market, markets, memory, monitoring, ohlcv, owners, positions, reports, risk, routing, sales, schema, simulation, stablecoins, trades, transactions, tvl, yields.'}, 'toolset_cursor': {'type': 'string', 'description': 'Pagination cursor for task toolset matches.'}, 'response_format': {'enum': ['json', 'markdown'], 'type': 'string', 'description': "Output format: 'json' for structured data (default) or 'markdown' for human-readable text."}}, 'additionalProperties': False}

{'type': 'object', 'required': ['_hive'], 'properties': {'_hive': {'type': 'object', 'required': ['receipt_id', 'receipt_version', 'server_version', 'build_sha', 'digest_algorithm', 'input_digest', 'result_digest', 'provider', 'tool', 'category', 'runtime_status', 'fetched_at', 'observed_at', 'cache_age_ms', 'duration_ms', 'cache_status', 'source', 'origin_source', 'truncated', 'warnings'], 'properties': {'tool': {'type': 'string'}, 'cause': {'type': 'string', 'description': 'Errors only: what actually happened, written for the model.'}, 'source': {'enum': ['live', 'cached', 'fallback', 'unavailable'], 'type': 'string'}, 'doc_url': {'type': 'string', 'description': 'Docs anchor for the error code (errors only).'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'provider': {'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'build_sha': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'sanitized': {'type': 'boolean', 'description': 'Present and true when instruction-shaped provider text was neutralized before reaching agent context.'}, 'truncated': {'type': 'boolean'}, 'fetched_at': {'type': 'string', 'format': 'date-time'}, 'receipt_id': {'type': 'string', 'format': 'uuid', 'description': 'Unique runtime receipt for this Hive tool call. Include it when reporting or debugging the evidence.'}, 'credit_cost': {'enum': [0, 1], 'type': 'integer', 'description': 'Static credit price of this tool: 0 for discovery tools and free writes, 1 for everything else. Present when the calling lane bills.'}, 'duration_ms': {'type': 'number'}, 'next_action': {'type': 'string', 'description': 'Errors only: the one useful next step. Follow it instead of retrying the same call unchanged.'}, 'observed_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}], 'description': "When Hive first observed this response. On a cache hit this is the original cache-population time; it is not necessarily the upstream datum's event time."}, 'cache_age_ms': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}], 'description': "Milliseconds since Hive first observed the response. Zero means newly retrieved from the provider, not that the provider's underlying datum is current."}, 'cache_status': {'enum': ['miss', 'hit', 'bypass', 'unknown'], 'type': 'string'}, 'credits_used': {'type': 'integer', 'minimum': 0, 'description': 'Credits actually debited for this call: 0 when validation or a gate stopped it, credit_cost once the provider was reached.'}, 'input_digest': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': 'SHA-256 self-check of canonical JSON arguments. It is not a server signature.'}, 'fallback_used': {'type': 'boolean', 'description': 'Present and true when a task-route fallback tool produced this response after the primary returned failing/missing_key. provider/tool name the actual executed source.'}, 'origin_source': {'anyOf': [{'enum': ['live', 'fallback'], 'type': 'string'}, {'type': 'null'}], 'description': 'Original upstream tier. Preserved as fallback when a fallback-tier response is later served from cache.'}, 'result_digest': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': 'SHA-256 self-check of the canonical returned payload after Hive result normalization and before the top-level _hive receipt is attached.'}, 'runtime_status': {'enum': ['ok', 'invalid_input', 'missing_key', 'plan_required', 'rate_limited', 'degraded', 'failing'], 'type': 'string'}, 'server_version': {'type': 'string'}, 'receipt_version': {'type': 'string', 'const': '1.0'}, 'digest_algorithm': {'type': 'string', 'const': 'sha256'}, 'credits_remaining': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}], 'description': 'Balance after this call: keyed credits, or keyless calls left today. null for unlimited plans; absent when the lane has no notion.'}}, 'additionalProperties': False}, 'query': {'type': 'string'}, 'tools': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'title': {'type': 'string'}, 'summary': {'type': 'string'}, 'category': {'type': 'string'}, 'material': {'type': 'boolean', 'description': 'True when the call costs one credit (or one keyless call); false for free discovery tools and free writes.'}, 'provider': {'type': 'string'}, 'readOnly': {'type': 'boolean'}, 'operation': {'enum': ['read', 'write'], 'type': 'string'}, 'callableVia': {'enum': ['invoke_api_endpoint', 'invoke_stateful_endpoint'], 'type': 'string'}, 'credit_cost': {'enum': [0, 1], 'type': 'integer'}, 'availability': {'enum': ['ok', 'degraded', 'missing_key', 'failing'], 'type': 'string', 'description': "Live availability of this tool's provider from the cached health snapshot. missing_key/failing tools are ranked last and return runtime_status, not data."}, 'inputRequired': {'type': 'array', 'items': {'type': 'string'}}, 'hasOutputSchema': {'type': 'boolean'}, 'availability_note': {'type': 'string'}}}}, 'category': {'type': 'string'}, 'provider': {'type': 'string'}, 'route_id': {'type': 'string'}, 'toolsets': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string'}, 'kind': {'type': 'string'}, 'tags': {'type': 'array', 'items': {'type': 'string'}}, 'label': {'type': 'string'}, 'routes': {'type': 'array', 'items': {'type': 'object', 'additionalProperties': True}}, 'outcome': {'type': 'string'}, 'purpose': {'type': 'string'}, 'resource': {'type': 'string'}, 'providers': {'type': 'array', 'items': {'type': 'string'}}, 'outputSchema': {'type': 'object', 'additionalProperties': True}, 'coverageCatalog': {'type': 'object', 'additionalProperties': True}, 'executionPolicy': {'type': 'object', 'additionalProperties': True}, 'runtimeStatuses': {'type': 'array', 'items': {'type': 'string'}}, 'availability_note': {'type': 'string'}, 'requiredIdentifiers': {'type': 'array', 'items': {'type': 'string'}}, 'providerAvailability': {'type': 'object', 'description': 'Present only when a provider in this toolset is not ok: provider name -> degraded | missing_key | failing.', 'additionalProperties': True}}}}, 'pagination': {'type': 'object', 'properties': {'limit': {'type': 'number'}, 'total': {'type': 'number'}, 'cursor': {'type': 'string'}, 'has_more': {'type': 'boolean'}, 'returned': {'type': 'number'}, 'next_cursor': {'type': 'string'}}}, 'toolset_detail': {'enum': ['compact', 'standard', 'full'], 'type': 'string'}, 'toolset_pagination': {'type': 'object', 'properties': {'limit': {'type': 'number'}, 'total': {'type': 'number'}, 'cursor': {'type': 'string'}, 'has_more': {'type': 'boolean'}, 'returned': {'type': 'number'}, 'next_cursor': {'type': 'string'}}}}}

{'type': 'object', 'required': ['task_toolset_id', 'result'], 'properties': {'result': {'type': 'object', 'description': "The proposed task result envelope. Each receipt.calls entry must be copied exactly from a material call's _hive object.", 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'response_format': {'enum': ['json', 'markdown'], 'type': 'string', 'description': "Output format: 'json' for structured data (default) or 'markdown' for human-readable text."}, 'task_toolset_id': {'type': 'string', 'description': 'Canonical task toolset id returned by search_tools.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['valid', 'task_toolset_id', 'route_id', 'call_count', 'receipt_ids', 'errors', 'warnings', '_hive'], 'properties': {'_hive': {'type': 'object', 'required': ['receipt_id', 'receipt_version', 'server_version', 'build_sha', 'digest_algorithm', 'input_digest', 'result_digest', 'provider', 'tool', 'category', 'runtime_status', 'fetched_at', 'observed_at', 'cache_age_ms', 'duration_ms', 'cache_status', 'source', 'origin_source', 'truncated', 'warnings'], 'properties': {'tool': {'type': 'string'}, 'cause': {'type': 'string', 'description': 'Errors only: what actually happened, written for the model.'}, 'source': {'enum': ['live', 'cached', 'fallback', 'unavailable'], 'type': 'string'}, 'doc_url': {'type': 'string', 'description': 'Docs anchor for the error code (errors only).'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'provider': {'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'build_sha': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'sanitized': {'type': 'boolean', 'description': 'Present and true when instruction-shaped provider text was neutralized before reaching agent context.'}, 'truncated': {'type': 'boolean'}, 'fetched_at': {'type': 'string', 'format': 'date-time'}, 'receipt_id': {'type': 'string', 'format': 'uuid', 'description': 'Unique runtime receipt for this Hive tool call. Include it when reporting or debugging the evidence.'}, 'credit_cost': {'enum': [0, 1], 'type': 'integer', 'description': 'Static credit price of this tool: 0 for discovery tools and free writes, 1 for everything else. Present when the calling lane bills.'}, 'duration_ms': {'type': 'number'}, 'next_action': {'type': 'string', 'description': 'Errors only: the one useful next step. Follow it instead of retrying the same call unchanged.'}, 'observed_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}], 'description': "When Hive first observed this response. On a cache hit this is the original cache-population time; it is not necessarily the upstream datum's event time."}, 'cache_age_ms': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}], 'description': "Milliseconds since Hive first observed the response. Zero means newly retrieved from the provider, not that the provider's underlying datum is current."}, 'cache_status': {'enum': ['miss', 'hit', 'bypass', 'unknown'], 'type': 'string'}, 'credits_used': {'type': 'integer', 'minimum': 0, 'description': 'Credits actually debited for this call: 0 when validation or a gate stopped it, credit_cost once the provider was reached.'}, 'input_digest': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': 'SHA-256 self-check of canonical JSON arguments. It is not a server signature.'}, 'fallback_used': {'type': 'boolean', 'description': 'Present and true when a task-route fallback tool produced this response after the primary returned failing/missing_key. provider/tool name the actual executed source.'}, 'origin_source': {'anyOf': [{'enum': ['live', 'fallback'], 'type': 'string'}, {'type': 'null'}], 'description': 'Original upstream tier. Preserved as fallback when a fallback-tier response is later served from cache.'}, 'result_digest': {'type': 'string', 'pattern': '^[a-f0-9]{64}$', 'description': 'SHA-256 self-check of the canonical returned payload after Hive result normalization and before the top-level _hive receipt is attached.'}, 'runtime_status': {'enum': ['ok', 'invalid_input', 'missing_key', 'plan_required', 'rate_limited', 'degraded', 'failing'], 'type': 'string'}, 'server_version': {'type': 'string'}, 'receipt_version': {'type': 'string', 'const': '1.0'}, 'digest_algorithm': {'type': 'string', 'const': 'sha256'}, 'credits_remaining': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}], 'description': 'Balance after this call: keyed credits, or keyless calls left today. null for unlimited plans; absent when the lane has no notion.'}}, 'additionalProperties': False}, 'valid': {'type': 'boolean'}, 'errors': {'type': 'array', 'items': {'type': 'object'}}, 'route_id': {'type': 'string'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'call_count': {'type': 'number'}, 'receipt_ids': {'type': 'array', 'items': {'type': 'string'}}, 'task_toolset_id': {'type': 'string'}}, 'additionalProperties': False}