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 yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:96fad5dd2df8b9a08b0aea3fb070d0af7299a5c140259766654f83264fd0a3cb | sha256sum