Endpoints: 28,729MCP servers: 18,413Payout addresses: 2,071Paid calls: 1,562Letters: 14Defects: 1,336counted 2 min ago
teppi

Server definition

Hash
sha256:96fad5dd2df8b9a08b0aea3fb070d0af7299a5c140259766654f83264fd0a3cb
What it is
What a remote MCP server returned when asked what it offers: 8 tools

The blob, as servednamed by its sha256

{ "instructions": "Hive serves live crypto market data to AI agents over a compact 8-tool root. Loop: search_tools -> get_api_endpoint_schema -> invoke_api_endpoint for reads (invoke_stateful_endpoint only after explicit user approval; validate_task_result before structured answers). Every material response carries a _hive receipt (provider, fetched_at, runtime_status, _hive.receipt_id); cite it when answering. For the three dominant intents call the hero tools directly: get_token_price, check_token_safety, get_wallet_portfolio (response_format \"concise\" default, \"detailed\" available). Degraded providers are reported, not hidden: search_tools marks each tool's availability, and unavailable tools return runtime_status with cause and next_action instead of data. Follow next_action; never retry an unchanged failing call in a loop. Discovery is free and cheap: resources hive://toolsets, hive://providers, hive://tools; the 525-tool catalog stays reachable through search_tools or scoped category endpoints. Use limit and cursor on search_tools, and limit/page/per_page/offset on data endpoints, to keep responses small; a material execution costs 1 credit on the hosted service.", "tools": [ { "description": "Token security screen for a contract address: honeypot, taxes, ownership, and related GoPlus risk datapoints. EVM chains use chain + address; Solana addresses are detected automatically.", "inputSchema": { "additionalProperties": true, "properties": { "address": { "description": "Required. Token contract address (0x… for EVM, base58 for Solana).", "maxLength": 100, "minLength": 1, "type": "string" }, "chain": { "description": "Chain name or EVM chain id, for example \"eth\", \"bsc\", \"8453\", or \"solana\". Defaults to eth for 0x addresses; Solana is auto-detected.", "maxLength": 40, "type": "string" }, "response_format": { "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.", "enum": [ "concise", "detailed", "json", "markdown" ], "type": "string" } }, "type": "object" }, "name": "check_token_safety", "outputSchema": { "additionalProperties": true, "properties": { "address": { "type": "string" }, "chain": { "type": "string" }, "holder_count": {}, "note": { "type": "string" }, "risk_flags": { "additionalProperties": true, "description": "Raw provider risk datapoints; '1' means flagged. A missing key means the provider did not report that signal, not that it passed.", "type": "object" }, "source_receipt": { "additionalProperties": true, "properties": { "fetched_at": { "format": "date-time", "type": "string" }, "provider": { "type": "string" }, "runtime_status": { "enum": [ "ok", "invalid_input", "missing_key", "plan_required", "rate_limited", "degraded", "failing" ], "type": "string" } }, "required": [ "provider", "runtime_status", "fetched_at" ], "type": "object" }, "token_name": { "type": "string" } }, "required": [ "source_receipt" ], "type": "object" } }, { "description": "Returns the full input schema, operation type, and correct root invoker for any Hive tool by name. Tool names come from search_tools; inspect this contract before execution.", "inputSchema": { "additionalProperties": true, "properties": { "endpoint": { "description": "The name of the endpoint to get the schema for.", "type": "string" }, "endpoint_name": { "description": "Alias for 'endpoint', accepted for symmetry with invoke_api_endpoint. Provide one of the two.", "type": "string" }, "response_format": { "description": "Output format: 'json' for structured data (default) or 'markdown' for human-readable text.", "enum": [ "json", "markdown" ], "type": "string" } }, "type": "object" }, "name": "get_api_endpoint_schema", "outputSchema": { "additionalProperties": true, "properties": { "_hive": { "additionalProperties": false, "properties": { "build_sha": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cache_age_ms": { "anyOf": [ { "minimum": 0, "type": "number" }, { "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" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cause": { "description": "Errors only: what actually happened, written for the model.", "type": "string" }, "credit_cost": { "description": "Static credit price of this tool: 0 for discovery tools and free writes, 1 for everything else. Present when the calling lane bills.", "enum": [ 0, 1 ], "type": "integer" }, "credits_remaining": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "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." }, "credits_used": { "description": "Credits actually debited for this call: 0 when validation or a gate stopped it, credit_cost once the provider was reached.", "minimum": 0, "type": "integer" }, "digest_algorithm": { "const": "sha256", "type": "string" }, "doc_url": { "description": "Docs anchor for the error code (errors only).", "type": "string" }, "duration_ms": { "type": "number" }, "fallback_used": { "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.", "type": "boolean" }, "fetched_at": { "format": "date-time", "type": "string" }, "input_digest": { "description": "SHA-256 self-check of canonical JSON arguments. It is not a server signature.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "next_action": { "description": "Errors only: the one useful next step. Follow it instead of retrying the same call unchanged.", "type": "string" }, "observed_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "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." }, "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." }, "provider": { "type": "string" }, "receipt_id": { "description": "Unique runtime receipt for this Hive tool call. Include it when reporting or debugging the evidence.", "format": "uuid", "type": "string" }, "receipt_version": { "const": "1.0", "type": "string" }, "result_digest": { "description": "SHA-256 self-check of the canonical returned payload after Hive result normalization and before the top-level _hive receipt is attached.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "runtime_status": { "enum": [ "ok", "invalid_input", "missing_key", "plan_required", "rate_limited", "degraded", "failing" ], "type": "string" }, "sanitized": { "description": "Present and true when instruction-shaped provider text was neutralized before reaching agent context.", "type": "boolean" }, "server_version": { "type": "string" }, "source": { "enum": [ "live", "cached", "fallback", "unavailable" ], "type": "string" }, "tool": { "type": "string" }, "truncated": { "type": "boolean" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "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" ], "type": "object" }, "annotations": { "additionalProperties": true, "type": "object" }, "callPattern": { "type": "string" }, "category": { "type": "string" }, "description": { "type": "string" }, "inputSchema": { "additionalProperties": true, "type": "object" }, "name": { "type": "string" }, "operation": { "enum": [ "read", "write" ], "type": "string" }, "outputSchema": { "additionalProperties": true, "type": "object" }, "provider": { "type": "string" }, "runtimeStatusSemantics": { "additionalProperties": true, "type": "object" }, "runtimeStatuses": { "items": { "type": "string" }, "type": "array" }, "title": { "type": "string" }, "toolsets": { "items": { "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "label": { "type": "string" } }, "type": "object" }, "type": "array" } }, "required": [ "_hive" ], "type": "object" } }, { "description": "Current price for one token. Pass token as a CoinGecko id or symbol (\"bitcoin\", \"BTC\"), or pass chain + address for a specific contract. Returns price, market cap, and 24h change with provider provenance.", "inputSchema": { "additionalProperties": true, "properties": { "address": { "description": "Token contract address; requires chain.", "maxLength": 100, "type": "string" }, "chain": { "description": "Chain name for the contract-address variant, for example \"eth\", \"base\", \"bsc\", or \"solana\".", "maxLength": 40, "type": "string" }, "response_format": { "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.", "enum": [ "concise", "detailed", "json", "markdown" ], "type": "string" }, "token": { "description": "CoinGecko coin id or ticker symbol, for example \"bitcoin\" or \"BTC\". Omit when passing chain + address.", "maxLength": 100, "minLength": 1, "type": "string" }, "vs_currency": { "description": "Quote currency. Default \"usd\".", "maxLength": 20, "type": "string" } }, "type": "object" }, "name": "get_token_price", "outputSchema": { "additionalProperties": true, "properties": { "change_24h_percent": { "type": "number" }, "market_cap": { "type": "number" }, "price": { "type": "number" }, "source_receipt": { "additionalProperties": true, "properties": { "fetched_at": { "format": "date-time", "type": "string" }, "provider": { "type": "string" }, "runtime_status": { "enum": [ "ok", "invalid_input", "missing_key", "plan_required", "rate_limited", "degraded", "failing" ], "type": "string" } }, "required": [ "provider", "runtime_status", "fetched_at" ], "type": "object" }, "token": { "type": "string" }, "vs_currency": { "type": "string" } }, "required": [ "source_receipt" ], "type": "object" } }, { "description": "Token holdings for a wallet with balances and USD values where available. EVM chains route through Alchemy; Solana wallets are detected automatically and route through Helius.", "inputSchema": { "additionalProperties": true, "properties": { "address": { "description": "Required. Wallet address (0x… for EVM, base58 for Solana).", "maxLength": 100, "minLength": 1, "type": "string" }, "chain": { "description": "Chain name, for example \"eth\", \"base\", \"arbitrum\", or \"solana\". Defaults to eth for 0x addresses; Solana is auto-detected.", "maxLength": 40, "type": "string" }, "response_format": { "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.", "enum": [ "concise", "detailed", "json", "markdown" ], "type": "string" } }, "type": "object" }, "name": "get_wallet_portfolio", "outputSchema": { "additionalProperties": true, "properties": { "address": { "type": "string" }, "chain": { "type": "string" }, "note": { "type": "string" }, "source_receipt": { "additionalProperties": true, "properties": { "fetched_at": { "format": "date-time", "type": "string" }, "provider": { "type": "string" }, "runtime_status": { "enum": [ "ok", "invalid_input", "missing_key", "plan_required", "rate_limited", "degraded", "failing" ], "type": "string" } }, "required": [ "provider", "runtime_status", "fetched_at" ], "type": "object" }, "token_count": { "description": "Total holdings found, which may exceed tokens.length.", "type": "number" }, "tokens": { "description": "Holdings; truncated in concise mode when note is present.", "items": { "additionalProperties": true, "type": "object" }, "type": "array" } }, "required": [ "source_receipt" ], "type": "object" } }, { "description": "Invokes only read-only Hive endpoints by name. First discover the tool, inspect get_api_endpoint_schema, and pass bounded schema-valid arguments. State-changing endpoints are rejected and must use invoke_stateful_endpoint after explicit user approval.", "inputSchema": { "additionalProperties": {}, "properties": { "args": { "additionalProperties": {}, "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" }, "type": "object" }, "endpoint": { "description": "Alias for 'endpoint_name', accepted by both root invokers. Provide one of the two.", "type": "string" }, "endpoint_name": { "description": "The name of the endpoint to invoke.", "type": "string" }, "response_format": { "description": "Output format: 'json' for structured data (default) or 'markdown' for human-readable text.", "enum": [ "json", "markdown" ], "type": "string" } }, "type": "object" }, "name": "invoke_api_endpoint", "outputSchema": { "additionalProperties": true, "properties": { "_degraded": { "type": "string" }, "_hive": { "additionalProperties": false, "properties": { "build_sha": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cache_age_ms": { "anyOf": [ { "minimum": 0, "type": "number" }, { "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" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cause": { "description": "Errors only: what actually happened, written for the model.", "type": "string" }, "credit_cost": { "description": "Static credit price of this tool: 0 for discovery tools and free writes, 1 for everything else. Present when the calling lane bills.", "enum": [ 0, 1 ], "type": "integer" }, "credits_remaining": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "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." }, "credits_used": { "description": "Credits actually debited for this call: 0 when validation or a gate stopped it, credit_cost once the provider was reached.", "minimum": 0, "type": "integer" }, "digest_algorithm": { "const": "sha256", "type": "string" }, "doc_url": { "description": "Docs anchor for the error code (errors only).", "type": "string" }, "duration_ms": { "type": "number" }, "fallback_used": { "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.", "type": "boolean" }, "fetched_at": { "format": "date-time", "type": "string" }, "input_digest": { "description": "SHA-256 self-check of canonical JSON arguments. It is not a server signature.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "next_action": { "description": "Errors only: the one useful next step. Follow it instead of retrying the same call unchanged.", "type": "string" }, "observed_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "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." }, "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." }, "provider": { "type": "string" }, "receipt_id": { "description": "Unique runtime receipt for this Hive tool call. Include it when reporting or debugging the evidence.", "format": "uuid", "type": "string" }, "receipt_version": { "const": "1.0", "type": "string" }, "result_digest": { "description": "SHA-256 self-check of the canonical returned payload after Hive result normalization and before the top-level _hive receipt is attached.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "runtime_status": { "enum": [ "ok", "invalid_input", "missing_key", "plan_required", "rate_limited", "degraded", "failing" ], "type": "string" }, "sanitized": { "description": "Present and true when instruction-shaped provider text was neutralized before reaching agent context.", "type": "boolean" }, "server_version": { "type": "string" }, "source": { "enum": [ "live", "cached", "fallback", "unavailable" ], "type": "string" }, "tool": { "type": "string" }, "truncated": { "type": "boolean" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "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" ], "type": "object" }, "_metadata": { "additionalProperties": true, "type": "object" }, "_pagination": { "additionalProperties": true, "properties": { "has_more": { "type": "boolean" }, "returned": { "type": "number" }, "total_available": { "type": "number" } }, "type": "object" }, "_provider": { "type": "string" }, "_truncated": { "type": "boolean" }, "_type": { "type": "string" }, "data": { "description": "Provider data payload when the response uses a data wrapper." }, "error": { "type": "string" }, "items": { "description": "Array result when a provider returns a top-level list.", "items": {}, "type": "array" }, "message": { "type": "string" }, "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." } }, "required": [ "_hive" ], "type": "object" } }, { "description": "Invokes a Hive-native state-changing endpoint after explicit user approval. This router can create, update, archive, remember, forget, acknowledge, or resolve durable Hive state, so clients must not auto-approve it. Inspect get_api_endpoint_schema first and verify the saved result after execution.", "inputSchema": { "additionalProperties": {}, "properties": { "args": { "additionalProperties": {}, "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" }, "type": "object" }, "endpoint": { "description": "Alias for 'endpoint_name', accepted by both root invokers. Provide one of the two.", "type": "string" }, "endpoint_name": { "description": "The name of the endpoint to invoke.", "type": "string" }, "response_format": { "description": "Output format: 'json' for structured data (default) or 'markdown' for human-readable text.", "enum": [ "json", "markdown" ], "type": "string" } }, "type": "object" }, "name": "invoke_stateful_endpoint", "outputSchema": { "additionalProperties": true, "properties": { "_degraded": { "type": "string" }, "_hive": { "additionalProperties": false, "properties": { "build_sha": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cache_age_ms": { "anyOf": [ { "minimum": 0, "type": "number" }, { "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" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cause": { "description": "Errors only: what actually happened, written for the model.", "type": "string" }, "credit_cost": { "description": "Static credit price of this tool: 0 for discovery tools and free writes, 1 for everything else. Present when the calling lane bills.", "enum": [ 0, 1 ], "type": "integer" }, "credits_remaining": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "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." }, "credits_used": { "description": "Credits actually debited for this call: 0 when validation or a gate stopped it, credit_cost once the provider was reached.", "minimum": 0, "type": "integer" }, "digest_algorithm": { "const": "sha256", "type": "string" }, "doc_url": { "description": "Docs anchor for the error code (errors only).", "type": "string" }, "duration_ms": { "type": "number" }, "fallback_used": { "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.", "type": "boolean" }, "fetched_at": { "format": "date-time", "type": "string" }, "input_digest": { "description": "SHA-256 self-check of canonical JSON arguments. It is not a server signature.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "next_action": { "description": "Errors only: the one useful next step. Follow it instead of retrying the same call unchanged.", "type": "string" }, "observed_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "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." }, "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." }, "provider": { "type": "string" }, "receipt_id": { "description": "Unique runtime receipt for this Hive tool call. Include it when reporting or debugging the evidence.", "format": "uuid", "type": "string" }, "receipt_version": { "const": "1.0", "type": "string" }, "result_digest": { "description": "SHA-256 self-check of the canonical returned payload after Hive result normalization and before the top-level _hive receipt is attached.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "runtime_status": { "enum": [ "ok", "invalid_input", "missing_key", "plan_required", "rate_limited", "degraded", "failing" ], "type": "string" }, "sanitized": { "description": "Present and true when instruction-shaped provider text was neutralized before reaching agent context.", "type": "boolean" }, "server_version": { "type": "string" }, "source": { "enum": [ "live", "cached", "fallback", "unavailable" ], "type": "string" }, "tool": { "type": "string" }, "truncated": { "type": "boolean" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "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" ], "type": "object" }, "_metadata": { "additionalProperties": true, "type": "object" }, "_pagination": { "additionalProperties": true, "properties": { "has_more": { "type": "boolean" }, "returned": { "type": "number" }, "total_available": { "type": "number" } }, "type": "object" }, "_provider": { "type": "string" }, "_truncated": { "type": "boolean" }, "_type": { "type": "string" }, "data": { "description": "Provider data payload when the response uses a data wrapper." }, "error": { "type": "string" }, "items": { "description": "Array result when a provider returns a top-level list.", "items": {}, "type": "array" }, "message": { "type": "string" }, "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." } }, "required": [ "_hive" ], "type": "object" } }, { "description": "Search canonical task toolsets, compact user-intent routes, and the full Hive coverage catalog. Select a matching route first, follow its ordered primary calls and conditional fallbacks, then inspect each exact schema. Execute reads with invoke_api_endpoint and explicitly approved Hive state changes with invoke_stateful_endpoint.", "inputSchema": { "additionalProperties": false, "properties": { "category": { "description": "Optional category filter, for example Portfolio & Wallet.", "maxLength": 128, "type": "string" }, "cursor": { "description": "Pagination cursor from the previous response.", "type": "string" }, "detail": { "description": "Toolset detail level. Defaults to compact. Use full only when the task output schema is needed.", "enum": [ "compact", "standard", "full" ], "type": "string" }, "evidence_phase": { "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.", "maxLength": 100, "type": "string" }, "limit": { "description": "Maximum tools to return. Default 20.", "maximum": 50, "minimum": 1, "type": "integer" }, "provider": { "description": "Optional provider filter such as CoinGecko, Moralis, Tenderly, Helius, GoPlus, CCXT, Alchemy, DeFiLlama, Hyperliquid, or Open Data Fetch.", "maxLength": 128, "type": "string" }, "query": { "description": "Search text matched against tool name, title, category, provider, and summary.", "maxLength": 512, "type": "string" }, "response_format": { "description": "Output format: 'json' for structured data (default) or 'markdown' for human-readable text.", "enum": [ "json", "markdown" ], "type": "string" }, "route_id": { "description": "Optional exact task-shaped route id. Use the matched route's ordered calls and conditional fallbacks instead of choosing from the coverage catalog.", "maxLength": 100, "type": "string" }, "toolset_cursor": { "description": "Pagination cursor for task toolset matches.", "type": "string" }, "toolset_id": { "description": "Optional exact canonical task toolset id. Use this after an initial compact result to inspect one workflow.", "maxLength": 100, "type": "string" }, "toolset_limit": { "description": "Maximum matching task toolsets to return. Default 3, max 5.", "maximum": 5, "minimum": 1, "type": "integer" } }, "type": "object" }, "name": "search_tools", "outputSchema": { "properties": { "_hive": { "additionalProperties": false, "properties": { "build_sha": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cache_age_ms": { "anyOf": [ { "minimum": 0, "type": "number" }, { "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" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cause": { "description": "Errors only: what actually happened, written for the model.", "type": "string" }, "credit_cost": { "description": "Static credit price of this tool: 0 for discovery tools and free writes, 1 for everything else. Present when the calling lane bills.", "enum": [ 0, 1 ], "type": "integer" }, "credits_remaining": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "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." }, "credits_used": { "description": "Credits actually debited for this call: 0 when validation or a gate stopped it, credit_cost once the provider was reached.", "minimum": 0, "type": "integer" }, "digest_algorithm": { "const": "sha256", "type": "string" }, "doc_url": { "description": "Docs anchor for the error code (errors only).", "type": "string" }, "duration_ms": { "type": "number" }, "fallback_used": { "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.", "type": "boolean" }, "fetched_at": { "format": "date-time", "type": "string" }, "input_digest": { "description": "SHA-256 self-check of canonical JSON arguments. It is not a server signature.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "next_action": { "description": "Errors only: the one useful next step. Follow it instead of retrying the same call unchanged.", "type": "string" }, "observed_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "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." }, "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." }, "provider": { "type": "string" }, "receipt_id": { "description": "Unique runtime receipt for this Hive tool call. Include it when reporting or debugging the evidence.", "format": "uuid", "type": "string" }, "receipt_version": { "const": "1.0", "type": "string" }, "result_digest": { "description": "SHA-256 self-check of the canonical returned payload after Hive result normalization and before the top-level _hive receipt is attached.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "runtime_status": { "enum": [ "ok", "invalid_input", "missing_key", "plan_required", "rate_limited", "degraded", "failing" ], "type": "string" }, "sanitized": { "description": "Present and true when instruction-shaped provider text was neutralized before reaching agent context.", "type": "boolean" }, "server_version": { "type": "string" }, "source": { "enum": [ "live", "cached", "fallback", "unavailable" ], "type": "string" }, "tool": { "type": "string" }, "truncated": { "type": "boolean" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "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" ], "type": "object" }, "category": { "type": "string" }, "pagination": { "properties": { "cursor": { "type": "string" }, "has_more": { "type": "boolean" }, "limit": { "type": "number" }, "next_cursor": { "type": "string" }, "returned": { "type": "number" }, "total": { "type": "number" } }, "type": "object" }, "provider": { "type": "string" }, "query": { "type": "string" }, "route_id": { "type": "string" }, "tools": { "items": { "properties": { "availability": { "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.", "enum": [ "ok", "degraded", "missing_key", "failing" ], "type": "string" }, "availability_note": { "type": "string" }, "callableVia": { "enum": [ "invoke_api_endpoint", "invoke_stateful_endpoint" ], "type": "string" }, "category": { "type": "string" }, "credit_cost": { "enum": [ 0, 1 ], "type": "integer" }, "hasOutputSchema": { "type": "boolean" }, "inputRequired": { "items": { "type": "string" }, "type": "array" }, "material": { "description": "True when the call costs one credit (or one keyless call); false for free discovery tools and free writes.", "type": "boolean" }, "name": { "type": "string" }, "operation": { "enum": [ "read", "write" ], "type": "string" }, "provider": { "type": "string" }, "readOnly": { "type": "boolean" }, "summary": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "type": "array" }, "toolset_detail": { "enum": [ "compact", "standard", "full" ], "type": "string" }, "toolset_pagination": { "properties": { "cursor": { "type": "string" }, "has_more": { "type": "boolean" }, "limit": { "type": "number" }, "next_cursor": { "type": "string" }, "returned": { "type": "number" }, "total": { "type": "number" } }, "type": "object" }, "toolsets": { "items": { "properties": { "availability_note": { "type": "string" }, "coverageCatalog": { "additionalProperties": true, "type": "object" }, "executionPolicy": { "additionalProperties": true, "type": "object" }, "id": { "type": "string" }, "kind": { "type": "string" }, "label": { "type": "string" }, "outcome": { "type": "string" }, "outputSchema": { "additionalProperties": true, "type": "object" }, "providerAvailability": { "additionalProperties": true, "description": "Present only when a provider in this toolset is not ok: provider name -> degraded | missing_key | failing.", "type": "object" }, "providers": { "items": { "type": "string" }, "type": "array" }, "purpose": { "type": "string" }, "requiredIdentifiers": { "items": { "type": "string" }, "type": "array" }, "resource": { "type": "string" }, "routes": { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, "runtimeStatuses": { "items": { "type": "string" }, "type": "array" }, "tags": { "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "type": "array" } }, "required": [ "_hive" ], "type": "object" } }, { "description": "Validates a proposed workflow answer against Hive's typed task-output and evidence-receipt contract before it is shown to the user. It checks the selected route id, ordered route-only calls, conditional fallback use, the four-call route budget, claim-to-receipt citations, canonical phase coverage, and internal receipt consistency. It cannot authenticate invented receipts or turn SHA-256 self-checks into signatures, so every call entry must be copied exactly from the server-minted _hive block returned by that execution.", "inputSchema": { "additionalProperties": false, "properties": { "response_format": { "description": "Output format: 'json' for structured data (default) or 'markdown' for human-readable text.", "enum": [ "json", "markdown" ], "type": "string" }, "result": { "additionalProperties": {}, "description": "The proposed task result envelope. Each receipt.calls entry must be copied exactly from a material call's _hive object.", "propertyNames": { "type": "string" }, "type": "object" }, "task_toolset_id": { "description": "Canonical task toolset id returned by search_tools.", "type": "string" } }, "required": [ "task_toolset_id", "result" ], "type": "object" }, "name": "validate_task_result", "outputSchema": { "additionalProperties": false, "properties": { "_hive": { "additionalProperties": false, "properties": { "build_sha": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cache_age_ms": { "anyOf": [ { "minimum": 0, "type": "number" }, { "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" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "cause": { "description": "Errors only: what actually happened, written for the model.", "type": "string" }, "credit_cost": { "description": "Static credit price of this tool: 0 for discovery tools and free writes, 1 for everything else. Present when the calling lane bills.", "enum": [ 0, 1 ], "type": "integer" }, "credits_remaining": { "anyOf": [ { "minimum": 0, "type": "integer" }, { "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." }, "credits_used": { "description": "Credits actually debited for this call: 0 when validation or a gate stopped it, credit_cost once the provider was reached.", "minimum": 0, "type": "integer" }, "digest_algorithm": { "const": "sha256", "type": "string" }, "doc_url": { "description": "Docs anchor for the error code (errors only).", "type": "string" }, "duration_ms": { "type": "number" }, "fallback_used": { "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.", "type": "boolean" }, "fetched_at": { "format": "date-time", "type": "string" }, "input_digest": { "description": "SHA-256 self-check of canonical JSON arguments. It is not a server signature.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "next_action": { "description": "Errors only: the one useful next step. Follow it instead of retrying the same call unchanged.", "type": "string" }, "observed_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "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." }, "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." }, "provider": { "type": "string" }, "receipt_id": { "description": "Unique runtime receipt for this Hive tool call. Include it when reporting or debugging the evidence.", "format": "uuid", "type": "string" }, "receipt_version": { "const": "1.0", "type": "string" }, "result_digest": { "description": "SHA-256 self-check of the canonical returned payload after Hive result normalization and before the top-level _hive receipt is attached.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "runtime_status": { "enum": [ "ok", "invalid_input", "missing_key", "plan_required", "rate_limited", "degraded", "failing" ], "type": "string" }, "sanitized": { "description": "Present and true when instruction-shaped provider text was neutralized before reaching agent context.", "type": "boolean" }, "server_version": { "type": "string" }, "source": { "enum": [ "live", "cached", "fallback", "unavailable" ], "type": "string" }, "tool": { "type": "string" }, "truncated": { "type": "boolean" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "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" ], "type": "object" }, "call_count": { "type": "number" }, "errors": { "items": { "type": "object" }, "type": "array" }, "receipt_ids": { "items": { "type": "string" }, "type": "array" }, "route_id": { "type": "string" }, "task_toolset_id": { "type": "string" }, "valid": { "type": "boolean" }, "warnings": { "items": { "type": "string" }, "type": "array" } }, "required": [ "valid", "task_toolset_id", "route_id", "call_count", "receipt_ids", "errors", "warnings", "_hive" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:96fad5dd2df8b9a08b0aea3fb070d0af7299a5c140259766654f83264fd0a3cb | sha256sum