Server definition
- Hash
- sha256:06a5b07e1c8c0d800cb265e375c0a26201e6a00d0e071e969a05b2007649daa0
- What it is
- What a remote MCP server returned when asked what it offers: 6 tools
The blob, as servednamed by its sha256
{
"instructions": "Trade HITZ, the token of HITZ Protocol on Stellar mainnet, through its own exchange, the Sovereign Vault: protocol-owned pools against XLM and USDC, with no oracle. Flow: get_vault for prices and fees; quote to price a trade (pass account to check balances, trustlines and the Event Horizon); build_swap for an unsigned transaction from the user's own account; the user signs it in their Stellar wallet, or opens the sign.web link, a skyhitz.io page that signs with their wallet and submits; submit_transaction with a signed XDR; get_transaction to follow it. This server never sees or needs a secret key. Never ask the user for a secret key or seed phrase. Amounts are decimal strings in token units (7 decimals). The fee is 1% per hop when calm and rises to 10% while the vault's XLM/USDC rate is dislocated. An account holding more HITZ than the Event Horizon (about 9,900 HITZ; see get_vault) becomes vaulted: it can only send HITZ back into the vault until it holds less. quote and build_swap warn before a trade does that; tell the user before building such a trade.",
"tools": [
{
"description": "Build an unsigned, simulated swap transaction for the user's own Stellar account, ready to sign. Returns the XDR, the expected and minimum amounts, the network fee, warnings, and sign links: sign.web opens a skyhitz.io page where the user signs with their own wallet and the swap is submitted; sign.sep7 is a SEP-7 link for wallets that support it. Nothing moves until the user signs. Show the user the amounts and warnings first.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"account": {
"description": "The user's account: it pays, signs and (unless to is set) receives.",
"pattern": "^G[A-Z2-7]{55}$",
"type": "string"
},
"amount": {
"description": "Exact amount of sell to trade.",
"pattern": "^\\d+(\\.\\d+)?$",
"type": "string"
},
"buy": {
"description": "HITZ, XLM, USDC (any case), or a token contract address (C…).",
"type": "string"
},
"sell": {
"description": "HITZ, XLM, USDC (any case), or a token contract address (C…).",
"type": "string"
},
"slippage_bps": {
"default": 100,
"description": "How far below the quote the output may land, in basis points (100 = 1%).",
"maximum": 1000,
"minimum": 0,
"type": "integer"
},
"to": {
"description": "Optional recipient (G… or C…) instead of account.",
"type": "string"
},
"valid_for": {
"default": 300,
"description": "Seconds the transaction stays valid.",
"maximum": 3600,
"minimum": 30,
"type": "integer"
}
},
"required": [
"account",
"sell",
"buy",
"amount"
],
"type": "object"
},
"name": "build_swap",
"outputSchema": null
},
{
"description": "A Stellar account's XLM, USDC and HITZ balances, its trustlines, whether it is vaulted, and how much HITZ it can buy before being vaulted.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"address": {
"description": "Stellar account address (G…).",
"pattern": "^G[A-Z2-7]{55}$",
"type": "string"
}
},
"required": [
"address"
],
"type": "object"
},
"name": "get_account",
"outputSchema": null
},
{
"description": "Status of a transaction by hash, with a vault swap decoded (what was sold and bought).",
"inputSchema": {
"additionalProperties": false,
"properties": {
"hash": {
"description": "Transaction hash.",
"pattern": "^[0-9a-fA-F]{64}$",
"type": "string"
}
},
"required": [
"hash"
],
"type": "object"
},
"name": "get_transaction",
"outputSchema": null
},
{
"description": "Live state of the HITZ Sovereign Vault: each pool's reserves, HITZ price, current fee and dislocation, USD values, and the HITZ Event Horizon (the most HITZ an account can hold and still send it anywhere).",
"inputSchema": {
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_vault",
"outputSchema": null
},
{
"description": "Exact quote from the contract's own math: the amount out, price, fees per hop and price impact. Give amount (what is sold) or buy_amount (what should come out; the quote finds the input). Pass account to check its balances, trustlines and whether the trade would push it over the Event Horizon.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"account": {
"description": "Optional: the account that would trade.",
"pattern": "^G[A-Z2-7]{55}$",
"type": "string"
},
"amount": {
"description": "Amount of sell to trade, e.g. \"100\".",
"pattern": "^\\d+(\\.\\d+)?$",
"type": "string"
},
"buy": {
"description": "HITZ, XLM, USDC (any case), or a token contract address (C…).",
"type": "string"
},
"buy_amount": {
"description": "Instead of amount: how much of buy to receive.",
"pattern": "^\\d+(\\.\\d+)?$",
"type": "string"
},
"sell": {
"description": "HITZ, XLM, USDC (any case), or a token contract address (C…).",
"type": "string"
}
},
"required": [
"sell",
"buy"
],
"type": "object"
},
"name": "quote",
"outputSchema": null
},
{
"description": "Submit a signed vault transaction (from build_swap, signed by the user) to Stellar mainnet and wait for the result: status, hash, explorer link and the amount bought. Only relays calls to the vault.",
"inputSchema": {
"additionalProperties": false,
"properties": {
"xdr": {
"description": "The signed transaction envelope, base64.",
"type": "string"
}
},
"required": [
"xdr"
],
"type": "object"
},
"name": "submit_transaction",
"outputSchema": null
}
]
}Verify it yourself
curl -s https://api.teppi.xyz/v1/evidence/sha256:06a5b07e1c8c0d800cb265e375c0a26201e6a00d0e071e969a05b2007649daa0 | sha256sum