Serveur MCP
gblin-treasury-risk-regime
io.github.gblinproject/gblin-treasury-risk-regime
Ce que fait ce MCP
Reports BTC and ETH risk regimes, treasury and protocol statistics, and provides cryptographically verifiable action receipts and attestations on Base.
Capacités
Outils
21
outils
actions.prepare
Build the unsigned transactions for any operation on the GBLIN vault, in the order to send them. Actions: mint_with_eth (amount in ETH), mint_with_weth (amount in WETH), mint_with_usdc (amount in USDC, through the Zap), redeem_in_kind (amount in shares; pro rata basket tokens, no fee, no price feed), exit_to_eth (amount in shares, through the Zap, all or nothing), exit_to_usdc (amount = the USDC you need), bid (trade with the rebalancing auction; row optional, the largest gap by default). Every output bound is non-zero and every step through the vault or the Zap carries its gas limit. Nothing is signed or sent: simulate the steps with preview_steps, then send them from the wallet.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['action', 'wallet_address'], 'properties': {'row': {'type': 'integer', 'minimum': 0, 'description': 'bid only: the basket row to bid on. Default: the row with the largest gap.'}, 'action': {'enum': ['mint_with_eth', 'mint_with_weth', 'mint_with_usdc', 'redeem_in_kind', 'exit_to_eth', 'exit_to_usdc', 'bid'], 'type': 'string', 'description': 'The operation to prepare.'}, 'amount': {'type': 'string', 'pattern': '^\\d+(\\.\\d+)?$', 'description': 'Decimal amount. Unit depends on the action (see the description). Not used by bid.'}, 'wallet_address': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$', 'description': 'The wallet that will sign and receive.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['action', 'steps'], 'properties': {'next': {'type': 'string'}, 'steps': {'type': 'array', 'items': {'type': 'object', 'description': 'One transaction to send, in order: target, calldata, value in wei, and gas when the step needs an explicit limit.'}, 'description': 'Transactions to send in order.'}, 'action': {'type': 'string'}, 'wallet': {'type': 'string'}, 'expected': {'type': 'object', 'description': 'What the operation should deliver, with the minimums applied.'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}}, 'additionalProperties': True}
actions.preview
Simulate a list of transactions in sequence against the latest Base block, as if the wallet sent them one after the other, before anything is signed. Each step sees the state the previous ones left (an approval before a mint works). Returns, per step, whether it would succeed, the gas it uses, whether the gas limit it carries is enough, and the decoded revert reason with a hint when it fails; and the net token and ETH movements for the wallet. Pass the steps exactly as prepare_action, invest_usdc_to_gblin or swap_gblin_to_usdc_jit return them. State can change before your transactions land: a successful preview is evidence, not a guarantee.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['from', 'steps'], 'properties': {'from': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$', 'description': 'The wallet that will send the steps.'}, 'steps': {'type': 'array', 'items': {'type': 'object', 'required': ['target', 'calldata'], 'properties': {'gas': {'type': 'string', 'pattern': '^\\d+$'}, 'value': {'type': 'string', 'pattern': '^\\d+$'}, 'target': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'calldata': {'type': 'string', 'pattern': '^0x([0-9a-fA-F]{2})*$'}}, 'additionalProperties': True}, 'maxItems': 8, 'minItems': 1, 'description': 'The steps, in order: target, calldata, value in wei (optional), gas (optional).'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['would_succeed', 'steps', 'balance_changes'], 'properties': {'from': {'type': 'string'}, 'note': {'type': 'string'}, 'block': {'type': 'number', 'description': 'The block the simulation ran on.'}, 'steps': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Per step: success, gas used, whether the given limit is enough, recommended limit, revert reason.'}, 'would_succeed': {'type': 'boolean', 'description': 'True only if every step succeeds in the simulation.'}, 'balance_changes': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Net token and ETH movements for the wallet.'}, 'first_failing_step': {'type': ['number', 'null']}}, 'additionalProperties': True}
actions.status
Report what a sent Base transaction did: pending, succeeded, reverted or not found; its block and confirmations; the fee paid; the net token movements for the sender (GBLIN shares minted or redeemed, USDC, basket tokens); and, when it reverted, the decoded reason. Use it after sending the steps from prepare_action to confirm each one before the next.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['hash'], 'properties': {'hash': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{64}$', 'description': 'The transaction hash.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['hash', 'status'], 'properties': {'to': {'type': ['string', 'null']}, 'from': {'type': 'string'}, 'hash': {'type': 'string'}, 'note': {'type': 'string'}, 'block': {'type': 'number'}, 'revert': {'type': 'object'}, 'status': {'enum': ['pending', 'not_found', 'success', 'reverted'], 'type': 'string'}, 'fee_eth': {'type': 'string'}, 'explorer': {'type': 'string'}, 'gas_used': {'type': 'number'}, 'gas_limit': {'type': ['number', 'null']}, 'confirmations': {'type': ['number', 'null']}, 'balance_changes': {'type': 'array', 'items': {'type': 'object'}}}, 'additionalProperties': True}
attestation.verify
Verify a GBLIN Risk Attestation — the object returned by GBLIN's /api/x402/attestation, or a proof-of-diligence a peer agent attached to its action. FREE, no payment. Runs four checks: (1) INTEGRITY — recomputes the EIP-712 attestation_id and detects tampering; (2) AUTHENTICITY — if a signature is present, recovers the signer and checks it is GBLIN's published attestor; (3) FRESHNESS — whether it expired (10-minute TTL), using on-chain time; (4) LIVE DRIFT — compares the attested regime to the CURRENT on-chain regime and flags if it changed. Use before you trust any counterparty/peer that claims it 'checked market risk via GBLIN'.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['attestation'], 'properties': {'attestation': {'type': 'object', 'description': 'The full attestation object from /api/x402/attestation (must include `eip712`; `attestation_id`, `signature`, `attestor` are used when present). A JSON string of that object is also accepted.'}, 'expected_attestor': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$', 'description': 'Optional 0x address to check the signature against. Defaults to the GBLIN attestor address baked into this MCP build (GBLIN_ATTESTOR_ADDRESS env).'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['valid', 'checks'], 'properties': {'live': {'type': 'object'}, 'valid': {'type': 'boolean', 'description': 'True only if every check passed.'}, 'checks': {'type': 'object', 'description': 'Each check by name, with its result.'}, 'source': {'type': 'string'}, 'attested': {'type': 'object'}, 'guidance': {'type': 'string'}, 'recomputed_attestation_id': {'type': 'string'}}, 'additionalProperties': True}
auction.state
Read the GBLIN rebalancing auction on Base. The vault does not rebalance itself and pays nobody to do it: when a basket row drifts past its band it holds a Dutch auction, and whoever trades with it toward the target weights is the counterparty, at the oracle price adjusted by a premium that starts at a discount and rises to a cap over one ramp. Returns, per row, the side the vault takes, the gap in ETH, the token and amount the bidder hands over, and unsigned calldata (approval + bid). The premium is the whole reward; nothing is paid out of the vault.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['vault', 'navReliable', 'auctionOpen', 'premiumBps', 'rows'], 'properties': {'best': {'type': ['object', 'null'], 'description': 'The row with the largest gap, or null.'}, 'lens': {'type': 'string'}, 'note': {'type': 'string'}, 'rows': {'type': 'array', 'items': {'type': 'object'}, 'description': 'One entry per basket asset: side, gap from target and amount a bidder can fill.'}, 'curve': {'type': 'object'}, 'vault': {'type': 'string'}, 'howToBid': {'type': 'string'}, 'openedAt': {'type': ['number', 'string', 'null'], 'description': 'When the auction opened, or null when closed.'}, 'premiumBps': {'type': 'number', 'description': 'Current premium over the oracle price, in basis points; negative is a discount.'}, 'auctionOpen': {'type': 'boolean'}, 'navReliable': {'type': 'boolean'}, 'worstGapEth': {'type': 'string'}, 'totalValueEth': {'type': 'string'}}, 'additionalProperties': True}
coherence.report
Kept/violated tallies for GBLIN's pre-registered, hash-pinned promises (attestation uptime, counter honesty), probed every 10 minutes; each closed UTC day is sealed on Base as an EAS attestation (schema 0x9f433a96…). Self-observation only in v0. Free.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['subject', 'promises'], 'properties': {'method': {'type': 'string'}, 'subject': {'type': 'string', 'description': 'Observed subject'}, 'promises': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Short promise id (P1, P2, ...)'}, 'file': {'type': 'string', 'description': 'Public URL of the promise file'}, 'kept': {'type': 'integer'}, 'kept_bps': {'type': 'integer', 'description': 'Kept ratio in basis points (10000 = 100%)'}, 'promiseId': {'type': 'string', 'description': 'keccak256 of the pre-registered promise file'}, 'violations': {'type': 'integer'}, 'last_status': {'enum': ['kept', 'violated'], 'type': 'string'}, 'observations': {'type': 'integer'}, 'last_observation': {'type': 'string'}}}}, 'observing_since': {'type': 'string'}}}
governance.state
Verify GBLIN protocol governance state: confirms whether the GBLIN vault is owned by the 48h Timelock, reads the timelock's min delay and grace period, reports role member counts, and surfaces any pending asset-addition proposal on the index contract. If an operation_id is provided, also reports the status of that specific timelock operation. Read-only — use this to gate trust-sensitive agent actions.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'operation_id': {'type': 'string', 'description': 'Optional 0x-prefixed 32-byte hex id of a specific timelock operation to inspect.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['vault', 'owner', 'owner_is_timelock', 'owner_is_renounced', 'timelock'], 'properties': {'lens': {'type': 'string'}, 'owner': {'type': 'string'}, 'vault': {'type': 'string'}, 'timelock': {'type': 'object', 'description': 'Address and minimum delay of the timelock, read on chain.'}, 'verification': {'type': 'object'}, 'fee_recipient': {'type': 'string'}, 'trust_summary': {'type': 'string'}, 'pending_handover': {'type': ['object', 'null'], 'description': 'A pending ownership transfer, or null.'}, 'owner_is_timelock': {'type': 'boolean'}, 'owner_is_renounced': {'type': 'boolean'}, 'pending_timelock_operation': {'type': ['object', 'null'], 'description': 'A scheduled timelock operation affecting ownership, or null.'}}, 'additionalProperties': True}
payments.prepare
Build a gasless GBLIN payment. The vault's share token implements EIP-3009, so the holder signs an authorization and anybody can carry it on chain: the payer needs no ETH. Returns the EIP-712 message to sign (its domain is read from the token, not assumed), the calldata that carries the signed authorization, and the x402 'exact' payload for paying an HTTP endpoint in GBLIN. Use method 'receive' when paying a known recipient: only that recipient can submit it, so nobody can front-run the transfer. Use 'transfer' for an x402 facilitator, which submits on the seller's behalf. With relay: true it also prepares the fee authorization for relay_gblin_payment, for when nobody else will carry the payment. No private key is requested, held or transmitted: the signature is produced by the caller's own wallet.
Lecture seule
Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['from', 'to'], 'properties': {'to': {'type': 'string', 'description': "The recipient's address."}, 'from': {'type': 'string', 'description': "The payer's address: the wallet that will sign."}, 'relay': {'type': 'boolean', 'description': "true when nobody else will carry the payment on chain: also prepares the relay fee authorization, paid in GBLIN at the live NAV, for relay_gblin_payment. Forces method 'transfer'."}, 'method': {'enum': ['receive', 'transfer'], 'type': 'string', 'description': "'receive' (default) can be submitted only by the recipient; 'transfer' by anyone."}, 'amount_usd': {'type': 'string', 'description': 'Amount in USD, converted at the live NAV. Give this or amount_gblin.'}, 'amount_gblin': {'type': 'string', 'description': "Amount in GBLIN shares, e.g. '0.25'. Give this or amount_usd."}, 'valid_for_seconds': {'type': 'number', 'description': 'How long the authorization stays valid. Default 600, maximum 86400.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['authorization', 'method', 'typed_data', 'digest', 'x402_payload'], 'properties': {'relay': {'type': 'object', 'description': 'With relay: true, the fee authorization to sign and where to send both.'}, 'amount': {'type': 'object'}, 'digest': {'type': 'string', 'description': 'The EIP-712 digest of typed_data.'}, 'method': {'enum': ['receive', 'transfer'], 'type': 'string'}, 'submit': {'type': 'object'}, 'warnings': {'type': 'array', 'items': {'type': 'string'}}, 'next_steps': {'type': 'array', 'items': {'type': 'string'}}, 'typed_data': {'type': 'object', 'description': 'The EIP-712 message to sign with eth_signTypedData_v4.'}, 'x402_payload': {'type': 'object', 'description': 'The x402 exact-scheme payment payload, with the signature left to fill.'}, 'authorization': {'type': 'object', 'description': 'from, to, value, validAfter, validBefore, nonce.'}, 'payer_balance': {'type': 'object'}, 'x402_accepts_for_sellers': {'type': 'object'}}, 'additionalProperties': True}
payments.relay
Have GBLIN's relay carry a signed GBLIN payment on chain for a payer that holds no ETH. Pass the payment and the relay fee, each as { authorization, signature }, both prepared by prepare_gblin_payment with relay: true and signed by the payer's wallet. The relay checks both against the chain, simulates them and submits them in one transaction through Multicall3: either both settle or neither does. The fee is paid in GBLIN at the live NAV. Returns the transaction hash and its outcome. This moves funds: run it only with authorizations the payer meant to sign.
Destructif
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['payment', 'fee'], 'properties': {'fee': {'type': 'object', 'required': ['authorization', 'signature'], 'properties': {'signature': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]+$'}, 'authorization': {'type': 'object'}}, 'description': "{ authorization, signature } of the relay fee, from prepare_gblin_payment's relay block."}, 'payment': {'type': 'object', 'required': ['authorization', 'signature'], 'properties': {'signature': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]+$'}, 'authorization': {'type': 'object'}}, 'description': "{ authorization, signature } of the payment, method 'transfer'."}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['relay', 'status', 'transaction'], 'properties': {'fee': {'type': 'object'}, 'note': {'type': 'string'}, 'block': {'type': 'number'}, 'relay': {'type': 'string', 'description': 'The relay that carried the payment.'}, 'status': {'enum': ['settled', 'reverted', 'submitted'], 'type': 'string'}, 'payment': {'type': 'object'}, 'explorer': {'type': 'string'}, 'transaction': {'type': 'string', 'description': 'The transaction hash.'}}, 'additionalProperties': True}
payments.verify
Check a signed GBLIN authorization against the chain before spending gas on it. Recovers the signer from the EIP-712 digest (and asks the wallet itself through ERC-1271 when the payer is a contract), then checks the validity window against on-chain time, whether the nonce has already been used or cancelled, and whether the payer still holds the amount. Returns a verdict and the ready calldata when it would settle, the failing reason when it would not. This is the same set of checks an x402 facilitator runs, so a 'would_settle' verdict here means the payment is good to carry.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['authorization', 'signature'], 'properties': {'method': {'enum': ['receive', 'transfer'], 'type': 'string', 'description': "Which method the signature was produced for. Default 'receive'."}, 'signature': {'type': 'string', 'description': "The signature produced by the payer's wallet, 0x-prefixed."}, 'authorization': {'type': 'object', 'description': 'The authorization object: from, to, value, validAfter, validBefore, nonce.', 'additionalProperties': True}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['would_settle', 'method', 'checks', 'failures'], 'properties': {'amount': {'type': 'object'}, 'checks': {'type': 'object'}, 'digest': {'type': 'string'}, 'method': {'enum': ['receive', 'transfer'], 'type': 'string'}, 'source': {'type': 'string'}, 'submit': {'type': ['object', 'null'], 'description': 'Calldata and who may submit it, or null when it would not settle.'}, 'failures': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Reasons it would not settle; empty when it would.'}, 'would_settle': {'type': 'boolean', 'description': 'True only if the token would accept this authorization now.'}}, 'additionalProperties': True}
protocol.info
GBLIN llms.txt as plain text: contract addresses, endpoints, prices, payment flow, field contract of the attestation.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['llms_txt'], 'properties': {'llms_txt': {'type': 'string', 'description': 'The full llms.txt document (plain text)'}}}
protocol.stats
Cumulative public counters of GBLIN's x402 endpoints: paid calls, unique payer wallets, USDC earned, with methodology disclosure. Cached 5 min.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['total_paid_calls', 'total_unique_agents', 'total_usdc_earned'], 'properties': {'_source': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'docs': {'type': 'string'}, 'name': {'type': 'string'}, 'license': {'type': 'string'}, 'disclosure': {'type': 'string'}, 'data_endpoint': {'type': 'string'}}, 'description': 'Provenance and disclosure of the counters'}, 'total_paid_calls': {'type': 'integer', 'description': 'Settled x402 calls, cumulative'}, 'total_usdc_earned': {'type': 'number', 'description': 'USDC received, cumulative'}, 'total_unique_agents': {'type': 'integer', 'description': 'Distinct payer wallets, cumulative (our own wallets excluded)'}}}
receipts.get
Receipt #index from GBLIN's receipts log, re-signed (Ed25519 is deterministic) with a fresh inclusion proof, the current signed checkpoint and the latest on-chain anchor. Free.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['index'], 'properties': {'index': {'type': 'integer', 'minimum': 0, 'description': 'Receipt index in the log (0-based; current size at GET /log/checkpoint)'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['format', 'payload', 'leaf', 'index', 'tree_size', 'root', 'signature', 'verifier_key', 'inclusion_proof', 'checkpoint', 'anchor', 'provenance'], 'properties': {'leaf': {'type': 'string', 'description': 'base64 SHA256(0x00 || canonical)'}, 'root': {'type': 'string', 'description': 'base64 Merkle root at tree_size'}, 'index': {'type': 'integer'}, 'anchor': {'type': 'object', 'required': ['root_covers_this_receipt', 'anchored_tree_size', 'what_is_anchored'], 'properties': {'chain': {'type': 'string'}, 'method': {'type': 'string'}, 'explorer': {'type': 'string'}, 'promise_id': {'type': 'string'}, 'last_anchor': {'type': ['object', 'null'], 'properties': {'tx': {'type': 'string'}, 'day': {'type': 'string'}, 'root': {'type': 'string'}, 'tree_size': {'type': 'integer'}}}, 'eas_schema_uid': {'type': 'string'}, 'what_is_anchored': {'type': 'string'}, 'anchored_tree_size': {'type': ['integer', 'null']}, 'covers_this_receipt': {'type': 'boolean', 'description': 'deprecated alias of root_covers_this_receipt'}, 'root_covers_this_receipt': {'type': 'boolean', 'description': 'true iff index < anchored_tree_size: the anchored ROOT commits to this leaf via the inclusion proof'}}, 'description': 'Latest daily EAS anchor of the tree root on Base and whether it already covers this receipt'}, 'format': {'type': 'string', 'const': 'gblin-receipt/v1'}, 'payload': {'type': 'object', 'required': ['v', 'log', 'index', 'ts', 'action', 'input_hash'], 'properties': {'v': {'type': 'integer'}, 'by': {'enum': ['operator'], 'type': 'string', 'description': 'Present only when this server sealed its own action; set server-side, cannot be supplied by a caller'}, 'ts': {'type': 'string'}, 'log': {'type': 'string'}, 'demo': {'type': 'boolean'}, 'meta': {}, 'tool': {'type': ['string', 'null']}, 'index': {'type': 'integer'}, 'action': {'type': 'string'}, 'agent_id': {'type': ['string', 'null']}, 'input_hash': {'type': 'string'}, 'output_hash': {'type': ['string', 'null']}}, 'description': 'The signed, canonicalized record (gblin-canonical-json/1)'}, 'signature': {'type': 'string', 'description': "base64 Ed25519 over 'gblin-receipt/v1\\n' + canonical"}, 'tree_size': {'type': 'integer'}, 'checkpoint': {'type': 'string', 'description': 'C2SP signed note (origin, size, root)'}, 'provenance': {'type': 'object', 'required': ['level', 'levels'], 'properties': {'level': {'enum': ['self-reported', 'server-observed', 'externally-verified'], 'type': 'string'}, 'levels': {'type': 'array', 'items': {'type': 'string'}}, 'meaning': {'type': 'string'}, 'levels_meaning': {'type': 'object'}}, 'description': 'What the receipt does and does not prove'}, 'verifier_key': {'type': 'string', 'description': 'C2SP note verifier key: origin+hash+base64(0x01||pub)'}, 'inclusion_proof': {'type': 'array', 'items': {'type': 'string'}}, 'canonicalization': {'type': 'object', 'required': ['rule', 'spec'], 'properties': {'leaf': {'type': 'string'}, 'node': {'type': 'string'}, 'rule': {'type': 'string', 'const': 'gblin-canonical-json/1'}, 'spec': {'type': 'string'}, 'verifier': {'type': 'string'}, 'frozen_since': {'type': 'string'}, 'signed_message': {'type': 'string'}}, 'description': 'The serialisation rule these bytes were produced with, named in the receipt itself so a later verifier can recompute them without consulting our repository. Frozen as gblin-canonical-json/1.'}}}
receipts.seal
Append the HASHES of an AI action to GBLIN's public RFC 6962 transparency log and return a portable receipt: Ed25519 signature, inclusion proof, operator-signed C2SP checkpoint, plus the latest on-chain anchor (EAS on Base, daily). mode=demo (the only mode over MCP): 5 seals/day/IP, receipts marked demo:true. Unlimited seals are a paid x402 HTTP endpoint (resource gblin://howto/seal). Provenance is self-reported: the receipt proves existence and time of the record, not that the action happened. The action/agent_id/tool/meta strings are PUBLISHED in the log: identifiers only, never secrets. Fields not listed here are ignored and NOT recorded.
Accès externe
Schéma d’entrée
{'type': 'object', 'required': ['action', 'input_hash'], 'properties': {'meta': {'type': 'string', 'maxLength': 512, 'description': 'Extra JSON object as a string (optional). PUBLISHED.'}, 'mode': {'enum': ['demo'], 'type': 'string', 'default': 'demo', 'description': "Only 'demo' is available over MCP (5/day/IP). Paid seals go through x402 HTTP."}, 'tool': {'type': 'string', 'maxLength': 128, 'description': 'Tool/model used (optional). PUBLISHED.'}, 'action': {'type': 'string', 'maxLength': 128, 'minLength': 1, 'description': 'What the AI did, short label. PUBLISHED in the log.'}, 'agent_id': {'type': 'string', 'maxLength': 128, 'description': 'Your agent identifier (optional). PUBLISHED.'}, 'input_hash': {'type': 'string', 'pattern': '^\\s*(0x)?[0-9a-fA-F]{64}\\s*$', 'description': 'sha256 of the input/prompt, 64 hex chars (0x prefix optional)'}, 'output_hash': {'type': 'string', 'pattern': '^\\s*((0x)?[0-9a-fA-F]{64})?\\s*$', 'description': 'sha256 of the output, 64 hex chars (optional; empty or blank = omitted)'}}, 'additionalProperties': True}
Schéma de sortie
{'type': 'object', 'required': ['format', 'payload', 'leaf', 'index', 'tree_size', 'root', 'signature', 'verifier_key', 'inclusion_proof', 'checkpoint', 'anchor', 'provenance'], 'properties': {'leaf': {'type': 'string', 'description': 'base64 SHA256(0x00 || canonical)'}, 'root': {'type': 'string', 'description': 'base64 Merkle root at tree_size'}, 'index': {'type': 'integer'}, 'anchor': {'type': 'object', 'required': ['root_covers_this_receipt', 'anchored_tree_size', 'what_is_anchored'], 'properties': {'chain': {'type': 'string'}, 'method': {'type': 'string'}, 'explorer': {'type': 'string'}, 'promise_id': {'type': 'string'}, 'last_anchor': {'type': ['object', 'null'], 'properties': {'tx': {'type': 'string'}, 'day': {'type': 'string'}, 'root': {'type': 'string'}, 'tree_size': {'type': 'integer'}}}, 'eas_schema_uid': {'type': 'string'}, 'what_is_anchored': {'type': 'string'}, 'anchored_tree_size': {'type': ['integer', 'null']}, 'covers_this_receipt': {'type': 'boolean', 'description': 'deprecated alias of root_covers_this_receipt'}, 'root_covers_this_receipt': {'type': 'boolean', 'description': 'true iff index < anchored_tree_size: the anchored ROOT commits to this leaf via the inclusion proof'}}, 'description': 'Latest daily EAS anchor of the tree root on Base and whether it already covers this receipt'}, 'format': {'type': 'string', 'const': 'gblin-receipt/v1'}, 'payload': {'type': 'object', 'required': ['v', 'log', 'index', 'ts', 'action', 'input_hash'], 'properties': {'v': {'type': 'integer'}, 'by': {'enum': ['operator'], 'type': 'string', 'description': 'Present only when this server sealed its own action; set server-side, cannot be supplied by a caller'}, 'ts': {'type': 'string'}, 'log': {'type': 'string'}, 'demo': {'type': 'boolean'}, 'meta': {}, 'tool': {'type': ['string', 'null']}, 'index': {'type': 'integer'}, 'action': {'type': 'string'}, 'agent_id': {'type': ['string', 'null']}, 'input_hash': {'type': 'string'}, 'output_hash': {'type': ['string', 'null']}}, 'description': 'The signed, canonicalized record (gblin-canonical-json/1)'}, 'signature': {'type': 'string', 'description': "base64 Ed25519 over 'gblin-receipt/v1\\n' + canonical"}, 'tree_size': {'type': 'integer'}, 'checkpoint': {'type': 'string', 'description': 'C2SP signed note (origin, size, root)'}, 'provenance': {'type': 'object', 'required': ['level', 'levels'], 'properties': {'level': {'enum': ['self-reported', 'server-observed', 'externally-verified'], 'type': 'string'}, 'levels': {'type': 'array', 'items': {'type': 'string'}}, 'meaning': {'type': 'string'}, 'levels_meaning': {'type': 'object'}}, 'description': 'What the receipt does and does not prove'}, 'verifier_key': {'type': 'string', 'description': 'C2SP note verifier key: origin+hash+base64(0x01||pub)'}, 'inclusion_proof': {'type': 'array', 'items': {'type': 'string'}}, 'canonicalization': {'type': 'object', 'required': ['rule', 'spec'], 'properties': {'leaf': {'type': 'string'}, 'node': {'type': 'string'}, 'rule': {'type': 'string', 'const': 'gblin-canonical-json/1'}, 'spec': {'type': 'string'}, 'verifier': {'type': 'string'}, 'frozen_since': {'type': 'string'}, 'signed_message': {'type': 'string'}}, 'description': 'The serialisation rule these bytes were produced with, named in the receipt itself so a later verifier can recompute them without consulting our repository. Frozen as gblin-canonical-json/1.'}}}
receipts.verify
Verify a gblin-receipt/v1 JSON with pure math (no log lookup, no trust in this server): leaf hash, Ed25519 signature, RFC 6962 inclusion proof, C2SP checkpoint signature, verifier-key hash. Same checks as the zero-dependency verify-receipt.mjs you can run offline. For the extra on-chain-anchor consistency check use GET /v1/verify/:index.
Lecture seule
Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['receipt'], 'properties': {'receipt': {'type': 'object', 'description': 'The receipt JSON as returned by receipts.seal / receipts.get / GET /v1/receipt/:i (bare or wrapped in {receipt})'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['valid', 'checks', 'errors'], 'properties': {'index': {'type': 'integer'}, 'valid': {'type': 'boolean'}, 'checks': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'ok'], 'properties': {'ok': {'type': 'boolean'}, 'name': {'type': 'string'}, 'detail': {'type': 'string'}}}}, 'errors': {'type': 'array', 'items': {'type': 'string'}}, 'format': {'type': 'string'}, 'reminder': {'type': 'string'}, 'tree_size': {'type': 'integer'}}}
risk.attestation_sample
Static, permanently expired sample of the signed Risk Attestation (sample:true), same fields and EIP-712 schema as the paid one. Use it to build and test a parser/verifier.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['sample', 'attestation', 'attestation_id', 'signed'], 'properties': {'meta': {'type': 'object'}, 'eip712': {'type': 'object', 'description': 'EIP-712 domain/types/message to recompute the digest'}, 'sample': {'type': 'boolean', 'description': 'Always true — never a live signal'}, 'signed': {'type': 'boolean'}, 'verify': {'type': 'object'}, 'attestor': {'type': ['string', 'null']}, 'signature': {'type': ['string', 'null']}, 'attestation': {'type': 'object', 'description': 'Same field contract as the paid attestation (regime, shield_active, severity_pct, defensive_cash_pct, expires_at, ...)'}, 'attestation_id': {'type': 'string', 'description': 'hashTypedData digest — recompute to verify'}}}
risk.regime
Current BTC/ETH risk regime (calm | elevated | crash) with a suggested posture, read live from GBLIN's on-chain Crash Shield on Base (60s cache). Free and unsigned; a signed, verifiable-offline version is a paid x402 endpoint (resource gblin://howto/attestation).
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['regime', 'regime_code', 'severity_pct', 'defensive_cash_pct', 'shield_active', 'assets'], 'properties': {'note': {'type': 'string'}, 'assets': {'type': 'array', 'items': {'type': 'object', 'required': ['token', 'shielded', 'weight_cut_pct'], 'properties': {'token': {'type': 'string', 'description': 'ERC-20 address'}, 'shielded': {'type': 'boolean'}, 'weight_cut_pct': {'type': 'number'}, 'base_weight_pct': {'type': 'number'}, 'dynamic_weight_pct': {'type': 'number'}}}, 'description': 'Per-risk-asset shield state'}, 'regime': {'enum': ['calm', 'elevated', 'crash'], 'type': 'string', 'description': 'Current risk regime'}, 'source': {'type': 'string'}, 'chain_id': {'type': 'integer'}, 'contract': {'type': 'string', 'description': 'GBLIN contract on Base'}, 'regime_code': {'type': 'integer', 'description': '0 calm, 1 elevated, 2 crash'}, 'risk_posture': {'enum': ['risk_on', 'reduce', 'risk_off'], 'type': 'string', 'description': 'Suggested posture'}, 'severity_pct': {'type': 'number', 'description': 'Max crash-shield weight cut across risk assets, percent'}, 'shield_active': {'type': 'boolean', 'description': 'True when any risk asset is currently slashed'}, 'defensive_cash_pct': {'type': 'number', 'description': 'USDC dynamic weight in the basket, percent'}}}
treasury.health
Analyze an agent wallet's treasury health: GBLIN/USDC/ETH balances, whether the ETH covers an exit at the live gas price, the redemption cooldown, and (if daily_burn_usd is provided) days of USDC runway plus a recommendation that keeps seven days of spend in USDC and treats only the surplus as a candidate for GBLIN. Free by default; metered at $0.003 USDC only when the operator sets MCP_PAYWALL=true.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['wallet_address'], 'properties': {'_payment': {'type': 'string', 'description': 'Base64-encoded x402 PaymentProof JSON. Omit on first call to receive the 402 payment manifest.'}, 'daily_burn_usd': {'type': 'number', 'description': 'Optional. Average daily spend in USD (e.g. 1.5).'}, 'wallet_address': {'type': 'string', 'description': "Agent's 0x address."}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['wallet', 'balances', 'gas_health', 'cooldown', 'recommendation'], 'properties': {'ratios': {'type': 'object'}, 'wallet': {'type': 'string'}, 'balances': {'type': 'object'}, 'cooldown': {'type': 'object', 'description': 'Whether the redemption cooldown is active and for how long.'}, 'gas_health': {'type': 'object', 'description': 'Whether the wallet holds enough ETH for the next transactions.'}, 'recommendation': {'type': 'object', 'description': 'hold, rebalance_to_gblin or rebalance_to_usdc, with the reason.'}}, 'additionalProperties': True}
treasury.nav_history
NAV per GBLIN share over time, read from the chain at past blocks, beside the ETH/USD and BTC/USD oracle prices the vault itself uses, with the change of each over the window and the NAV's largest drawdown. History starts at the deployment of the vault in service. Use it to judge how the index behaved against holding ETH or BTC over the same span.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {'points': {'type': 'integer', 'maximum': 90, 'minimum': 2, 'description': 'How many points, newest last. Default 30.'}, 'interval': {'enum': ['hour', 'day'], 'type': 'string', 'description': 'Spacing of the points. Default day.'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['interval', 'points', 'series'], 'properties': {'note': {'type': 'string'}, 'method': {'type': 'string'}, 'points': {'type': 'number'}, 'series': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Oldest first: time, block, NAV in ETH and USD, ETH/USD and BTC/USD.'}, 'summary': {'type': ['object', 'null'], 'description': "Change of NAV, ETH and BTC over the window, and the NAV's largest drawdown."}, 'interval': {'enum': ['hour', 'day'], 'type': 'string'}}, 'additionalProperties': True}
treasury.quote
Preview a buy (ETH→GBLIN) or sell (GBLIN→ETH) without executing. Returns expected output, safe minOut with dynamic slippage buffer (2.5% normal / 4% during Crash Shield), and fee breakdown. Read-only.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'required': ['direction', 'amount_in'], 'properties': {'amount_in': {'type': 'string', 'description': 'Positive decimal. ETH for buy, GBLIN for sell.'}, 'direction': {'enum': ['buy', 'sell'], 'type': 'string'}}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['direction', 'slippage_buffer_bps', 'next_step'], 'properties': {'fees': {'type': 'object'}, 'direction': {'enum': ['buy', 'sell'], 'type': 'string'}, 'next_step': {'type': 'string'}, 'amount_in_eth': {'type': 'string', 'description': 'Buy only.'}, 'cooldown_note': {'type': 'string'}, 'amount_in_gblin': {'type': 'string', 'description': 'Sell only.'}, 'slippage_reason': {'type': 'string'}, 'expected_eth_out': {'type': 'string', 'description': 'Sell only.'}, 'safe_min_eth_out': {'type': 'string', 'description': 'Sell only. Pass as minEthOut.'}, 'expected_gblin_out': {'type': 'string', 'description': 'Buy only.'}, 'safe_min_gblin_out': {'type': 'string', 'description': 'Buy only. Pass as minOut.'}, 'slippage_buffer_bps': {'type': 'number'}, 'will_revert_with_zero_tolerance': {'type': 'boolean'}}, 'additionalProperties': True}
treasury.state
Read the current GBLIN protocol state on Base mainnet: NAV in USD, basket composition with dynamic weights, and Crash Shield status. Use this BEFORE any swap to know the current price and risk regime.
Lecture seule
Accès externe
Idempotent
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'type': 'object', 'required': ['nav_usd', 'eth_price_usd', 'nav_reliable', 'management_fee_bps_per_year', 'auction_open', 'crash_shield_active', 'basket'], 'properties': {'meta': {'type': 'object'}, 'basket': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Assets in the basket with base and dynamic weights.'}, 'nav_usd': {'type': 'number', 'description': 'Net asset value of one GBLIN share in USD.'}, 'auction_open': {'type': 'boolean', 'description': 'True while a rebalancing auction is running.'}, 'nav_reliable': {'type': 'boolean', 'description': 'False when a price feed is stale or a basket asset cannot be read; do not trade on the NAV then.'}, 'eth_price_usd': {'type': 'number', 'description': 'ETH price in USD from the oracle.'}, 'slippage_reason': {'type': 'string'}, 'crash_shield_active': {'type': 'boolean', 'description': 'True when the crash shield has cut the weight of a falling asset.'}, 'slippage_buffer_pct': {'type': 'number'}, 'management_fee_bps_per_year': {'type': 'number', 'description': 'Management fee in basis points per year, read from the contract.'}}, 'additionalProperties': True}
Historique
Modifications récentes des outils
Ajouté
attestation.verify
25 September 2026 02:51
Ajouté
payments.relay
25 September 2026 02:51
Ajouté
payments.verify
25 September 2026 02:51
Ajouté
payments.prepare
25 September 2026 02:51
Ajouté
auction.state
25 September 2026 02:51
Ajouté
governance.state
25 September 2026 02:51
Ajouté
actions.status
25 September 2026 02:51
Ajouté
actions.preview
25 September 2026 02:51
Ajouté
actions.prepare
25 September 2026 02:51
Ajouté
treasury.nav_history
25 September 2026 02:51
Ajouté
treasury.health
25 September 2026 02:51
Ajouté
treasury.quote
25 September 2026 02:51
Ajouté
treasury.state
25 September 2026 02:51
Ajouté
coherence.report
17 September 2026 12:41
Ajouté
receipts.verify
17 September 2026 12:41
Ajouté
receipts.get
17 September 2026 12:41
Ajouté
receipts.seal
17 September 2026 12:41
Ajouté
protocol.info
17 September 2026 12:41
Ajouté
protocol.stats
17 September 2026 12:41
Ajouté
risk.attestation_sample
17 September 2026 12:41
Ajouté
risk.regime
17 September 2026 12:41
Découvrir
Serveurs MCP similaires
The Stall
ai.intuitek.the-stall/the-stall
Provides pay-per-call tools for YouTube keyword research and research on stocks, crypto, DeFi, options, and macroeconomic data.
Crank Protocol
ing.crank/crank
Provides non-custodial Solana and EVM tools for swaps, derivatives, lending, staking, tokenized equities, bridging, and strategy …
x402-services
ai.firmbrain/x402-services
Provides on-chain, trading, and AI tools for Robinhood Chain.
FortFi Treasury MCP
io.github.rebelArtists/fortfi-treasury-mcp
Provides policy-controlled crypto treasury operations across chains, including wallets, payments, token discovery, swaps, bridges…
DeltaSignal ATLAS-7
io.github.aitrailblazer/deltasignal-atlas-7
Analyzes SEC and XBRL data for crypto-related public companies, including fundamentals, issuer signals, peer comparisons, stress …
intel
io.chainhelix/intel
Provides multi-chain market intelligence, blockchain activity metrics, trading and portfolio planning, sanctions clearance, agent…
TradingCalc MCP: Options, Forex, Risk Stats, Prediction Markets, On-Chain & Crypto Futures
io.github.SKalinin909/tradingcalc
Performs deterministic calculations for crypto futures, funding, leverage, liquidation, position sizing, token swaps, on-chain ri…
Market Intelligence API
com.marketintelligenceapi.api/market-intelligence
Analyzes crypto and tokenized-asset markets using DEX flows, perpetual positioning, smart-money activity, token risk, market news…